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

TextBox 類別

 

顯示使用者輸入的文字方塊控制項。

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

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

[ControlValuePropertyAttribute("Text")]
[ValidationPropertyAttribute("Text")]
public class TextBox : WebControl, IPostBackDataHandler, IEditableTextControl, 
	ITextControl

名稱描述
System_CAPS_pubmethodTextBox()

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

名稱描述
System_CAPS_pubpropertyAccessKey

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

System_CAPS_protpropertyAdapter

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

System_CAPS_pubpropertyAppRelativeTemplateSourceDirectory

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

System_CAPS_pubpropertyAttributes

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

System_CAPS_pubpropertyAutoCompleteType

取得或設定值,指出的 AutoComplete 行為 TextBox 控制項

System_CAPS_pubpropertyAutoPostBack

取得或設定值,指出是否自動向伺服器回傳時 TextBox 控制項失去焦點。

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_pubpropertyCausesValidation

取得或設定值,指出是否執行驗證時 TextBox 控制項設為驗證回傳發生時。

System_CAPS_protpropertyChildControlsCreated

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

System_CAPS_pubpropertyClientID

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

System_CAPS_pubpropertyClientIDMode

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

System_CAPS_protpropertyClientIDSeparator

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

System_CAPS_pubpropertyColumns

取得或設定文字方塊中的顯示寬度,以字元為單位。

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_pubpropertyFont

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

System_CAPS_pubpropertyForeColor

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

System_CAPS_pubpropertyHasAttributes

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

System_CAPS_protpropertyHasChildViewState

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

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_pubpropertyMaxLength

取得或設定文字方塊中所允許的字元數上限。

System_CAPS_pubpropertyNamingContainer

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

System_CAPS_pubpropertyPage

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

System_CAPS_pubpropertyParent

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

System_CAPS_pubpropertyReadOnly

取得或設定值,指出是否內容 TextBox 可以變更控制項。

System_CAPS_pubpropertyRenderingCompatibility

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

System_CAPS_pubpropertyRows

取得或設定多行文字方塊中所顯示的列數。

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

取得文字方塊控制項的 HTML 標記。 這個屬性受到保護。(覆寫 WebControl.TagKey。)

System_CAPS_protpropertyTagName

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

System_CAPS_pubpropertyTemplateControl

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

System_CAPS_pubpropertyTemplateSourceDirectory

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

System_CAPS_pubpropertyText

取得或設定文字內容的 TextBox 控制項。

System_CAPS_pubpropertyTextMode

取得或設定 (例如單行、 多行或密碼) 的行為模式的 TextBox 控制項。

System_CAPS_pubpropertyToolTip

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

System_CAPS_pubpropertyUniqueID

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

System_CAPS_pubpropertyValidateRequestMode

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

System_CAPS_pubpropertyValidationGroup

取得或設定控制項群組的 TextBox 控制項回傳至伺服器時,會驗證。

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_pubpropertyWrap

取得或設定值,指出多行文字方塊中的文字內容是否換行。

名稱描述
System_CAPS_protmethodAddAttributesToRender(HtmlTextWriter)

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 將需要呈現的 HTML 屬性和樣式加入至指定 HtmlTextWriter 執行個體。(覆寫 WebControl.AddAttributesToRender(HtmlTextWriter)。)

System_CAPS_protmethodAddedControl(Control, Int32)

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

System_CAPS_protmethodAddParsedSubObject(Object)

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 覆寫,以允許只有常值控制項加入做為 Text 屬性。(覆寫 Control.AddParsedSubObject(Object)。)

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_protmethodLoadPostData(String, NameValueCollection)

處理回傳資料 TextBox 控制項。

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)

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 如果註冊用戶端指令碼產生的用戶端上呈現以前,先回傳事件的 AutoPostBacktrue(覆寫 Control.OnPreRender(EventArgs)。)

System_CAPS_protmethodOnTextChanged(EventArgs)

引發 TextChanged 事件。 這允許您直接處理事件。

System_CAPS_protmethodOnUnload(EventArgs)

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

System_CAPS_protmethodOpenFile(String)

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

System_CAPS_protmethodRaiseBubbleEvent(Object, EventArgs)

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

System_CAPS_protmethodRaisePostDataChangedEvent()

叫用 OnTextChanged 方法時的張貼的資料 TextBox 控制項已變更。

System_CAPS_protmethodRemovedControl(Control)

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

System_CAPS_protmethodRender(HtmlTextWriter)

呈現 TextBox 控制項來指定 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_protmethodSaveControlState()

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

System_CAPS_protmethodSaveViewState()

儲存自頁面回傳至伺服器以來文字方塊檢視狀態的變更。(覆寫 WebControl.SaveViewState()。)

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_pubeventTextChanged

發生於文字方塊的內容在發佈至伺服器期間變更時。

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_privmethodIPostBackDataHandler.LoadPostData(String, NameValueCollection)

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 如果與最後張貼不同,請載入張貼的文字方塊內容。

System_CAPS_pubinterfaceSystem_CAPS_privmethodIPostBackDataHandler.RaisePostDataChangedEvent()

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 叫用 OnTextChanged 方法文字方塊的張貼的資料變更時。

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 定義。)

本主題內容:

TextBox 伺服器控制項是讓使用者輸入的文字輸入的控制項。 根據預設, TextMode 控制項的屬性設定為 TextBoxMode.SingleLine, ,其中顯示單行文字方塊。 不過,您也可以使用 TextBox 控制項來顯示多行文字方塊或遮罩的值變更的使用者輸入的文字方塊 TextMode 屬性 TextBoxMode.MultiLineTextBoxMode.Password, 分別。 在顯示的文字 TextBox 控制項是指定或決定使用 Text 屬性。

TextBox 控制項包含數個屬性,可讓您控制控制項的外觀。 以字元為單位,指定文字方塊的顯示寬度由其 Columns 屬性。 如果 TextBox 控制項是多行文字方塊中,它會顯示的資料列數目由 Rows 屬性。 若要顯示中換行的文字 TextBox 控制項,將設定 Wrap 屬性 true

您也可以指定在輸入資料的方式 TextBox 控制項設定一些屬性。 若要防止不受修改控制項中顯示的文字,設定 ReadOnly 屬性 true 如果您想要限制使用者輸入,以指定的字元數,設定 MaxLength 屬性。

如需執行個體的初始屬性值的清單 TextBox, ,請參閱 TextBox 建構函式。

System_CAPS_caution注意

此控制項可以用來接受使用者輸入,其中可能包含惡意用戶端指令碼。 請檢查從用戶端可執行指令碼、 SQL 陳述式,或其他程式碼傳送之前先在您的應用程式中顯示任何資訊。 您可以使用驗證控制項來顯示在控制項中輸入的文字之前驗證使用者輸入。 ASP.NET 提供使用者輸入來封鎖指令碼和 HTML 的輸入的要求驗證功能。 如需詳細資訊,請參閱 Securing Standard Controls, ,How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, ,和 Validating User Input in ASP.NET Web Pages

<asp:TextBox
    AccessKey="string"
    AutoCompleteType="None|Disabled|Cellular|Company|Department|
        DisplayName|Email|FirstName|Gender|HomeCity|HomeCountryRegion|
        HomeFax|HomePhone|HomeState|HomeStreetAddress|HomeZipCode|
        Homepage|JobTitle|LastName|MiddleName|Notes|Office|Pager|
        BusinessCity|BusinessCountryRegion|BusinessFax|BusinessPhone|
        BusinessState|BusinessStreetAddress|BusinessUrl|
        BusinessZipCode|Search"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    Columns="integer"
    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"
    MaxLength="integer"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    ReadOnly="True|False"
    Rows="integer"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    TextMode="SingleLine|MultiLine|Password"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
    Wrap="True|False"
/>

Visual Studio Web 網站專案與原始程式碼有幫助您完成本主題︰ Download

下列程式碼範例示範如何使用 TextBox 來取得使用者輸入的控制項。 當使用者按一下 新增 顯示] 按鈕,在文字方塊中輸入值的總和。

System_CAPS_security 安全性 注意

這個範例有一個可接受使用者輸入的文字方塊,這可能會造成安全性威脅。 根據預設,ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊,請參閱Script Exploits Overview

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

<!DOCTYPE html>
<html> 

<head>
    <title>TextBox Example</title>
    <script runat="server">
      protected void AddButton_Click(Object sender, EventArgs e)
      {
         int Answer;
         Answer = Convert.ToInt32(Value1.Text) + Convert.ToInt32(Value2.Text);
         AnswerMessage.Text = Answer.ToString();
      }
    </script>
</head>
<body>
  <form id="form1" runat="server">
    <h3> TextBox Example </h3>
    <p>
        <asp:TextBox ID="Value1" Columns="2" MaxLength="3" Text="1" runat="server"/>
        +
        <asp:TextBox ID="Value2" Columns="2" MaxLength="3" Text="1" runat="server"/>
        =
        <asp:Label ID="AnswerMessage" runat="server"/>
    </p>
    <p>
        <asp:Button ID="AddButton" Text="Add" OnClick="AddButton_Click" runat="server"/>
    </p>
    <p>
        <asp:RequiredFieldValidator ID="Value1RequiredValidator" ControlToValidate="Value1"
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"
             runat="server"/>
        <asp:RequiredFieldValidator ID="Value2RequiredValidator" ControlToValidate="Value2"
             ErrorMessage="Please enter a value.<br />" Display="Dynamic"
             runat="server"/>
        <asp:RangeValidator ID="Value1RangeValidator" ControlToValidate="Value1"
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
             runat="server"/>
        <asp:RangeValidator ID="Value2RangeValidator" ControlToValidate="Value2"
             Type="Integer" MinimumValue="1" MaximumValue="100" Display="Dynamic"
             ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"    
             runat="server"/>
    </p>
  </form>
</body>
</html>

.NET Framework
自 1.1 起供應

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

回到頁首
顯示: