匯出 (0) 列印
全部展開
本文章是由機器翻譯。 將指標移到文章內的文字上方即可查看原文。 其他資訊。
譯文
原文

TextBox 類別

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

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

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

TextBox 類型會公開下列成員。

  名稱描述
公用方法TextBox初始化 TextBox 類別的新執行個體。
回頁首

  名稱描述
公用屬性AccessKey取得或設定便捷鍵 (Access Key),可讓您快速巡覽至 Web 伺服器控制項。 (繼承自 WebControl)。
受保護的屬性Adapter針對控制項取得瀏覽器的特定配置器。 (繼承自 Control)。
公用屬性AppRelativeTemplateSourceDirectory取得或設定包含了此控制項之 PageUserControl 物件的相對應用程式虛擬目錄。 (繼承自 Control)。
公用屬性Attributes取得任意屬性 (Attribute) 的集合 (只供呈現),不與控制項上的屬性 (Property) 對應。 (繼承自 WebControl)。
公用屬性AutoCompleteType取得或設定值,表示 TextBox 控制項的 AutoComplete 行為。
公用屬性AutoPostBack取得或設定值,這個值表示是否要在 TextBox 控制項失去焦點時自動回傳至伺服器。
公用屬性BackColor取得或設定 Web 伺服器控制項的背景色彩。 (繼承自 WebControl)。
公用屬性BindingContainer基礎架構。取得包含了此控制項之資料繫結的控制項。 (繼承自 Control)。
公用屬性BorderColor取得或設定 Web 控制項的框線色彩。 (繼承自 WebControl)。
公用屬性BorderStyle取得或設定 Web 伺服器控制項的框線樣式。 (繼承自 WebControl)。
公用屬性BorderWidth取得或設定 Web 伺服器控制項的框線寬度。 (繼承自 WebControl)。
公用屬性CausesValidation取得或設定值,表示當 TextBox 控制項設定為驗證回傳發生的時間時是否執行驗證。
受保護的屬性ChildControlsCreated取得值,指出是否已經建立伺服器控制項的子控制項。 (繼承自 Control)。
公用屬性ClientID取得 ASP.NET 產生之 HTML 標記的控制項 ID。 (繼承自 Control)。
公用屬性ClientIDMode取得或設定用來產生 ClientID 屬性值的演算法。 (繼承自 Control)。
受保護的屬性ClientIDSeparator取得字元值,表示在 ClientID 屬性中所使用的分隔字元。 (繼承自 Control)。
公用屬性Columns取得或設定文字方塊中的顯示寬度,以字元為單位。
受保護的屬性Context取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承自 Control)。
公用屬性Controls取得 ControlCollection 物件,表示 UI 階層架構中指定控制項的子控制項。 (繼承自 Control)。
公用屬性ControlStyle取得 Web 伺服器控制項的樣式。 這個屬性主要由控制項開發人員使用。 (繼承自 WebControl)。
公用屬性ControlStyleCreated取得值,指出 Style 物件是否已經為 ControlStyle 屬性建立。 這個屬性主要由控制項開發人員使用。 (繼承自 WebControl)。
公用屬性CssClass取得或設定用戶端上 Web 伺服器控制項所呈現的階層式樣式表 (CSS)。 (繼承自 WebControl)。
公用屬性DataItemContainer如果命名容器實作 IDataItemContainer,則取得命名容器的參考。 (繼承自 Control)。
公用屬性DataKeysContainer如果命名容器實作 IDataKeysControl,則取得命名容器的參考。 (繼承自 Control)。
受保護的屬性DesignMode取得值,指出控制項是否正用於設計介面上。 (繼承自 Control)。
公用屬性Enabled取得或設定值,指出 Web 伺服器控制項是否啟用。 (繼承自 WebControl)。
公用屬性EnableTheming取得或設定值,指出佈景主題是否套用至此控制項。 (繼承自 WebControl)。
公用屬性EnableViewState取得或設定值,指出伺服器控制項是否要保持其檢視狀態以及它所包含之任何子控制項的檢視狀態 (針對要求的用戶端)。 (繼承自 Control)。
受保護的屬性Events取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承自 Control)。
公用屬性Font取得與 Web 伺服器控制項關聯的字型屬性。 (繼承自 WebControl)。
公用屬性ForeColor取得或設定 Web 伺服器控制項的前景色彩 (通常是文字的色彩)。 (繼承自 WebControl)。
公用屬性HasAttributes取得值,指出控制項是否已經設定屬性。 (繼承自 WebControl)。
受保護的屬性HasChildViewState取得值,指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承自 Control)。
公用屬性Height取得或設定 Web 伺服器控制項的高度。 (繼承自 WebControl)。
公用屬性ID取得或設定指派給伺服器控制項的程式設計識別項。 (繼承自 Control)。
受保護的屬性IdSeparator基礎架構。取得用來分隔控制項識別項的字元。 (繼承自 Control)。
受保護的屬性IsChildControlStateCleared取得值,指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承自 Control)。
受保護的屬性IsEnabled取得值,指出是否啟用控制項。 (繼承自 WebControl)。
受保護的屬性IsTrackingViewState取得值,指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承自 Control)。
受保護的屬性IsViewStateEnabled取得值,指出這個控制項是否已啟用檢視狀態。 (繼承自 Control)。
受保護的屬性LoadViewStateByID取得值,指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承自 Control)。
公用屬性MaxLength取得或設定文字方塊中所允許的字元數上限。
公用屬性NamingContainer取得伺服器控制項命名容器的參考,其建立唯一命名空間,在具有相同 Control.ID 屬性值的伺服器控制項之間作區別。 (繼承自 Control)。
公用屬性Page取得含有伺服器控制項的 Page 執行個體的參考。 (繼承自 Control)。
公用屬性Parent在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承自 Control)。
公用屬性ReadOnly取得或設定值,指出是否可變更 TextBox 控制項的內容。
公用屬性RenderingCompatibility取得值,這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承自 Control)。
公用屬性Rows取得或設定多行文字方塊中所顯示的列數。
公用屬性Site當呈現在設計介面上時,取得裝載目前控制項之容器的資訊。 (繼承自 Control)。
公用屬性SkinID取得或設定要套用至控制項的面板。 (繼承自 WebControl)。
公用屬性Style取得文字屬性的集合,將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。 (繼承自 WebControl)。
公用屬性SupportsDisabledAttribute取得值,這個值表示當控制項的 IsEnabled 屬性為 false 時,控制項是否應該將所轉譯 HTML 項目的 disabled 屬性設為 "disabled"。 (繼承自 WebControl)。
公用屬性TabIndex取得或設定 Web 伺服器控制項的定位索引。 (繼承自 WebControl)。
受保護的屬性TagKey取得文字方塊控制項的 HTML 標記。 這個屬性受到保護。 (覆寫 WebControl.TagKey。)
受保護的屬性TagName取得控制項標記的名稱。 這個屬性主要由控制項開發人員使用。 (繼承自 WebControl)。
公用屬性TemplateControl取得或設定包含了此控制項之樣板的參考。 (繼承自 Control)。
公用屬性TemplateSourceDirectory取得包含目前伺服器控制項的 PageUserControl 的虛擬目錄。 (繼承自 Control)。
公用屬性Text取得或設定 TextBox 控制項的文字內容。
公用屬性TextMode取得或設定 TextBox 控制項的行為模式 (單行、多行或密碼)。
公用屬性ToolTip取得或設定當滑鼠指標停留在 Web 伺服器控制項時顯示的文字。 (繼承自 WebControl)。
公用屬性UniqueID取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承自 Control)。
公用屬性ValidateRequestMode取得或設定值,指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承自 Control)。
公用屬性ValidationGroup取得或設定控制項群組,TextBox 控制項會在回傳至伺服器時,針對這個群組進行驗證。
受保護的屬性ViewState取得狀態資訊的字典,允許您在相同網頁的多個要求之間,儲存和還原伺服器控制項的檢視狀態。 (繼承自 Control)。
受保護的屬性ViewStateIgnoresCase取得值,指出 StateBag 物件是否不區分大小寫。 (繼承自 Control)。
公用屬性ViewStateMode取得或設定這個控制項的檢視狀態模式。 (繼承自 Control)。
公用屬性Visible取得或設定值,指出伺服器控制項是否要呈現為網頁上的 UI。 (繼承自 Control)。
公用屬性Width取得或設定 Web 伺服器控制項的寬度。 (繼承自 WebControl)。
公用屬性Wrap取得或設定值,指出多行文字方塊中的文字內容是否換行。
回頁首

  名稱描述
受保護的方法AddAttributesToRender基礎架構。將需要呈現的 HTML 屬性 (Attribute) 和樣式加入至指定的 HtmlTextWriter 執行個體。 (覆寫 WebControl.AddAttributesToRender(HtmlTextWriter)。)
受保護的方法AddedControl在子控制項加入至 Control 物件的 Controls 集合之後,再進行呼叫。 (繼承自 Control)。
受保護的方法AddParsedSubObject基礎架構。被覆寫,以僅允許常值 (Literal) 控制項做為 Text 屬性加入。 (覆寫 Control.AddParsedSubObject(Object)。)
公用方法ApplyStyle將指定樣式的任何非空白項目加入到 Web 控制項中,覆寫控制項的任何現有的樣式項目。 這個方法主要由控制項開發人員使用。 (繼承自 WebControl)。
公用方法ApplyStyleSheetSkin將頁面樣式表中所定義的樣式屬性套用至控制項。 (繼承自 Control)。
受保護的方法BeginRenderTracing開始進行轉譯資料的設計階段追蹤。 (繼承自 Control)。
受保護的方法BuildProfileTree基礎架構。收集伺服器控制項的相關資訊,並在頁面啟用追蹤時將此資訊傳遞至 Trace 屬性以顯示之。 (繼承自 Control)。
受保護的方法ClearCachedClientID基礎架構。將快取的 ClientID 值設定為 null (繼承自 Control)。
受保護的方法ClearChildControlState刪除伺服器控制項之子控制項的控制項狀態資訊。 (繼承自 Control)。
受保護的方法ClearChildState刪除所有伺服器控制項之子控制項的檢視狀態和控制項狀態資訊。 (繼承自 Control)。
受保護的方法ClearChildViewState刪除所有伺服器控制項之子控制項的檢視狀態資訊。 (繼承自 Control)。
受保護的方法ClearEffectiveClientIDMode基礎架構。將目前的控制項執行個體和任何子控制項的 ClientIDMode 屬性設定為 Inherit (繼承自 Control)。
公用方法CopyBaseAttributes將不被 Style 物件封裝的屬性從指定的 Web 伺服器控制項複製到呼叫這個方法的 Web 伺服器控制項上。 這個方法主要由控制項開發人員使用。 (繼承自 WebControl)。
受保護的方法CreateChildControls由 ASP.NET 網頁架構呼叫,通知採用複合架構實作的伺服器控制項,去建立其包含的任何子控制項以備傳回或呈現。 (繼承自 Control)。
受保護的方法CreateControlCollection建立新 ControlCollection 物件,以儲存伺服器控制項的子控制項 (常值和伺服器兩者)。 (繼承自 Control)。
受保護的方法CreateControlStyle建立樣式物件,這個物件被 WebControl 類別內部使用,以實作所有的樣式相關屬性。 這個方法主要由控制項開發人員使用。 (繼承自 WebControl)。
公用方法DataBind()將資料來源繫結至叫用的伺服器控制項和它的全部子控制項。 (繼承自 Control)。
受保護的方法DataBind(Boolean)使用會引發 DataBinding 事件的選項,繫結資料來源至叫用的伺服器控制項及其所有子控制項。 (繼承自 Control)。
受保護的方法DataBindChildren繫結資料來源至伺服器控制項的子控制項。 (繼承自 Control)。
公用方法Dispose啟用伺服器控制項,在它從記憶體釋放之前執行最後清除。 (繼承自 Control)。
受保護的方法EndRenderTracing結束轉譯資料的設計階段追蹤。 (繼承自 Control)。
受保護的方法EnsureChildControls判斷伺服器控制項是否包含子控制項。 如果不包含,則建立子控制項。 (繼承自 Control)。
受保護的方法EnsureID為尚未指定識別項的控制項,建立識別項。 (繼承自 Control)。
公用方法Equals(Object)判斷指定的物件是否等於目前物件。 (繼承自 Object)。
受保護的方法Finalize 允許物件在記憶體回收進行回收之前,嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
公用方法FindControl(String) 以指定的id去搜尋當前容器內的伺服器控制項。 (繼承自 Control)。
受保護的方法FindControl(String, Int32)基礎架構。使用指定的 id 和有助於搜尋之 pathOffset 參數中所指定的整數,在目前的命名容器中搜尋伺服器控制項。 您不應該覆寫這個版本的 FindControl 方法。 (繼承自 Control)。
公用方法Focus 將輸入游標帶到此控制項。 (繼承自 Control)。
受保護的方法GetDesignModeState基礎架構。取得控制項的設計階段資料。 (繼承自 Control)。
公用方法GetHashCode做為預設雜湊函式。 (繼承自 Object)。
公用方法GetRouteUrl(Object)取得會對應於一組路由參數的 URL。 (繼承自 Control)。
公用方法GetRouteUrl(RouteValueDictionary)取得會對應於一組路由參數的 URL。 (繼承自 Control)。
公用方法GetRouteUrl(String, Object)取得 URL,此 URL 對應於一組路由參數及一個路由名稱。 (繼承自 Control)。
公用方法GetRouteUrl(String, RouteValueDictionary)取得 URL,此 URL 對應於一組路由參數及一個路由名稱。 (繼承自 Control)。
公用方法GetType取得目前執行個體的 Type (繼承自 Object)。
公用方法GetUniqueIDRelativeTo傳回指定之控制項 UniqueID 屬性的前置部分。 (繼承自 Control)。
公用方法HasControls判斷伺服器控制項是否包含任何子控制項。 (繼承自 Control)。
受保護的方法HasEvents傳回值,指出控制項或任何子控制項的事件是否已註冊。 (繼承自 Control)。
受保護的方法IsLiteralContent基礎架構。判斷伺服器控制項是否只儲存常值內容。 (繼承自 Control)。
受保護的方法LoadControlStateSaveControlState 方法所儲存的上一頁要求中,還原控制項狀態資訊。 (繼承自 Control)。
受保護的方法LoadPostData處理 TextBox 控制項的回傳資料。
受保護的方法LoadViewState從使用 SaveViewState 方法所儲存的先前要求來還原檢視狀態資訊。 (繼承自 WebControl)。
受保護的方法MapPathSecure擷取虛擬絕對路徑或相對路徑所對應至的實體路徑。 (繼承自 Control)。
受保護的方法MemberwiseClone建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
公用方法MergeStyle將指定樣式的任何非空白項目複製到 Web 控制項,但不覆寫控制項的任何現有樣式項目。 這個方法主要由控制項開發人員使用。 (繼承自 WebControl)。
受保護的方法OnBubbleEvent判斷伺服器控制項的事件是否要在網頁的 UI 伺服器控制階層架構中向上傳遞。 (繼承自 Control)。
受保護的方法OnDataBinding引發 DataBinding 事件。 (繼承自 Control)。
受保護的方法OnInit引發 Init 事件。 (繼承自 Control)。
受保護的方法OnLoad引發 Load 事件。 (繼承自 Control)。
受保護的方法OnPreRender基礎架構。如果 AutoPostBacktrue,則在用戶端上呈現前,會先註冊產生回傳事件的用戶端指令碼。 (覆寫 Control.OnPreRender(EventArgs)。)
受保護的方法OnTextChanged引發 TextChanged 事件。 這允許您直接處理事件。
受保護的方法OnUnload引發 Unload 事件。 (繼承自 Control)。
受保護的方法OpenFile取得用來讀取檔案的 Stream (繼承自 Control)。
受保護的方法RaiseBubbleEvent指派事件的任何來源和它的資訊至控制項的父控制項。 (繼承自 Control)。
受保護的方法RaisePostDataChangedEventTextBox 控制項的張貼資料已變更時,便叫用 OnTextChanged 方法。
受保護的方法RemovedControl在從 Control 物件的 Controls 集合移除子控制項之後,再進行呼叫。 (繼承自 Control)。
受保護的方法RenderTextBox 控制項呈現為指定的 HtmlTextWriter 物件。 (覆寫 WebControl.Render(HtmlTextWriter)。)
公用方法RenderBeginTag將控制項的 HTML 開頭標記呈現在指定的寫入器中。 這個方法主要由控制項開發人員使用。 (繼承自 WebControl)。
受保護的方法RenderChildren輸出伺服器控制項之子控制項的內容至提供的 HtmlTextWriter 物件,這個物件會寫入用戶端上所要呈現的內容。 (繼承自 Control)。
受保護的方法RenderContents將控制項的內容呈現在指定的寫入器。 這個方法主要由控制項開發人員使用。 (繼承自 WebControl)。
公用方法RenderControl(HtmlTextWriter)將伺服器控制項內容輸出到提供的 HtmlTextWriter 物件,並且儲存控制項的追蹤資訊 (如果已啟用追蹤)。 (繼承自 Control)。
受保護的方法RenderControl(HtmlTextWriter, ControlAdapter)使用提供的 ControlAdapter 物件,輸出伺服器控制項內容至提供的 HtmlTextWriter 物件。 (繼承自 Control)。
公用方法RenderEndTag將控制項的 HTML 結尾標記呈現至指定的寫入器。 這個方法主要由控制項開發人員使用。 (繼承自 WebControl)。
受保護的方法ResolveAdapter取得負責呈現指定之控制項的控制項配置器。 (繼承自 Control)。
公用方法ResolveClientUrl取得瀏覽器可使用的 URL。 (繼承自 Control)。
公用方法ResolveUrl將 URL 轉換為要求用戶端可使用的 URL。 (繼承自 Control)。
受保護的方法SaveControlState儲存從網頁回傳到伺服器起,發生的任何伺服器控制項狀態變更。 (繼承自 Control)。
受保護的方法SaveViewState儲存自頁面回傳至伺服器以來文字方塊檢視狀態的變更。 (覆寫 WebControl.SaveViewState()。)
受保護的方法SetDesignModeState設定控制項的設計階段資料。 (繼承自 Control)。
公用方法SetRenderMethodDelegate基礎架構。指定事件處理常式委派,以呈現伺服器控制項及其內容至其父控制項。 (繼承自 Control)。
公用方法SetTraceData(Object, Object)使用追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承自 Control)。
公用方法SetTraceData(Object, Object, Object)使用追蹤的物體、追蹤資料機碼和追蹤資料值,設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承自 Control)。
公用方法ToString傳回表示目前物件的字串。 (繼承自 Object)。
受保護的方法TrackViewState讓控制項追蹤其檢視狀態的變更,以便將這些變更儲存在物件的 ViewState 屬性中。 (繼承自 WebControl)。
回頁首

  名稱描述
公用事件DataBinding發生於伺服器控制項繫結至資料來源時。 (繼承自 Control)。
公用事件Disposed發生於伺服器控制項從記憶體釋放時,這是在要求 ASP.NET 網頁時,伺服器控制項生命週期的最後階段。 (繼承自 Control)。
公用事件Init發生於初始化伺服器控制項時,是其生命週期中的第一個步驟。 (繼承自 Control)。
公用事件Load發生於載入伺服器控制項至 Page 物件時。 (繼承自 Control)。
公用事件PreRenderControl 物件載入之後但在呈現之前發生。 (繼承自 Control)。
公用事件TextChanged發生於文字方塊的內容在發佈至伺服器期間變更時。
公用事件Unload發生於伺服器控制項從記憶體卸載時。 (繼承自 Control)。
回頁首

  名稱描述
公用擴充方法FindDataSourceControl傳回與指定之控制項的資料控制項相關聯的資料來源。 (以 DynamicDataExtensions 定義。)
公用擴充方法FindFieldTemplate傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 (以 DynamicDataExtensions 定義。)
公用擴充方法FindMetaTable傳回包含資料控制項的中繼資料表物件。 (以 DynamicDataExtensions 定義。)
回頁首

  名稱描述
明確介面實作私用方法IAttributeAccessor.GetAttribute基礎架構。使用指定的名稱,取得 Web 控制項的屬性。 (繼承自 WebControl)。
明確介面實作私用方法IAttributeAccessor.SetAttribute將 Web 控制項的屬性設定為指定的名稱和值。 (繼承自 WebControl)。
明確介面實作私用屬性IControlBuilderAccessor.ControlBuilder如需這個成員的說明,請參閱 IControlBuilderAccessor.ControlBuilder (繼承自 Control)。
明確介面實作私用方法IControlDesignerAccessor.GetDesignModeState如需這個成員的說明,請參閱 IControlDesignerAccessor.GetDesignModeState (繼承自 Control)。
明確介面實作私用方法IControlDesignerAccessor.SetDesignModeState如需這個成員的說明,請參閱 IControlDesignerAccessor.SetDesignModeState (繼承自 Control)。
明確介面實作私用方法IControlDesignerAccessor.SetOwnerControl基礎架構。如需這個成員的說明,請參閱 IControlDesignerAccessor.SetOwnerControl (繼承自 Control)。
明確介面實作私用屬性IControlDesignerAccessor.UserData如需這個成員的說明,請參閱 IControlDesignerAccessor.UserData (繼承自 Control)。
明確介面實作私用屬性IDataBindingsAccessor.DataBindings如需這個成員的說明,請參閱 IDataBindingsAccessor.DataBindings (繼承自 Control)。
明確介面實作私用屬性IDataBindingsAccessor.HasDataBindings如需這個成員的說明,請參閱 IDataBindingsAccessor.HasDataBindings (繼承自 Control)。
明確介面實作私用屬性IExpressionsAccessor.Expressions如需這個成員的說明,請參閱 IExpressionsAccessor.Expressions (繼承自 Control)。
明確介面實作私用屬性IExpressionsAccessor.HasExpressions如需這個成員的說明,請參閱 IExpressionsAccessor.HasExpressions (繼承自 Control)。
明確介面實作私用方法IParserAccessor.AddParsedSubObject如需這個成員的說明,請參閱 IParserAccessor.AddParsedSubObject (繼承自 Control)。
明確介面實作私用方法IPostBackDataHandler.LoadPostData基礎架構。如果張貼的文字方塊內容與最後張貼的內容不同,則將其載入。
明確介面實作私用方法IPostBackDataHandler.RaisePostDataChangedEvent基礎架構。只要文字方塊的張貼資料已變更,便會叫用 OnTextChanged 方法。
回頁首

In this topic:

Introduction

The TextBox server control is an input control that lets the user enter text. By default, the TextMode property of the control is set to TextBoxMode.SingleLine, which displays a single-line text box. However, you can also use the TextBox control to display a multiline text box or a text box that masks user input by changing the value of the TextMode property to TextBoxMode.MultiLine or TextBoxMode.Password, respectively. The text displayed in the TextBox control is specified or determined by using the Text property.

The TextBox control contains several properties that allow you to control the appearance of the control. The display width of the text box, in characters, is determined by its Columns property. If the TextBox control is a multiline text box, the number of rows it displays is determined by the Rows property. To display text that wraps within the TextBox control, set the Wrap property to true.

You can also specify how data is entered in the TextBox control by setting a few properties. To prevent the text displayed in the control from being modified, set the ReadOnly property to true. If you want to limit the user input to a specified number of characters, set the MaxLength property.

For a list of initial property values for an instance of TextBox, see the TextBox constructor.

注意事項警告

This control can be used to accept user input, which might include malicious client script. Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. You can use validation controls to verify user input before displaying the input text in a control. ASP.NET provides an input request validation feature to block script and HTML in user input. For more information, see Securing Standard ControlsHow to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings, and Introduction to Validating User Input in ASP.NET Web Pages.

Declarative Syntax

<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"
/>
TopicLocation
逐步解說:在 Visual Web Developer 中使用階層式樣式表的樣式在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:在 Visual Web Developer 中建立和使用 ASP.NET 主版頁面在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:驗證 Web Form 網頁中的使用者輸入在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:資料繫結至自訂的商務物件在 Visual Studio 中建置 ASP .NET Web 應用程式
逐步解說:在 Visual Web Developer 中建立基本 Web 網頁在 Visual Studio 中建置 ASP .NET Web 應用程式
HOW TO:回應 TextBox Web 伺服器控制項中的變更建置 ASP .NET Web 應用程式
HOW TO:利用將 HTML 編碼套用至字串的方法,防止會在 Web 應用程式中發生的指令碼攻擊建置 ASP .NET Web 應用程式
HOW TO:取得和設定 TextBox Web 伺服器控制項的值建置 ASP .NET Web 應用程式
HOW TO:設定 ASP.NET Web 伺服器控制項屬性建置 ASP .NET Web 應用程式
HOW TO:為密碼輸入設定 TextBox Web 伺服器控制項建置 ASP .NET Web 應用程式
HOW TO:在 ASP.NET Web 伺服器控制項上設定焦點建置 ASP .NET Web 應用程式
HOW TO:為 TextBox Web 伺服器控制項指定多行輸入建置 ASP .NET Web 應用程式
HOW TO:取得和設定 TextBox Web 伺服器控制項的值在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:回應 TextBox Web 伺服器控制項中的變更在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:設定 ASP.NET Web 伺服器控制項屬性在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:在 Visual Web Developer 中建立和使用 ASP.NET 主版頁面使用 Visual Web Developer 建置應用程式
HOW TO:為密碼輸入設定 TextBox Web 伺服器控制項在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:利用將 HTML 編碼套用至字串的方法,防止會在 Web 應用程式中發生的指令碼攻擊在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:驗證 Web Form 網頁中的使用者輸入使用 Visual Web Developer 建置應用程式
HOW TO:在 ASP.NET Web 伺服器控制項上設定焦點在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:資料繫結至自訂的商務物件在 Visual Studio 中建立 ASP .NET Web 應用程式
逐步解說:在 Visual Web Developer 中建立基本 Web 網頁在 Visual Studio 中建立 ASP .NET Web 應用程式
HOW TO:為 TextBox Web 伺服器控制項指定多行輸入在 Visual Studio 中建立 ASP .NET Web 應用程式

A Visual Studio Web site project with source code is available to accompany this topic: Download.

The following code example demonstrates how to use the TextBox control to get user input. When the user clicks the Add button, the sum of the values entered in the text boxes is displayed.

安全性注意事項安全性提示

This example has a text box that accepts user input, which is a potential security threat. ASP.NET Web 網頁預設會對使用者的輸入進行驗證,輸入項目不能包含指令碼或 HTML 項目。
For more information, see Script Exploits Overview.


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

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

<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>

      <table>

         <tr>

            <td colspan="5">

               Enter integer values into the text boxes. <br />
               Click the Add button to add the two values. <br />
               Click the Reset button to reset the text boxes.

            </td>

         </tr>

         <tr>

            <td colspan="5">

               &nbsp;

            </td>

         </tr>

         <tr align="center">

            <td>

               <asp:TextBox ID="Value1"
                    Columns="2"
                    MaxLength="3"
                    Text="1"
                    runat="server"/>

            </td>

            <td>

               + 

            </td>

            <td>

               <asp:TextBox ID="Value2"
                    Columns="2"
                    MaxLength="3"
                    Text="1"
                    runat="server"/>

            </td>

            <td>

               =

            </td>

            <td>

               <asp:Label ID="AnswerMessage"
                    runat="server"/>

            </td>

         </tr>

         <tr>

            <td colspan="2">

               <asp:RequiredFieldValidator
                    ID="Value1RequiredValidator"
                    ControlToValidate="Value1"
                    ErrorMessage="Please enter a value.<br />"
                    Display="Dynamic"
                    runat="server"/>

               <asp:RangeValidator
                    ID="Value1RangeValidator"
                    ControlToValidate="Value1"
                    Type="Integer"
                    MinimumValue="1"
                    MaximumValue="100"
                    ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
                    Display="Dynamic"
                    runat="server"/>

            </td>

            <td colspan="2">

               <asp:RequiredFieldValidator
                    ID="Value2RequiredValidator"
                    ControlToValidate="Value2"
                    ErrorMessage="Please enter a value.<br />"
                    Display="Dynamic"
                    runat="server"/>

               <asp:RangeValidator
                    ID="Value2RangeValidator"
                    ControlToValidate="Value2"
                    Type="Integer"
                    MinimumValue="1"
                    MaximumValue="100"
                    ErrorMessage="Please enter an integer <br /> between than 1 and 100.<br />"
                    Display="Dynamic"
                    runat="server"/>

            </td>

            <td>

               &nbsp

            </td>

         </tr>

         <tr align="center">

            <td colspan="4">

               <asp:Button ID="AddButton"
                    Text="Add"
                    OnClick="AddButton_Click"
                    runat="server"/>

            </td>

            <td>

               &nbsp;

            </td>

         </tr>

      </table>

   </form>

</body>
</html>


.NET Framework

支援版本:4.5.2、4.5.1、4.5、4、3.5、3.0、2.0、1.1、1.0

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (不支援伺服器核心角色), Windows Server 2008 R2 (SP1 (含) 以後版本支援伺服器核心角色,不支援 Itanium)

.NET Framework 並不支援各種平台的所有版本。如需支援版本的清單,請參閱.NET Framework 系統需求

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

社群新增項目

新增
顯示:
© 2014 Microsoft