HttpPostedFile Klasse

Definition

Stellt den Zugriff auf einzelne Dateien bereit, die von einem Client hochgeladen wurden.Provides access to individual files that have been uploaded by a client.

public ref class HttpPostedFile sealed
public sealed class HttpPostedFile
type HttpPostedFile = class
Public NotInheritable Class HttpPostedFile
Vererbung
HttpPostedFile

Hinweise

Die HttpFileCollection-Klasse ermöglicht den Zugriff auf alle Dateien, die von einem Client als Datei Sammlung hochgeladen werden.The HttpFileCollection class provides access to all the files that are uploaded from a client as a file collection. Die HttpPostedFile-Klasse stellt Eigenschaften und Methoden bereit, um Informationen zu einer einzelnen Datei zu erhalten und die Datei zu lesen und zu speichern.The HttpPostedFile class provides properties and methods to get information about an individual file and to read and save the file.

Das HtmlInputFile Steuerelement kann zum auswählen und Hochladen von Dateien von einem Client verwendet werden.The HtmlInputFile control can be used to select and upload files from a client.

Dateien werden im MIME-Multipart/Form-Data-Format hochgeladen.Files are uploaded in MIME multipart/form-data format. Standardmäßig werden alle Anforderungen, einschließlich Formularfelder und hochgeladene Dateien, die größer als 256 KB sind, auf dem Datenträger gepuffert und nicht im Server Speicher gespeichert.By default, all requests, including form fields and uploaded files, larger than 256 KB are buffered to disk, rather than held in server memory.

Sie können die maximal zulässige Anforderungs Größe angeben, indem Sie auf die MaxRequestLength-Eigenschaft zugreifen oder das maxRequestLength-Attribut des httpRuntime-Elements (ASP.NET Settings Schema) -Elements in der Datei "Machine. config" oder "Web. config" festlegen.You can specify the maximum allowable request size by accessing the MaxRequestLength property or by setting the maxRequestLength attribute of the httpRuntime Element (ASP.NET Settings Schema) element within the Machine.config or Web.config file. Die Standardeinstellung ist 4 MB.The default is 4 MB.

Die Datenmenge, die im Server Arbeitsspeicher für eine Anforderung gepuffert wird, einschließlich Datei Uploads, kann durch den Zugriff auf die RequestLengthDiskThreshold-Eigenschaft oder durch Festlegen des requestLengthDiskThreshold-Attributs des httpRuntime-Elements (ASP.NET Settings Schema) -Elements in der Datei Machine. config oder Web. config angegeben werden.The amount of data that is buffered in server memory for a request, which includes file uploads, can be specified by accessing the RequestLengthDiskThreshold property or by setting the requestLengthDiskThreshold attribute of the httpRuntime Element (ASP.NET Settings Schema) element within the Machine.config or Web.config file.

Durch die Anpassung der Eigenschaften MaxRequestLength und RequestLengthDiskThreshold können Sie die Leistung des Servers optimieren.By adjusting the MaxRequestLength and RequestLengthDiskThreshold properties, you can fine tune the performance of your server. Außerdem sollten Sie die MaxRequestLength festlegen, um Denial-of-Service-Angriffe zu verhindern, die von Benutzern verursacht werden, die große Dateien auf dem Server bereitstellen.Additionally, you should consider setting the MaxRequestLength to prevent denial of service attacks caused by users posting large files to the server.

Server Ressourcen, die zum Puffern der hochgeladenen Datei zugeordnet sind, werden gelöscht, wenn die Anforderung beendet wird.Server resources that are allocated to buffer the uploaded file will be destroyed when the request ends. Verwenden Sie die SaveAs-Methode, um eine dauerhafte Kopie der Datei zu speichern.To save a durable copy of the file, use the SaveAs method.

Eigenschaften

ContentLength

Ruft die Größe einer hochgeladenen Datei in Bytes ab.Gets the size of an uploaded file, in bytes.

ContentType

Ruft den MIME-Inhaltstyp einer von einem Client gesendeten Datei ab.Gets the MIME content type of a file sent by a client.

FileName

Ruft den vollqualifizierten Namen der Datei auf dem Client ab.Gets the fully qualified name of the file on the client.

InputStream

Ruft ein Stream-Objekt ab, das auf eine hochgeladene Datei verweist, die für das Lesen des Dateiinhalts vorbereitet werden soll.Gets a Stream object that points to an uploaded file to prepare for reading the contents of the file.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
SaveAs(String)

Speichert den Inhalt einer hochgeladenen Datei.Saves the contents of an uploaded file.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch