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 プロパティは 1 行だけのテキスト ボックスを作成する SingleLine に設定されます。さらに、MultiLine または Password にプロパティを設定できます。MultiLine は、複数行のテキスト ボックスを作成します。Password は、ユーザーが入力した値を隠す単一行テキスト ボックスを作成します。

テキスト ボックスの表示幅は、Columns プロパティで決定されます。テキスト ボックスが複数行テキスト ボックスの場合は、表示高は Rows プロパティで決定されます。

Text プロパティを使用すると、TextBox コントロールの内容を決定できます。MaxLength プロパティを設定することによって、コントロールに入力できる文字数を制限できます。テキスト ボックスの末尾に到達したときに、セルの内容を自動的に改行するように指定するには、Wrap プロパティを true に設定します。

TextBox Web サーバー コントロールのプロパティとイベントの詳細については、TextBox クラスのドキュメントを参照してください。

使用例

.aspx ファイルで TextBox コントロールを宣言する方法を次の例に示します。このコントロールは、最大 10 行まで表示できる複数行テキスト ボックスです。ブラウザがコントロールのフォントをサポートしている場合は、テキストは 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 サーバー コントロール構文