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 sealed
public sealed class HttpPostedFile
type HttpPostedFile = class
Public 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 bietet Eigenschaften und Methoden zum Abrufen von Informationen zu einer einzelnen Datei und zum Lesen und Speichern der Datei.
Das HtmlInputFile Steuerelement kann verwendet werden, um Dateien aus einem Client auszuwählen und hochzuladen.
Dateien werden im MIME-Format multipart/form-data hochgeladen. Standardmäßig werden alle Anforderungen, einschließlich Formularfelder und hochgeladener Dateien, größer als 256 KB auf Datenträger gepuffert und nicht im Serverspeicher gespeichert.
Sie können die maximale zulässige Anforderungsgröße angeben, indem Sie auf die Eigenschaft zugreifen MaxRequestLength oder das maxRequestLength
Attribut des httpRuntime-Elements (ASP.NET Einstellungen Schema) innerhalb der Machine.config- oder Web.config-Datei festlegen. Die Standardeinstellung ist 4 MB.
Die Menge der Daten, die im Serverspeicher für eine Anforderung gepuffert werden, die Dateiuploads enthält, kann durch Zugriff auf die RequestLengthDiskThreshold Eigenschaft oder durch Festlegen des requestLengthDiskThreshold
Attributs des httpRuntime-Elements (ASP.NET Einstellungen Schema) innerhalb der Machine.config oder Web.config Datei angegeben werden.
Indem Sie die MaxRequestLength RequestLengthDiskThreshold Eigenschaften anpassen, können Sie die Leistung Ihres Servers optimieren. Darüber hinaus sollten Sie die Einstellung festlegen, um den Verweigerungs-of-Service-Angriffen zu verhindern, die MaxRequestLength durch Benutzer verursacht werden, die große Dateien auf den Server posten.
Serverressourcen, die der Pufferung der hochgeladenen Datei zugewiesen sind, werden zerstört, wenn die Anforderung endet. Um eine dauerhafte Kopie der Datei zu speichern, verwenden Sie die SaveAs Methode.
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) |