WEB00013 - ASPUpload
1. Einführung
ASP Upload ist eine COM+-Komponente, die es einer ASP-Applikation erlaubt, Dateien per Webbrowser zu speichern, zu verarbeiten und hochzuladen. Die Dateien werden per HTML POST-Formular mit dem <INPUT TYPE=FILE>-Tag zum Upload ausgewählt.
Mit ASP Upload können Sie Ihrer Web-Applikation mit nur zwei ASP-Skriptzeilen den Dateiupload ermöglichen. Doch neben bloßem Upload von Dateien ermöglicht Ihnen ASPupload zusätzlich eine große Bandbreite an Verwaltungsfeatures, einschließlich sicheren Downloads, Dateispeicherung in Datenbanken, Zugriffsberechtigungen und Dateiattributsverwaltung, Dateiverschlüsselung uvm.
Liste der unterstützten Features:
- kompatibel zu IIS4, IIS5, IIS6 (Windows NT/2000/XP/2003) & PWS
- mehrere Dateien gleichzeitig uploaden
- Zugriff auf Textobjekte im Formular
- HTML-basierter Fortschrittsbalken
- Unterstützung für Unicode
- Uploads in den Arbeitsspeicher
- Sichere Dateidownloads
- Access Control Lists (ACLs) von hochgeladenen Dateien veränderbar
- Dateiattribute veränderbar
- Dateien in Datenbanken speicherbar
- automatische Generierung einzigartiger Dateinamen, um versehentliches Überschreiben zu vermeiden
- Option, die maximale Größe hochladbarer Dateien festzulegen
- Option, den Eintrag unter 'Zuletzt verändert' zu behalten
- Unterstützung von Verschlüsselungstechnologien
- Verzeichnisliste sortierbar
- ActiveX-DLLs werden automatisch registriert
- bestimmte Features können per Registry deaktiviert werden
- Dateien können kopiert, verschoben und gelöscht werden
- Verzeichnisse können erstellt und gelöscht werden
- Umfassende ADO-Unterstützung
- MacBinary-Support
- Hochladen ganzer Verzeichnisse (in Verbindung mit XUpload oder JUpload)
- Einweg-Hashfunktion für hochgeladene Dateien
2. Einfaches Upload-Formular
Ein einfaches Upload-Formular:
Das folgende HTML-Formular ermöglicht es einem Benutzer, maximal drei Dateien auszuwählen und auf den Server hochzuladen.
<HTML>
<BODY BGCOLOR="#FFFFFF">
<FORM METHOD="POST" ENCTYPE="multipart/form-data" ACTION="UploadScript1.asp">
<INPUT TYPE="FILE" SIZE="40" NAME="FILE1"><BR>
<INPUT TYPE="FILE" SIZE="40" NAME="FILE2"><BR>
<INPUT TYPE="FILE" SIZE="40" NAME="FILE3"><BR>
<INPUT TYPE=SUBMIT VALUE="Upload!">
</FORM>
</BODY>
</HTML>
Beachten Sie bitte das Attribut ENCTYPE="multipart/form-data" im <FORM>-Tag - es veranlasst den Browser, die gesamte Datei auf den Server hochzuladen, nicht nur den Dateinamen, der im Eingabefeld angegeben wurde. Es ist absolut notwendig, dass Ihr Upload-Formular dieses Attribut enthält, ansonsten sind keine Uploads möglich.
In diesem Formular befinden sich drei Zeilen <INPUT TYPE="FILE">, die auf der Website als Textboxen mit einem 'Durchsuchen'-Button erscheinen. Jede Box erlaubt die Auswahl einer einzigen Datei. Während das Attribut SIZE eines <INPUT TYPE="FILE"> optional ist, ist das NAME-Attribut notwendig.
Das oben dargestellte Formular ruft das Nachfolgeskript UploadScript1.asp auf.
<HTML>
<BODY>
<%
Set Upload = Server.CreateObject("Persits.Upload")
Count = Upload.Save("c:\upload")
Response.Write Count & " file(s) uploaded to c:\upload"
%>
</BODY>
</HTML>
Die erste Zeile des ASP-Skripts erstellt eine Instanz des ASPUpload-Objekts. Die zweite Zeile ruft die Save-Funktion der Komponente auf - diese Komponente führt den eigentlichen Upload durch: sie durchsucht die Information, die per POST vom Browser gesendet wird und speichert sie in einem vorher spezifizierten Verzeichnis auf dem Server.
Die Save-Methode zeigt auch die Anzahl der erfolgreich hochgeladenen Dateien an. Im Falle eines Fehlers wird ein Ausnahmefehler generiert.
Für eine weitergehende Anleitung und noch mehr Beispiele besuchen Sie bitte die offizielle Homepage des Herstellers von ASPupload, aspupload.com.