HttpPostedFile Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt den Zugriff auf einzelne Dateien bereit, die von einem Client hochgeladen wurden.
public ref class HttpPostedFile sealedpublic sealed class HttpPostedFiletype HttpPostedFile = classPublic NotInheritable Class HttpPostedFile- Vererbung
-
HttpPostedFile
Hinweise
Die HttpFileCollection -Klasse bietet Zugriff auf alle Dateien, die von einem Client als Dateisammlung hochgeladen werden. Die HttpPostedFile -Klasse stellt Eigenschaften und Methoden bereit, um Informationen zu einer einzelnen Datei abzurufen und die Datei zu lesen und zu speichern.
Das HtmlInputFile Steuerelement kann verwendet werden, um Dateien von einem Client auszuwählen und hochzuladen.
Dateien werden im MIME-Mehrteil-/Formulardatenformat hochgeladen. Standardmäßig werden alle Anforderungen, einschließlich Formularfeldern und hochgeladenen Dateien, größer als 256 KB, auf den Datenträger gepuffert und nicht im Serverspeicher gespeichert.
Sie können die maximal zulässige Anforderungsgröße angeben, indem Sie auf die MaxRequestLength -Eigenschaft zugreifen oder das maxRequestLength Attribut des httpRuntime-Elements (ASP.NET Settings Schema) in der Machine.config- oder Web.config-Datei festlegen. Die Standardeinstellung ist 4 MB.
Die Datenmenge, die im Serverspeicher für eine Anforderung gepuffert wird, einschließlich Dateiuploads, kann durch Zugriff auf die RequestLengthDiskThreshold -Eigenschaft oder durch Festlegen des requestLengthDiskThreshold Attributs des httpRuntime-Elements (ASP.NET Settings Schema) innerhalb der Machine.config- oder Web.config-Datei angegeben werden.
Durch Anpassen der MaxRequestLength Eigenschaften und RequestLengthDiskThreshold können Sie die Leistung Ihres Servers optimieren. Darüber hinaus sollten Sie das MaxRequestLength festlegen, um Denial-of-Service-Angriffe zu verhindern, die durch Benutzer verursacht werden, die große Dateien auf dem Server veröffentlichen.
Serverressourcen, die zum Puffern der hochgeladenen Datei zugewiesen sind, werden zerstört, wenn die Anforderung endet. Verwenden Sie die SaveAs -Methode, um eine dauerhafte Kopie der Datei zu speichern.
Eigenschaften
| ContentLength |
Ruft die Größe einer hochgeladenen Datei in Bytes ab. |
| ContentType |
Ruft den MIME-Inhaltstyp einer von einem Client gesendeten Datei ab. |
| FileName |
Ruft den vollqualifizierten Namen der Datei auf dem Client ab. |
| InputStream |
Ruft ein Stream-Objekt ab, das auf eine hochgeladene Datei verweist, die für das Lesen des Dateiinhalts vorbereitet werden soll. |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| SaveAs(String) |
Speichert den Inhalt einer hochgeladenen Datei. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
