TextBox Web 伺服器控制項宣告式語法

更新：2007 年 11 月

建立單行或多行的文字方塊。

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

備註

TextBox 伺服器控制項是可以讓使用者輸入文字的輸入控制項。根據預設，TextMode 屬性是設定為只用單行來建立文字方塊的 SingleLine。您也可以將屬性設定為 MultiLine 或 Password。MultiLine 會建立一行以上的文字方塊。Password 則會建立單行文字方塊，此文字方塊會遮罩使用者所輸入的值。

文字方塊的顯示寬度是由它的 Columns 屬性決定。如果文字方塊是個多行文字方塊，則顯示高度是由 Rows 屬性所決定。

請使用 Text 屬性來決定 TextBox 控制項的內容。您可以設定 MaxLength 屬性，以限制可以在控制項中輸入的字元數目。若要指定儲存格內容到達文字方塊結尾時應自動從下一行繼續，請將 Wrap 屬性設定為 true。

如需 TextBox Web 伺服器控制項之屬性和事件的詳細資訊，請參閱 TextBox 類別文件。

範例

下列範例會示範 .aspx 檔案中 TextBox 控制項的範例宣告。這個控制項是最多可顯示十行的多行文字方塊。如果瀏覽器支援這個控制項的字型，文字會被格式化成為 Arial 字型。

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

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

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

請參閱

參考

TextBox

其他資源

Web 伺服器控制項語法