Web服務器控件：TextBox控件

定義和用法

TextBox 控件用於創建用戶可輸入文本的文本框。創建單行和多行文本框。

屬性

屬性 描述 .Net AutoCompleteType 規定 TextBox 控件的 AutoComplete 行為。 2.0 AutoPostBack 布爾值，規定當內容改變時，是否回傳到服務器。默認是 false。 1.0 CausesValidation 規定當 Postback 發生時，是否驗證頁面。 2.0 Columns textbox 的寬度。 1.0 MaxLength 在 textbox 中所允許的最大字符數。 1.0 ReadOnly 規定能否改變文本框中的文本。 1.0 Rows textbox 的高度（僅在 TextMode="Multiline" 時使用）。 1.0 runat 規定該控件是否是服務器控件。必須設置為 "server"。   TagKey     Text textbox 的內容。 1.0 TextMode 規定 TextBox 的行為模式（單行、多行或密碼）。 1.0 ValidationGroup 當 Postback 發生時，被驗證的控件組。   Wrap 布爾值，指示 textbox 的內容是否換行。 1.0 OnTextChanged 當 textbox 中的文本被更改時，被執行的函數的名稱。  

Web 控件標准屬性

AccessKey, Attributes, BackColor, BorderColor, BorderStyle, BorderWidth, 
CSSClass, Enabled, Font, EnableTheming, ForeColor, Height, IsEnabled, 
SkinID, Style, TabIndex, ToolTip, Width

控件標准屬性

AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, 
EnableTheming, EnableVIEwState, ID, NamingContainer, Page, Parent, Site, 
TemplateControl, TemplateSourceDirectory, UniqueID, Visible

語法

<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"
    BorderPADDING-BOTTOM: 0px; MARGIN: 0px; PADDING-LEFT: 0px; PADDING-RIGHT: 0px; PADDING-TOP: 0px">        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"
   
    TabIndex="integer"
    Text="string"
    TextMode="SingleLine|MultiLine|PassWord"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
    Wrap="True|False"
/>

備注：TextBox 服務器控件是讓用戶輸入文本的輸入控件。默認情況下，TextMode 屬性設置為 SingleLine，它創建只包含一行的文本框。您也可以將該屬性設置為 MultiLine 或 Password。MultiLine 創建包含多行的文本框。PassWord 創建可以屏蔽用戶輸入的值的單行文本框。

文本框的顯示寬度由其 Columns 屬性確定。如果文本框是多行文本框，則顯示高度由 Rows 屬性確定。

使用 Text 屬性確定 TextBox 控件的內容。通過設置 MaxLength 屬性，可以限制可輸入到此控件中的字符數。將 Wrap 屬性設置為 true 來指定當到達文本框的結尾時，單元格內容應自動在下一行繼續。

示例

以下內容顯示如何在 .ASPx 文件中聲明 TextBox 控件的示例。此控件是最多可顯示 10 行的多行文本框。如果浏覽器對控件支持字體，則文本將被格式化為 Arial 字體。

Visual Basic

<ASP:TextBox id="txtLogin" runat=server
     Text="" Font-Names="Arial" 
     Font-Size="10"
     BackColor="lightblue"
     TextMode="MultiLine"
     Height="43px"
/>

C#

<ASP:TextBox id="txtLogin" runat=server
     Text="" Font-Names="Arial" 
     Font-Size="10"
     BackColor="lightblue"
     TextMode="MultiLine"
     Height="43px"
 />