Декларативный синтаксис серверного веб-элемента управления TextBox

Статья
11/16/2008

Обновлен: Ноябрь 2007

Создает однострочные и многострочные текстовые поля.

 <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 см. в документации класса TextBox.

Пример

В следующем примере показано объявление в файле .aspx для элемента управления TextBox. Этот элемент управления представляет собой многострочное текстовое поле, отображающее не более десяти строк. Для вводимого пользователем текста установлен шрифт Arial, если обозреватель поддерживает шрифты для элементов управления.

Примечание о безопасности.
В данном примере представлено текстовое поле для ввода пользовательских данных, которые представляют потенциальную угрозу безопасности. По умолчанию веб-страницы ASP.NET проверяют введенные пользователем данные на наличие сценариев и элементов HTML. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

В данном примере представлено текстовое поле для ввода пользовательских данных, которые представляют потенциальную угрозу безопасности. По умолчанию веб-страницы ASP.NET проверяют введенные пользователем данные на наличие сценариев и элементов 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

Другие ресурсы

Синтаксис серверного веб-элемента управления

Поделиться через