HttpPostedFile 類別

定義

命名空間:

System.Web

組件:

System.Web.dll

提供用戶端上載的個別檔案的存取。

public ref class HttpPostedFile sealed

public sealed class HttpPostedFile

type HttpPostedFile = class

Public NotInheritable Class HttpPostedFile

繼承

Object

HttpPostedFile

備註

類別 HttpFileCollection 可讓您存取從用戶端上傳為檔案集合的所有檔案。 類別 HttpPostedFile 提供屬性和方法來取得個別檔案的相關信息，以及讀取和儲存盤案。

控件 HtmlInputFile 可用來從客戶端選取和上傳檔案。

檔案會以MIME多部分/表單數據格式上傳。 根據預設，所有要求包括窗體字段和上傳的檔案，大於 256 KB 會緩衝處理到磁碟，而不是保留在伺服器記憶體中。

您可以藉由存取 MaxRequestLength 屬性或設定 HTTPRuntime 元素的 屬性， (ASP.NET 在 Machine.config 或 Web.config 檔案內設定 maxRequestLengthHTTPRuntime 元素) 元素，來指定允許的要求大小上限。 預設值是 4 MB。

要求在伺服器記憶體中緩衝的數據量，包括檔案上傳，可以藉由存取 RequestLengthDiskThreshold 屬性，或藉由在 Machine.config 或 Web.config 檔案內設定 requestLengthDiskThresholdHTTPRuntime 元素 的 屬性， (ASP.NET Settings Schema) 元素來指定。

藉由調整 MaxRequestLength 和 RequestLengthDiskThreshold 屬性，您可以微調伺服器的效能。 此外，您應該考慮設定 MaxRequestLength ，以防止使用者將大型檔案張貼到伺服器所造成的拒絕服務攻擊。

配置給緩衝上傳檔案的伺服器資源會在要求結束時終結。 若要儲存檔案的持久性復本，請使用 SaveAs 方法。

屬性

ContentLength	取得上傳的檔案大小 (以位元組為單位)。
ContentType	取得用戶端所送出檔案的 MIME 內容類型。
FileName	取得用戶端上檔案的完整名稱。
InputStream	取得 Stream 物件，該物件指向所上傳的檔案，以準備讀取該檔案的內容。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
SaveAs(String)	儲存已上傳的檔案內容。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• HtmlInputFile
• HttpFileCollection