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 屬性或設定 maxRequestLength Machine.config 或 Web.config 檔案內的HTTPRuntime 元素 (ASP.NET 設定 Schema) 元素的 屬性，來指定允許的要求大小上限。 預設值是 4 MB。

要求在伺服器記憶體中緩衝處理的資料量，包括檔案上傳，可以藉由存取 RequestLengthDiskThreshold 屬性或藉由在 Machine.config 或 Web.config 檔案中設定 requestLengthDiskThreshold HTTPRuntime 元素 (ASP.NET 設定 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