本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

FileUpload 類別

 

顯示允許使用者選取要上載至伺服器之檔案的文字方塊控制項和瀏覽按鈕。

命名空間:   System.Web.UI.WebControls
組件:  System.Web (於 System.Web.dll)

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.FileUpload

[ControlValuePropertyAttribute("FileBytes")]
[ValidationPropertyAttribute("FileName")]
public class FileUpload : WebControl

名稱描述
System_CAPS_pubmethodFileUpload()

初始化 FileUpload 類別的新執行個體。

名稱描述
System_CAPS_pubpropertyAccessKey

取得或設定可讓您快速瀏覽到 Web 伺服器控制項的便捷鍵。(繼承自 WebControl。)

System_CAPS_protpropertyAdapter

取得控制項的瀏覽器特定配接器。(繼承自 Control。)

System_CAPS_pubpropertyAllowMultiple

取得或設定值,指定是否可以選取多個檔案上傳。

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

取得或設定應用程式的相對虛擬目錄的 PageUserControl 物件,其中包含此控制項。(繼承自 Control。)

System_CAPS_pubpropertyAttributes

取得集合的任意屬性 (僅呈現),不會對應至控制項的屬性。(繼承自 WebControl。)

System_CAPS_pubpropertyBackColor

取得或設定 Web 伺服器控制項的背景色彩。(繼承自 WebControl。)

System_CAPS_pubpropertyBindingContainer

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 取得包含此控制項的資料繫結的控制項。(繼承自 Control。)

System_CAPS_pubpropertyBorderColor

取得或設定 Web 控制項的框線色彩。(繼承自 WebControl。)

System_CAPS_pubpropertyBorderStyle

取得或設定 Web 伺服器控制項的框線樣式。(繼承自 WebControl。)

System_CAPS_pubpropertyBorderWidth

取得或設定 Web 伺服器控制項的框線寬度。(繼承自 WebControl。)

System_CAPS_protpropertyChildControlsCreated

取得值,指出是否已建立伺服器控制項的子控制項。(繼承自 Control。)

System_CAPS_pubpropertyClientID

取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。(繼承自 Control。)

System_CAPS_pubpropertyClientIDMode

取得或設定用來產生值的演算法 ClientID 屬性。(繼承自 Control。)

System_CAPS_protpropertyClientIDSeparator

取得字元值,表示使用的分隔符號字元 ClientID 屬性。(繼承自 Control。)

System_CAPS_protpropertyContext

取得 HttpContext 目前 Web 要求的伺服器控制項相關聯的物件。(繼承自 Control。)

System_CAPS_pubpropertyControls

取得 ControlCollection 物件,代表 UI 階層架構中指定的伺服器控制項的子控制項。(繼承自 Control。)

System_CAPS_pubpropertyControlStyle

取得 Web 伺服器控制項的樣式。 這個屬性主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_pubpropertyControlStyleCreated

取得值,指出是否 Style 物件已建立 ControlStyle 屬性。 這個屬性主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_pubpropertyCssClass

取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS) 類別。(繼承自 WebControl。)

System_CAPS_pubpropertyDataItemContainer

取得命名容器的參考,如果命名容器實作 IDataItemContainer(繼承自 Control。)

System_CAPS_pubpropertyDataKeysContainer

取得命名容器的參考,如果命名容器實作 IDataKeysControl(繼承自 Control。)

System_CAPS_protpropertyDesignMode

取得值,指出控制項是否正在使用設計介面上。(繼承自 Control。)

System_CAPS_pubpropertyEnabled

取得或設定值,指出是否啟用 Web 伺服器控制項。(繼承自 WebControl。)

System_CAPS_pubpropertyEnableTheming

取得或設定值,表示主題是否套用至這個控制項。(繼承自 WebControl。)

System_CAPS_pubpropertyEnableViewState

取得或設定值,該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態,以及它包含的任何子控制項狀態。(繼承自 Control。)

System_CAPS_protpropertyEvents

取得控制項的事件處理常式委派清單。 這個屬性是唯讀的。(繼承自 Control。)

System_CAPS_pubpropertyFileBytes

取得使用 FileUpload 控制項指定之檔案中的位元組陣列。

System_CAPS_pubpropertyFileContent

取得指向要使用 FileUpload 控制項上傳之檔案的 Stream 物件。

System_CAPS_pubpropertyFileName

取得用戶端上要使用 FileUpload 控制項上傳之檔案的名稱。

System_CAPS_pubpropertyFont

取得與 Web 伺服器控制項相關聯的字型屬性。(繼承自 WebControl。)

System_CAPS_pubpropertyForeColor

取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。(繼承自 WebControl。)

System_CAPS_pubpropertyHasAttributes

取得值,指出控制項是否有設定屬性。(繼承自 WebControl。)

System_CAPS_protpropertyHasChildViewState

取得值,指出目前的伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。(繼承自 Control。)

System_CAPS_pubpropertyHasFile

取得值,表示 FileUpload 控制項是否包含檔案。

System_CAPS_pubpropertyHasFiles

取得值,指出是否已上傳任何檔案。

System_CAPS_pubpropertyHeight

取得或設定 Web 伺服器控制項的高度。(繼承自 WebControl。)

System_CAPS_pubpropertyID

取得或設定指派給伺服器控制項的程式設計識別項。(繼承自 Control。)

System_CAPS_protpropertyIdSeparator

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 取得用來分隔控制識別項的字元。(繼承自 Control。)

System_CAPS_protpropertyIsChildControlStateCleared

取得值,指出這個控制項內所包含的控制項是否有控制項狀態。(繼承自 Control。)

System_CAPS_protpropertyIsEnabled

取得值,指出是否啟用控制項。(繼承自 WebControl。)

System_CAPS_protpropertyIsTrackingViewState

取得值,指出伺服器控制項是否正在將變更儲存至其檢視狀態。(繼承自 Control。)

System_CAPS_protpropertyIsViewStateEnabled

取得值,指出是否啟用這個控制項的檢視狀態。(繼承自 Control。)

System_CAPS_protpropertyLoadViewStateByID

取得值,指出控制項是否參與載入其檢視狀態,由 ID 而不是索引。(繼承自 Control。)

System_CAPS_pubpropertyNamingContainer

取得伺服器控制項的參考的命名容器,這會建立具有相同的伺服器控制項之間的區別的唯一命名空間 Control.ID 屬性值。(繼承自 Control。)

System_CAPS_pubpropertyPage

取得參考 Page 包含伺服器控制項的執行個體。(繼承自 Control。)

System_CAPS_pubpropertyParent

取得頁面控制項階層架構中的伺服器控制項的父控制項的參考。(繼承自 Control。)

System_CAPS_pubpropertyPostedFile

取得使用 FileUpload 控制項上傳之檔案的基礎 HttpPostedFile 物件。

System_CAPS_pubpropertyPostedFiles

取得已上傳的檔案的集合。

System_CAPS_pubpropertyRenderingCompatibility

取得值,指定用來呈現 HTML 的 ASP.NET 版本將會與相容。(繼承自 Control。)

System_CAPS_pubpropertySite

取得裝載的設計介面上呈現時的目前控制項的容器的相關資訊。(繼承自 Control。)

System_CAPS_pubpropertySkinID

取得或設定要套用至控制項的面板。(繼承自 WebControl。)

System_CAPS_pubpropertyStyle

取得文字屬性,將會轉譯為 Web 伺服器控制項的外部標記的樣式屬性的集合。(繼承自 WebControl。)

System_CAPS_pubpropertySupportsDisabledAttribute

取得值,這個值表示當控制項的 IsEnabled 屬性為 false 時,控制項是否應該將呈現之 HTML 項目的 disabled 屬性設為 "disabled"。(繼承自 WebControl。)

System_CAPS_pubpropertyTabIndex

取得或設定 Web 伺服器控制項的定位點索引。(繼承自 WebControl。)

System_CAPS_protpropertyTagKey

取得 HtmlTextWriterTag 對應至這個 Web 伺服器控制項的值。 這個屬性主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_protpropertyTagName

取得控制項的標記名稱。 這個屬性主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_pubpropertyTemplateControl

取得或設定樣板,含有這個控制項的參考。(繼承自 Control。)

System_CAPS_pubpropertyTemplateSourceDirectory

取得虛擬目錄的 PageUserControl ,其中包含目前的伺服器控制項。(繼承自 Control。)

System_CAPS_pubpropertyToolTip

取得或設定當滑鼠指標停留在 Web 伺服器控制項所顯示的文字。(繼承自 WebControl。)

System_CAPS_pubpropertyUniqueID

取得伺服器控制項的唯一且階層式限定識別碼。(繼承自 Control。)

System_CAPS_pubpropertyValidateRequestMode

取得或設定值,指出控制項是否會檢查用戶端輸入瀏覽器的潛在危險的值。(繼承自 Control。)

System_CAPS_protpropertyViewState

取得可讓您儲存及還原跨多個相同的頁面要求的伺服器控制項的檢視狀態的狀態資訊的字典。(繼承自 Control。)

System_CAPS_protpropertyViewStateIgnoresCase

取得值,指出是否StateBag物件不區分大小寫。(繼承自 Control。)

System_CAPS_pubpropertyViewStateMode

取得或設定此控制項的檢視狀態模式。(繼承自 Control。)

System_CAPS_pubpropertyVisible

取得或設定值,指出伺服器控制項是否會轉譯為頁面上的 UI。(繼承自 Control。)

System_CAPS_pubpropertyWidth

取得或設定 Web 伺服器控制項的寬度。(繼承自 WebControl。)

名稱描述
System_CAPS_protmethodAddAttributesToRender(HtmlTextWriter)

將要呈現之 FileUpload 控制項的 HTML 屬性和樣式加入至指定的 System.Web.UI.HtmlTextWriter 物件。(覆寫 WebControl.AddAttributesToRender(HtmlTextWriter)。)

System_CAPS_protmethodAddedControl(Control, Int32)

子控制項加入至後呼叫 Controls 集合 Control 物件。(繼承自 Control。)

System_CAPS_protmethodAddParsedSubObject(Object)

通知伺服器控制項,XML 或 HTML 項目已剖析,並將項目加入伺服器控制項的 ControlCollection 物件中。(繼承自 Control。)

System_CAPS_pubmethodApplyStyle(Style)

將指定任何的樣式非空白項目複製到 Web 控制項,並覆寫控制項的任何現有的樣式項目。 這個方法主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_pubmethodApplyStyleSheetSkin(Page)

套用至控制項的頁面樣式表中定義的樣式屬性。(繼承自 Control。)

System_CAPS_protmethodBeginRenderTracing(TextWriter, Object)

開始呈現資料的設計階段追蹤。(繼承自 Control。)

System_CAPS_protmethodBuildProfileTree(String, Boolean)

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 收集伺服器控制項的詳細資訊,並傳遞至 Trace 啟用網頁的追蹤時要顯示的屬性。(繼承自 Control。)

System_CAPS_protmethodClearCachedClientID()

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 設定快取 ClientIDnull(繼承自 Control。)

System_CAPS_protmethodClearChildControlState()

刪除伺服器控制項的子控制項的控制項狀態資訊。(繼承自 Control。)

System_CAPS_protmethodClearChildState()

刪除所有伺服器控制項的子控制項的檢視狀態和控制項狀態資訊。(繼承自 Control。)

System_CAPS_protmethodClearChildViewState()

刪除所有伺服器控制項的子控制項的檢視狀態資訊。(繼承自 Control。)

System_CAPS_protmethodClearEffectiveClientIDMode()

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 設定 ClientIDMode 屬性目前的控制項執行個體和任何子控制項的 Inherit(繼承自 Control。)

System_CAPS_pubmethodCopyBaseAttributes(WebControl)

複製屬性不是由封裝 Style 從指定的 Web 伺服器控制項的物件會呼叫這個方法,從 Web 伺服器控制項。 這個方法是主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_protmethodCreateChildControls()

由 ASP.NET 網頁架構呼叫,通知使用組合實作的伺服器控制項來建立所包含的任何子控制項,以準備回傳或呈現。(繼承自 Control。)

System_CAPS_protmethodCreateControlCollection()

建立新 ControlCollection 物件來保存伺服器控制項的子控制項 (常值和伺服器)。(繼承自 Control。)

System_CAPS_protmethodCreateControlStyle()

建立會在內部使用的樣式物件 WebControl 類別以實作所有的樣式相關屬性。 這個方法是主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_pubmethodDataBind()

將資料來源繫結至所叫用的伺服器控制項及其所有子控制項。(繼承自 Control。)

System_CAPS_protmethodDataBind(Boolean)

將資料來源繫結至叫用的伺服器控制項及其所有子控制項的選項,以引發 DataBinding 事件。(繼承自 Control。)

System_CAPS_protmethodDataBindChildren()

將資料來源繫結至伺服器控制項的子控制項。(繼承自 Control。)

System_CAPS_pubmethodDispose()

可讓伺服器控制項來從記憶體釋放之前執行最後清除。(繼承自 Control。)

System_CAPS_protmethodEndRenderTracing(TextWriter, Object)

結束呈現資料的設計階段追蹤。(繼承自 Control。)

System_CAPS_protmethodEnsureChildControls()

判斷伺服器控制項是否包含子控制項。 如果不存在,則建立子控制項。(繼承自 Control。)

System_CAPS_protmethodEnsureID()

建立控制項並沒有指派的識別項的識別項。(繼承自 Control。)

System_CAPS_pubmethodEquals(Object)

判斷指定的物件是否等於目前的物件。(繼承自 Object。)

System_CAPS_protmethodFinalize()

在記憶體回收開始前,允許物件嘗試釋放資源,並執行其他清除作業。(繼承自 Object。)

System_CAPS_pubmethodFindControl(String)

使用指定的伺服器控制項目前命名容器中搜尋 id 參數。(繼承自 Control。)

System_CAPS_protmethodFindControl(String, Int32)

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 使用指定的伺服器控制項目前命名容器中搜尋 id 和一個整數,指定在 pathOffset 參數,以協助在搜尋]。 您不應覆寫這一版的 FindControl 方法。(繼承自 Control。)

System_CAPS_pubmethodFocus()

設定輸入焦點的控制項。(繼承自 Control。)

System_CAPS_protmethodGetDesignModeState()

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 取得控制項的設計階段資料。(繼承自 Control。)

System_CAPS_pubmethodGetHashCode()

做為預設雜湊函式。(繼承自 Object。)

System_CAPS_pubmethodGetRouteUrl(Object)

取得對應至一組路由參數的 URL。(繼承自 Control。)

System_CAPS_pubmethodGetRouteUrl(RouteValueDictionary)

取得對應至一組路由參數的 URL。(繼承自 Control。)

System_CAPS_pubmethodGetRouteUrl(String, Object)

取得對應於一組的路由參數及路由名稱的 URL。(繼承自 Control。)

System_CAPS_pubmethodGetRouteUrl(String, RouteValueDictionary)

取得對應於一組的路由參數及路由名稱的 URL。(繼承自 Control。)

System_CAPS_pubmethodGetType()

取得目前執行個體的 Type(繼承自 Object。)

System_CAPS_pubmethodGetUniqueIDRelativeTo(Control)

傳回的前置的部分 UniqueID 指定控制項的屬性。(繼承自 Control。)

System_CAPS_pubmethodHasControls()

判斷伺服器控制項是否包含任何子控制項。(繼承自 Control。)

System_CAPS_protmethodHasEvents()

傳回值,指出事件是否已註冊的控制項或任何子控制項。(繼承自 Control。)

System_CAPS_protmethodIsLiteralContent()

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 決定是否伺服器控制項將會含有常值的內容。(繼承自 Control。)

System_CAPS_protmethodLoadControlState(Object)

還原控制項狀態資訊時,由儲存上一個頁面要求從 SaveControlState 方法。(繼承自 Control。)

System_CAPS_protmethodLoadViewState(Object)

從使用 SaveViewState 方法所儲存的先前要求來還原檢視狀態資訊。(繼承自 WebControl。)

System_CAPS_protmethodMapPathSecure(String)

擷取絕對或相對虛擬路徑對應至實體路徑。(繼承自 Control。)

System_CAPS_protmethodMemberwiseClone()

建立目前 Object 的淺層複製。(繼承自 Object。)

System_CAPS_pubmethodMergeStyle(Style)

任何非空白的項目,指定 web 樣式的控制項,但是不會覆寫任何現有的樣式項目控制項的複本。 這個方法是主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_protmethodOnBubbleEvent(Object, EventArgs)

決定伺服器控制項的事件是否要在頁面的 UI 伺服器控制項階層架構中向上傳遞。(繼承自 Control。)

System_CAPS_protmethodOnDataBinding(EventArgs)

引發 DataBinding 事件。(繼承自 Control。)

System_CAPS_protmethodOnInit(EventArgs)

引發 Init 事件。(繼承自 Control。)

System_CAPS_protmethodOnLoad(EventArgs)

引發 Load 事件。(繼承自 Control。)

System_CAPS_protmethodOnPreRender(EventArgs)

引發 FileUpload 控制項的 PreRender 事件。(覆寫 Control.OnPreRender(EventArgs)。)

System_CAPS_protmethodOnUnload(EventArgs)

引發 Unload 事件。(繼承自 Control。)

System_CAPS_protmethodOpenFile(String)

取得 Stream 用來讀取檔案。(繼承自 Control。)

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

將任何來源的事件和其資訊指派給控制項的父代。(繼承自 Control。)

System_CAPS_protmethodRemovedControl(Control)

移除子控制項之後,會呼叫 Controls 集合 Control 物件。(繼承自 Control。)

System_CAPS_protmethodRender(HtmlTextWriter)

傳送 FileUpload 控制項內容到指定的 System.Web.UI.HtmlTextWriter 物件,這樣會寫入內容,以呈現到用戶端。(覆寫 WebControl.Render(HtmlTextWriter)。)

System_CAPS_pubmethodRenderBeginTag(HtmlTextWriter)

開啟指定的寫入器控制項標記的 HTML 呈現。 這個方法是主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_protmethodRenderChildren(HtmlTextWriter)

伺服器控制項的子系至提供的內容輸出 HtmlTextWriter 要呈現的內容寫入用戶端的物件。(繼承自 Control。)

System_CAPS_protmethodRenderContents(HtmlTextWriter)

將指定的寫入器呈現控制項的內容。 這個方法是主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_pubmethodRenderControl(HtmlTextWriter)

輸出至提供的伺服器控制項內容 HtmlTextWriter 物件,並儲存關於控制項的追蹤資訊,如果已啟用追蹤。(繼承自 Control。)

System_CAPS_protmethodRenderControl(HtmlTextWriter, ControlAdapter)

輸出至提供的伺服器控制項內容 HtmlTextWriter 物件提供使用 ControlAdapter 物件。(繼承自 Control。)

System_CAPS_pubmethodRenderEndTag(HtmlTextWriter)

呈現的 HTML 結尾標記的控制項到指定的寫入器。 這個方法是主要由控制項開發人員使用。(繼承自 WebControl。)

System_CAPS_protmethodResolveAdapter()

取得控制項配接器負責呈現指定的控制項。(繼承自 Control。)

System_CAPS_pubmethodResolveClientUrl(String)

取得可供瀏覽器的 URL。(繼承自 Control。)

System_CAPS_pubmethodResolveUrl(String)

將 URL 轉換成一個要求的用戶端上使用。(繼承自 Control。)

System_CAPS_pubmethodSaveAs(String)

將上載之檔案的內容儲存至 Web 伺服器上指定的路徑。

System_CAPS_protmethodSaveControlState()

儲存頁面回傳至伺服器以來,所發生的任何伺服器控制項狀態變更。(繼承自 Control。)

System_CAPS_protmethodSaveViewState()

儲存已修改後的任何狀態 TrackViewState 叫用方法。(繼承自 WebControl。)

System_CAPS_protmethodSetDesignModeState(IDictionary)

設定控制項的設計階段資料。(繼承自 Control。)

System_CAPS_pubmethodSetRenderMethodDelegate(RenderMethod)

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 指派至其父控制項呈現伺服器控制項和其內容的事件處理常式委派。(繼承自 Control。)

System_CAPS_pubmethodSetTraceData(Object, Object)

設定追蹤的設計階段呈現資料的追蹤、 使用的追蹤資料索引鍵和追蹤資料值的資料。(繼承自 Control。)

System_CAPS_pubmethodSetTraceData(Object, Object, Object)

設定追蹤的設計階段呈現資料的追蹤,請使用追蹤的物件、 追蹤資料索引鍵,以及追蹤資料值的資料。(繼承自 Control。)

System_CAPS_pubmethodToString()

傳回代表目前物件的字串。(繼承自 Object。)

System_CAPS_protmethodTrackViewState()

使控制項追蹤其檢視狀態的變更,以便它們可以儲存在物件的 ViewState 屬性。(繼承自 WebControl。)

名稱描述
System_CAPS_pubeventDataBinding

發生於伺服器控制項繫結至資料來源。(繼承自 Control。)

System_CAPS_pubeventDisposed

發生於伺服器控制項從記憶體釋放,這是在伺服器控制項生命週期的最後階段,ASP.NET 網頁要求時。(繼承自 Control。)

System_CAPS_pubeventInit

發生於初始化伺服器控制項,是在其生命週期中的第一個步驟。(繼承自 Control。)

System_CAPS_pubeventLoad

發生於伺服器控制項載入到 Page 物件。(繼承自 Control。)

System_CAPS_pubeventPreRender

發生於之後 Control 物件是載入,但先前轉譯。(繼承自 Control。)

System_CAPS_pubeventUnload

發生於伺服器控制項時從記憶體卸載。(繼承自 Control。)

名稱描述
System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.GetAttribute(String)

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 取得具有指定名稱的 Web 控制項的屬性。(繼承自 WebControl。)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIAttributeAccessor.SetAttribute(String, String)

將 Web 控制項的屬性設定為指定的名稱和值。(繼承自 WebControl。)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.GetDesignModeState()

如需這個成員的說明,請參閱 IControlDesignerAccessor.GetDesignModeState(繼承自 Control。)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetDesignModeState(IDictionary)

如需這個成員的說明,請參閱 IControlDesignerAccessor.SetDesignModeState(繼承自 Control。)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIControlDesignerAccessor.SetOwnerControl(Control)

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 如需這個成員的說明,請參閱 IControlDesignerAccessor.SetOwnerControl(繼承自 Control。)

System_CAPS_pubinterfaceSystem_CAPS_privmethodIParserAccessor.AddParsedSubObject(Object)

如需這個成員的說明,請參閱 IParserAccessor.AddParsedSubObject(繼承自 Control。)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlBuilderAccessor.ControlBuilder

如需這個成員的說明,請參閱 IControlBuilderAccessor.ControlBuilder(繼承自 Control。)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIControlDesignerAccessor.UserData

如需這個成員的說明,請參閱 IControlDesignerAccessor.UserData(繼承自 Control。)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.DataBindings

如需這個成員的說明,請參閱 IDataBindingsAccessor.DataBindings(繼承自 Control。)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIDataBindingsAccessor.HasDataBindings

如需這個成員的說明,請參閱 IDataBindingsAccessor.HasDataBindings(繼承自 Control。)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.Expressions

如需這個成員的說明,請參閱 IExpressionsAccessor.Expressions(繼承自 Control。)

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIExpressionsAccessor.HasExpressions

如需這個成員的說明,請參閱 IExpressionsAccessor.HasExpressions(繼承自 Control。)

名稱描述
System_CAPS_pubmethodFindDataSourceControl()

傳回與指定之控制項的資料控制項相關聯的資料來源。(由 DynamicDataExtensions 定義。)

System_CAPS_pubmethodFindFieldTemplate(String)

傳回指定之控制項的指定資料行的欄位樣板的命名容器。(由 DynamicDataExtensions 定義。)

System_CAPS_pubmethodFindMetaTable()

傳回包含資料控制項 metatable 物件。(由 DynamicDataExtensions 定義。)

FileUpload類別會顯示文字方塊控制項和瀏覽 按鈕可讓使用者選取用戶端上的檔案,並將它上傳至 Web 伺服器。 使用者指定要輸入本機電腦上的檔案的完整路徑來上傳的檔案 (例如, C:\MyFiles\TestFile.txt) 在文字方塊中的控制項。 或者,使用者可以選取檔案,即可瀏覽按鈕,然後再尋找在選擇檔案 對話方塊。

使用FileName屬性來取得用戶端使用上傳的檔案名稱FileUpload控制項。 這個屬性會傳回檔案名稱不包含在用戶端上檔案的路徑。

FileContent屬性會取得Stream指向要上傳檔案的物件。 使用這個屬性來存取檔案的內容,做為位元組。 例如,您可以使用Stream所傳回的物件FileContent讀取檔案的內容,做為位元組,並將它們儲存在位元組陣列中的屬性。 或者,您可以使用FileBytes屬性,以擷取檔案中的所有位元組。

PostedFile屬性會取得基礎HttpPostedFile要上傳之檔案的物件。 您可以使用這個屬性來存取該檔案上的其他屬性。 ContentLength屬性會取得檔案長度。 ContentType屬性會取得檔案的 MIME 內容類型。 此外,您可以使用PostedFile屬性來存取FileName屬性,InputStream屬性,而SaveAs方法。 不過,相同的功能由提供FileName屬性,FileContent屬性,而SaveAs方法。

FileUpload控制項不會自動儲存檔案到伺服器之後,使用者選取要上傳檔案。 您也必須明確地提供控制項或機制,讓使用者送出指定的檔案。 例如,您可以提供使用者按一下 上傳檔案的按鈕。 將指定的檔案儲存您撰寫的程式碼應該呼叫SaveAs方法,在伺服器,將檔案的內容儲存至指定的路徑。 一般而言,SaveAs引發回傳至伺服器的事件的事件處理方法中呼叫方法。 比方說,如果您提供的按鈕送出檔案時,您可以包含要儲存檔案,按一下事件的事件處理方法內的程式碼。

然後再呼叫SaveAs方法,以將檔案儲存至伺服器,使用HasFile屬性可讓您確認FileUpload控制項包含的檔案。 如果HasFile傳回true,呼叫SaveAs方法。 如果它傳回false,顯示一則訊息給使用者,表示控制項不包含檔案。 不會檢查PostedFile屬性來判斷是否要上傳的檔案存在,因為根據預設,這個屬性包含 0 個位元組。 如此一來,即使FileUpload控制項是空白的PostedFile屬性會傳回非 null 值。

當您呼叫SaveAs方法,您必須指定要儲存上載的檔案目錄的完整路徑。 如果您未在應用程式程式碼中明確指定路徑,使用者嘗試上傳的檔案時,會擲回例外狀況。 這個行為有助於保護檔案伺服器上的安全,防止使用者從寫入至任意位置,在您的應用程式目錄結構中,以及防止敏感根目錄存取。

SaveAs方法會將上傳的檔案寫入指定的目錄。 因此,ASP.NET 應用程式必須在伺服器上有目錄的寫入權限。 有兩種方式,應用程式可以取得寫入權限。 您可以明確授與寫入存取權的應用程式執行上, 傳的檔案會儲存在目錄中的帳戶。 或者,您可以增加的被授與 ASP.NET 應用程式的信任層級。 若要取得應用程式的執行目錄的寫入權限,必須授與應用程式AspNetHostingPermission信任層級設定為物件AspNetHostingPermissionLevel.Medium值。 增加的信任層級會增加伺服器上的資源的應用程式的存取。 請注意這不是安全的作法,因為惡意使用者取得您的應用程式的控制項,也可以在這個較高的信任層級下執行。 它是具有所需的應用程式執行的最小權限的使用者內容中執行 ASP.NET 應用程式的最佳作法。 如需在 ASP.NET 應用程式安全性的詳細資訊,請參閱Basic Security Practices for Web ApplicationsASP.NET Trust Levels and Policy Files

一種方式來保護對抗阻絕服務攻擊是可以使用上傳的檔案大小限制FileUpload控制項。 您應該設定適用於您要上傳的檔案類型的大小限制。 預設大小限制為 4096 kb 4 百萬位元組 (MB)。 您可以允許更大的檔案上傳設定maxRequestLength項目的屬性。 若要增加允許的最大檔案大小為整個應用程式,設定maxRequestLength在 Web.config 檔案中的屬性。 若要增加允許的檔案大小上限指定的頁面,設定maxRequestLength屬性內locationWeb.config 中的項目。 如需範例,請參閱位置元素 (ASP.NET 設定結構描述)

當上傳大型檔案時,使用者可能也會收到下列錯誤訊息︰

aspnet_wp.exe (PID: 1520) was recycled because memory consumption exceeded 460 MB (60 percent of available RAM).

如果您的使用者會遇到這個錯誤訊息,增加的值memoryLimit屬性中的項目 Web.config 檔,以取得應用程式。 memoryLimit屬性指定的背景工作處理序可以使用的記憶體數量上限。 如果工作者處理序超過memoryLimit數量,來取代它,建立新的處理序,以及所有目前的要求重新指派至新的處理序。

若要控制是否要上傳檔案會暫時儲存在記憶體中或在伺服器上處理要求時,設定requestLengthDiskThreshold項目的屬性。 這個屬性可讓您管理輸入資料流緩衝區的大小。 預設為 256 個位元組。 您指定的值不應該超過您指定的值maxRequestLength屬性。

FileUpload控制項用來在局部網頁呈現期間使用回傳的案例中,而不是在非同步回傳的案例。 當您使用FileUpload內控制UpdatePanel控制項,必須使用的控制項上傳檔案PostBackTrigger面板的物件。 UpdatePanel控制項用來更新選取的區域,而不是整個頁面更新與回傳的頁面。 如需詳細資訊,請參閱 UpdatePanel Control OverviewPartial-Page Rendering Overview

<asp:FileUpload
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
/>

本主題隨附了含有原始程式碼的 Visual Studio Web 站台專案︰ Download

本節包含下列四個範例︰

  • 第一個範例示範如何建立FileUpload控制將檔案儲存至程式碼中指定的路徑。

  • 第二個範例示範如何建立FileUpload檔案系統中的應用程式會將檔案儲存至指定的目錄的控制項。

  • 第三個範例示範如何建立FileUpload控制項,將檔案儲存至指定的路徑,並限制可以上傳之檔案的大小。

  • 第四個範例示範如何建立FileUpload控制項將檔案儲存至指定的路徑,讓只有擁有.doc 或.xls 檔案名稱的擴充功能要上傳的檔案。

System_CAPS_caution注意

這些範例所示的基本語法FileUpload控制項,但它們不會示範所有必要錯誤檢查,應該要儲存檔案之前完成。 如需更完整的範例,請參閱 SaveAs

下列範例示範如何建立FileUpload控制將檔案儲存至程式碼中指定的路徑。 SaveAs呼叫方法,將檔案儲存在伺服器上指定的路徑。

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 

<script runat="server">

  protected void UploadButton_Click(object sender, EventArgs e)
  {
    // Specify the path on the server to
    // save the uploaded file to.
    String savePath = @"c:\temp\uploads\";

    // Before attempting to perform operations
    // on the file, verify that the FileUpload 
    // control contains a file.
    if (FileUpload1.HasFile)
    {
      // Get the name of the file to upload.
      String fileName = FileUpload1.FileName;

      // Append the name of the file to upload to the path.
      savePath += fileName;


      // Call the SaveAs method to save the 
      // uploaded file to the specified path.
      // This example does not perform all
      // the necessary error checking.               
      // If a file with the same name
      // already exists in the specified path,  
      // the uploaded file overwrites it.
      FileUpload1.SaveAs(savePath);

      // Notify the user of the name of the file
      // was saved under.
      UploadStatusLabel.Text = "Your file was saved as " + fileName;
    }
    else
    {      
      // Notify the user that a file was not uploaded.
      UploadStatusLabel.Text = "You did not specify a file to upload.";
    }

  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>FileUpload Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       <h4>Select a file to upload:</h4>

       <asp:FileUpload id="FileUpload1"                 
           runat="server">
       </asp:FileUpload>

       <br /><br />

       <asp:Button id="UploadButton" 
           Text="Upload file"
           OnClick="UploadButton_Click"
           runat="server">
       </asp:Button>    

       <hr />

       <asp:Label id="UploadStatusLabel"
           runat="server">
       </asp:Label>        
    </div>
    </form>
</body>
</html>

下列範例示範如何建立FileUpload檔案系統中的應用程式會將檔案儲存至指定的目錄的控制項。 HttpRequest.PhysicalApplicationPath屬性用來取得目前執行的伺服器應用程式根目錄的實體檔案系統路徑。 SaveAs呼叫方法,將檔案儲存在伺服器上指定的路徑。

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void UploadButton_Click(object sender, EventArgs e)
    {
        // Save the uploaded file to an "Uploads" directory
        // that already exists in the file system of the 
        // currently executing ASP.NET application.  
        // Creating an "Uploads" directory isolates uploaded 
        // files in a separate directory. This helps prevent
        // users from overwriting existing application files by
        // uploading files with names like "Web.config".
        string saveDir = @"\Uploads\";

        // Get the physical file system path for the currently
        // executing application.
        string appPath = Request.PhysicalApplicationPath;

        // Before attempting to save the file, verify
        // that the FileUpload control contains a file.
        if (FileUpload1.HasFile)
        {
            string savePath = appPath + saveDir +
                Server.HtmlEncode(FileUpload1.FileName);

            // Call the SaveAs method to save the 
            // uploaded file to the specified path.
            // This example does not perform all
            // the necessary error checking.               
            // If a file with the same name
            // already exists in the specified path,  
            // the uploaded file overwrites it.
            FileUpload1.SaveAs(savePath);

            // Notify the user that the file was uploaded successfully.
            UploadStatusLabel.Text = "Your file was uploaded successfully.";

        }
        else
        {
            // Notify the user that a file was not uploaded.
            UploadStatusLabel.Text = "You did not specify a file to upload.";   
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>FileUpload Class Example</title>
</head>
<body>
    <h3>FileUpload Class Example: Save To Application Directory</h3>
    <form id="form1" runat="server">
    <div>
       <h4>Select a file to upload:</h4>

       <asp:FileUpload id="FileUpload1"                 
           runat="server">
       </asp:FileUpload>

       <br/><br/>

       <asp:Button id="UploadButton" 
           Text="Upload file"
           OnClick="UploadButton_Click"
           runat="server">
       </asp:Button>    

       <hr />

       <asp:Label id="UploadStatusLabel"
           runat="server">
       </asp:Label>           
    </div>
    </form>
</body>
</html>

下列範例示範如何建立FileUpload控制將檔案儲存至程式碼中指定的路徑。 控制項可以上傳為 5 MB 的檔案大小的限制。 PostedFile屬性用來存取基礎ContentLength屬性和傳回檔案的大小。 如果要上傳檔案大小不超過 2 MB,SaveAs呼叫方法,將檔案儲存在伺服器上指定的路徑。 除了檢查應用程式程式碼中設定的最大檔案大小,您可以設定maxRequestLength屬性要在您的應用程式的組態檔中的最大容許大小的項目。

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void UploadButton_Click(object sender, EventArgs e)
    {
        // Specify the path on the server to
        // save the uploaded file to.
        string savePath = @"c:\temp\uploads\";

        // Before attempting to save the file, verify
        // that the FileUpload control contains a file.
        if (FileUpload1.HasFile)
        {                
            // Get the size in bytes of the file to upload.
            int fileSize = FileUpload1.PostedFile.ContentLength;

            // Allow only files less than 2,100,000 bytes (approximately 2 MB) to be uploaded.
            if (fileSize < 2100000)
            {

                // Append the name of the uploaded file to the path.
                savePath += Server.HtmlEncode(FileUpload1.FileName);

                // Call the SaveAs method to save the 
                // uploaded file to the specified path.
                // This example does not perform all
                // the necessary error checking.               
                // If a file with the same name
                // already exists in the specified path,  
                // the uploaded file overwrites it.
                FileUpload1.SaveAs(savePath);

                // Notify the user that the file was uploaded successfully.
                UploadStatusLabel.Text = "Your file was uploaded successfully.";
            }
            else
            {
                // Notify the user why their file was not uploaded.
                UploadStatusLabel.Text = "Your file was not uploaded because " + 
                                         "it exceeds the 2 MB size limit.";
            }
        }   
        else
        {
            // Notify the user that a file was not uploaded.
            UploadStatusLabel.Text = "You did not specify a file to upload.";
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>FileUpload Class Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
       <h4>Select a file to upload:</h4>

       <asp:FileUpload id="FileUpload1"                 
           runat="server">
       </asp:FileUpload>

       <br/><br/>

       <asp:Button id="UploadButton" 
           Text="Upload file"
           OnClick="UploadButton_Click"
           runat="server">
       </asp:Button>

       <hr />

       <asp:Label id="UploadStatusLabel"
           runat="server">
       </asp:Label>

    </div>
    </form>
</body>
</html>

下列範例示範如何建立FileUpload控制將檔案儲存至程式碼中指定的路徑。 這個範例可讓您僅擁有.doc 或.xls 檔案名稱的擴充功能要上傳的檔案。 Path.GetExtension方法呼叫以傳回要上傳檔案的副檔名。 如果檔案有.doc 或.xls 檔案的副檔名,SaveAs呼叫方法,將檔案儲存在伺服器上指定的路徑。

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void UploadBtn_Click(object sender, EventArgs e)
    {
        // Specify the path on the server to
        // save the uploaded file to.
        string savePath = @"c:\temp\uploads";

        // Before attempting to save the file, verify
        // that the FileUpload control contains a file.
        if (FileUpload1.HasFile)
        {
            // Get the name of the file to upload.
            string fileName = Server.HtmlEncode(FileUpload1.FileName);

            // Get the extension of the uploaded file.
            string extension = System.IO.Path.GetExtension(fileName);

            // Allow only files with .doc or .xls extensions
            // to be uploaded.
            if ((extension == ".doc") || (extension == ".xls"))
            {
                // Append the name of the file to upload to the path.
                savePath += fileName;

                // Call the SaveAs method to save the 
                // uploaded file to the specified path.
                // This example does not perform all
                // the necessary error checking.               
                // If a file with the same name
                // already exists in the specified path,  
                // the uploaded file overwrites it.
                FileUpload1.SaveAs(savePath);

                // Notify the user that their file was successfully uploaded.
                UploadStatusLabel.Text = "Your file was uploaded successfully.";
            }
            else
            {
                // Notify the user why their file was not uploaded.
                UploadStatusLabel.Text = "Your file was not uploaded because " + 
                                         "it does not have a .doc or .xls extension.";
            }

        }

    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>FileUpload Class Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <h4>Select a file to upload:</h4>

        <asp:FileUpload id="FileUpload1"                 
            runat="server">
        </asp:FileUpload>

        <br/><br/>

        <asp:Button id="UploadBtn" 
            Text="Upload file"
            OnClick="UploadBtn_Click"
            runat="server">
        </asp:Button>    

        <hr />

        <asp:Label id="UploadStatusLabel"
            runat="server">
        </asp:Label>     
    </div>
    </form>
</body>
</html>

.NET Framework
自 2.0 起供應

此類型的任何 public static (在 Visual Basic 中 共用 在 Visual Basic 中) 成員皆為安全執行緒。不保證任何執行個體成員為安全執行緒。

回到頁首
顯示: