HttpPostedFile Třída

Definice

Obor názvů:

System.Web

Sestavení:

System.Web.dll

Poskytuje přístup k jednotlivým souborům, které klient nahrál.

public ref class HttpPostedFile sealed

public sealed class HttpPostedFile

type HttpPostedFile = class

Public NotInheritable Class HttpPostedFile

Dědičnost

Object

HttpPostedFile

Poznámky

Třída HttpFileCollection poskytuje přístup ke všem souborům, které jsou nahrané z klienta jako kolekce souborů. Třída HttpPostedFile poskytuje vlastnosti a metody pro získání informací o jednotlivých souborech a ke čtení a uložení souboru.

Ovládací HtmlInputFile prvek lze použít k výběru a nahrání souborů z klienta.

Soubory se nahrají ve vícedílovém formátu MIME nebo ve formátu form-data. Ve výchozím nastavení se všechny požadavky, včetně polí formulářů a nahraných souborů, větší než 256 kB ukládají do vyrovnávací paměti na disk, místo aby se uchovály v paměti serveru.

Maximální povolenou velikost požadavku můžete zadat přístupem k MaxRequestLength vlastnosti nebo nastavením maxRequestLength atributu elementu httpRuntime (ASP.NET Settings Schema) v rámci Machine.config nebo Web.config souboru. Výchozí hodnota je 4 MB.

Množství dat, která jsou uložena do vyrovnávací paměti serveru pro požadavek, který zahrnuje nahrávání souborů, lze určit přístupem k RequestLengthDiskThreshold vlastnosti nebo nastavením requestLengthDiskThreshold atributu elementu httpRuntime (ASP.NET Settings Schema) v rámci Machine.config nebo Web.config souboru.

Úpravou MaxRequestLength a RequestLengthDiskThreshold vlastností můžete vyladit výkon serveru. Dále byste měli zvážit nastavení MaxRequestLength tak, aby se zabránilo útokům na dostupnost služby způsobeným uživateli, kteří na server publikují velké soubory.

Prostředky serveru, které jsou přiděleny k uložení nahraného souboru do vyrovnávací paměti, budou po skončení požadavku zničeny. Chcete-li uložit odolnou kopii souboru, použijte metodu SaveAs .

Vlastnosti

Name	Description
ContentLength	Získá velikost nahraného souboru v bajtech.
ContentType	Získá typ obsahu MIME souboru odeslaného klientem.
FileName	Získá plně kvalifikovaný název souboru v klientovi.
InputStream	Stream Získá objekt, který odkazuje na nahraný soubor připravit na čtení obsahu souboru.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
SaveAs(String)	Uloží obsah nahraného souboru.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• HtmlInputFile
• HttpFileCollection