HttpPostedFile Klasse

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

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 sealed

public sealed class HttpPostedFile

type HttpPostedFile = class

Public NotInheritable Class HttpPostedFile

Vererbung: Object
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)

Gilt für:

Freigeben über