Домашняя Библиотека Обучение Загружаемые компоненты поддержка Сообщество
Вход | United States - English | |
Эта статья переведена вручную. Наведите указатель мыши на предложения статьи, чтобы просмотреть исходный текст.
Перевод
Текст оригинала
Эта тема еще не получила оценку Оценить эту тему

TextBox - класс

.NET Framework 4

Отображает элемент управления текстовым окном для ввода данных пользователем.

System.Object
  System.Web.UI.Control
    System.Web.UI.WebControls.WebControl
      System.Web.UI.WebControls.TextBox

Пространство имен:  System.Web.UI.WebControls
Сборка:  System.Web (в System.Web.dll)
C#
C++
F#
VB
Копировать 
[ControlValuePropertyAttribute("Text")]
[ValidationPropertyAttribute("Text")]
public class TextBox : WebControl, IPostBackDataHandler, 
	IEditableTextControl, ITextControl
ASP.NET
Копировать 
<asp:TextBox />

Тип TextBox предоставляет следующие члены.

  Имя Описание
Открытый метод TextBox Инициализирует новый экземпляр класса TextBox.
В начало страницы
  Имя Описание
Открытое свойство AccessKey Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления. (Унаследовано от WebControl.)
Защищенное свойство Adapter Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control.)
Открытое свойство AppRelativeTemplateSourceDirectory Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control.)
Открытое свойство Attributes Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl.)
Открытое свойство AutoCompleteType Возвращает или задает значение, определяющее поведение автозавершения элемента управления TextBox
Открытое свойство AutoPostBack Возвращает или задает значение, определяющее необходимость автоматической обратной передачи на сервер, если элемент управления TextBox теряет фокус.
Открытое свойство BackColor Получает или задает цвет фона серверного веб-элемента управления. (Унаследовано от WebControl.)
Открытое свойство BindingContainer Инфраструктура. Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control.)
Открытое свойство BorderColor Возвращает или задает цвет рамки элемента управления Веба. (Унаследовано от WebControl.)
Открытое свойство BorderStyle Получает или задает стиль границы серверного веб-элемента управления. (Унаследовано от WebControl.)
Открытое свойство BorderWidth Возвращает или задает ширину границы серверного веб-элемента управления. (Унаследовано от WebControl.)
Открытое свойство CausesValidation Возвращает или задает значение, показывающее, выполняется ли проверка, когда элемент управления TextBox задается для проверке при обратной передаче.
Защищенное свойство ChildControlsCreated Возвращает значение, которое указывает, создан ли дочерний элемент управления серверного элемента управления. (Унаследовано от Control.)
Открытое свойство ClientID Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control.)
Открытое свойство ClientIDMode Получает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control.)
Защищенное свойство ClientIDSeparator Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control.)
Открытое свойство Columns Возвращает или задает ширину отображаемого текстового окна в знаках.
Защищенное свойство Context Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control.)
Открытое свойство Controls Возвращает объект ControlCollection, представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от Control.)
Открытое свойство ControlStyle Возвращает или задает стиль серверного веб-элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl.)
Открытое свойство ControlStyleCreated Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle. Этот свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl.)
Открытое свойство CssClass Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере. (Унаследовано от WebControl.)
Открытое свойство DataItemContainer Получает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control.)
Открытое свойство DataKeysContainer Получает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control.)
Защищенное свойство DesignMode Возвращает значение, определяющее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control.)
Открытое свойство Enabled Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления. (Унаследовано от WebControl.)
Открытое свойство EnableTheming Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl.)
Открытое свойство EnableViewState Получает или задает значение, определяющее сохранение состояния просмотра серверного элемента управления и содержащихся в нем дочерних элементов управления для клиента, создающего запрос. (Унаследовано от Control.)
Защищенное свойство Events Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control.)
Открытое свойство Font Возвращает свойства шрифта, связанные с серверным веб-элементом управления. (Унаследовано от WebControl.)
Открытое свойство ForeColor Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления. (Унаследовано от WebControl.)
Открытое свойство HasAttributes Получает значение, определяющие наличие атрибутов у элемента управления. (Унаследовано от WebControl.)
Защищенное свойство HasChildViewState Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control.)
Открытое свойство Height Получает или задает высоту серверного веб-элемента управления. (Унаследовано от 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 Получает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control.)
Открытое свойство Rows Возвращает или задает число строк, отображаемых в многострочном текстовом окне.
Открытое свойство Site Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control.)
Открытое свойство SkinID Получает или задает обложку, применимую к элементу управления. (Унаследовано от WebControl.)
Открытое свойство Style Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления. (Унаследовано от WebControl.)
Открытое свойство SupportsDisabledAttribute Получает значение, указывающее, должен ли элемент управления устанавливать атрибут disabled отображаемого элемента HTML в значение "disabled", если для свойства элемента управления IsEnabled задано значение false. (Унаследовано от WebControl.)
Открытое свойство TabIndex Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления. (Унаследовано от WebControl.)
Защищенное свойство TagKey Возвращает HTML тег для элемента управления текстовым полем. Это свойство защищено. (Переопределяет WebControl.TagKey.)
Защищенное свойство TagName Возвращает имя тега элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl.)
Открытое свойство TemplateControl Возвращает или устанавливает ссылку на шаблон, содержащий элемент управления. (Унаследовано от Control.)
Открытое свойство TemplateSourceDirectory Возвращает виртуальную папку Page или UserControl, содержащую текущий серверный элемент управления. (Унаследовано от Control.)
Открытое свойство Text Возвращает или задает текстовое содержимое элемента управления TextBox.
Открытое свойство TextMode Возвращает или задает режим для элемента управления TextBox (однострочный, многострочный, режим ввода пароля).
Открытое свойство ToolTip Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления. (Унаследовано от WebControl.)
Открытое свойство UniqueID Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control.)
Открытое свойство ValidationGroup Возвращает или задает группу элементов управления, для которых элемент управления TextBox инициирует проверку при обратной передаче на сервер.
Защищенное свойство ViewState Получает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control.)
Защищенное свойство ViewStateIgnoresCase Возвращает значение, определяющее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control.)
Открытое свойство ViewStateMode Получает или задает режим состояния представления данного элемента управления. (Унаследовано от Control.)
Открытое свойство Visible Возвращает или устанавливает значение, определяющее, преобразован ли серверный элемент управления в пользовательский интерфейс на странице. (Унаследовано от Control.)
Открытое свойство Width Получает или задает ширину серверного веб-элемента управления. (Унаследовано от WebControl.)
Открытое свойство Wrap Возвращает или задает значение, показывающее, осуществляется ли перенос текста внутри многострочного текстового окна.
В начало страницы
  Имя Описание
Защищенный метод AddAttributesToRender Инфраструктура. Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном экземпляре HtmlTextWriter. (Переопределяет WebControl.AddAttributesToRender(HtmlTextWriter).)
Защищенный метод AddedControl Вызывается после того, как дочерний элемент управления добавлен в коллекцию Controls объекта Control. (Унаследовано от Control.)
Защищенный метод AddParsedSubObject Инфраструктура. Переопределен для разращения внесения только символьных элементов управления, в качестве свойства Text. (Переопределяет Control.AddParsedSubObject(Object).)
Открытый метод ApplyStyle Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля. Этот метод, в основном, используется разработчиками элементов управления. (Унаследовано от WebControl.)
Открытый метод ApplyStyleSheetSkin Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control.)
Защищенный метод BuildProfileTree Инфраструктура. Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control.)
Защищенный метод ClearCachedClientID Инфраструктура. Задает для кэшированного свойства ClientID значение Nothing. (Унаследовано от Control.)
Защищенный метод ClearChildControlState Удаляет сведения состояния элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control.)
Защищенный метод ClearChildState Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control.)
Защищенный метод ClearChildViewState Удаляет сведения о состояния представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control.)
Защищенный метод ClearEffectiveClientIDMode Инфраструктура. Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control.)
Открытый метод CopyBaseAttributes Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.)
Защищенный метод CreateChildControls Вызванный страницей ASP.NET, сообщает серверному элементу управления, использующего составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратного запроса или визуализации. (Унаследовано от Control.)
Защищенный метод CreateControlCollection Создает новый объект ControlCollection для хранения дочерних элементов (текстовых и серверных) серверного элемента управления. (Унаследовано от Control.)
Защищенный метод CreateControlStyle Создает объект стиля, который используется внутри класса WebControl для реализации всех относящихся к стилю свойств. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.)
Открытый метод DataBind Связывает источник данных с вызывающим серверным элементом управления и всеми его дочерними элементами управления. (Унаследовано от Control.)
Защищенный метод DataBind(Boolean) Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control.)
Защищенный метод DataBindChildren Привязывает источник данных к дочерним элементам серверного элемента управления. (Унаследовано от Control.)
Открытый метод Dispose Подключает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control.)
Защищенный метод EnsureChildControls Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control.)
Защищенный метод EnsureID Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control.)
Открытый метод Equals(Object) Определяет, равен ли заданный объект Object текущему объекту 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-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control.)
Открытый метод GetRouteUrl(String, RouteValueDictionary) Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control.)
Открытый метод GetType Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
Открытый метод GetUniqueIDRelativeTo Возвращает часть с префиксом свойства UniqueID указанного элемента управления. (Унаследовано от Control.)
Открытый метод HasControls Определяет наличие у серверного элемента управления дочерних элементов управления. (Унаследовано от Control.)
Защищенный метод HasEvents Возвращает значение, определяющее, будут ли регистрироваться события для элемента управления или каких либо дочерних элементов управления. (Унаследовано от Control.)
Защищенный метод IsLiteralContent Инфраструктура. Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control.)
Защищенный метод LoadControlState Восстанавливает сведения о состоянии элемента управления предыдущего запроса страницы, сохраненные методом SaveControlState. (Унаследовано от Control.)
Защищенный метод LoadPostData Обрабатывает данные обратной передачи для элемента управления TextBox.
Защищенный метод LoadViewState Восстанавливает сведения о состоянии представления предыдущего запроса, сохраненные методом SaveViewState. (Унаследовано от WebControl.)
Защищенный метод MapPathSecure Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control.)
Защищенный метод MemberwiseClone Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
Открытый метод MergeStyle Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.)
Защищенный метод OnBubbleEvent Определяет, передается ли событие серверного элемента управления вверх в иерархии серверных элементов управления пользовательского интерфейса страницы. (Унаследовано от Control.)
Защищенный метод OnDataBinding Вызывает событие DataBinding. (Унаследовано от Control.)
Защищенный метод OnInit Создает событие Init. (Унаследовано от Control.)
Защищенный метод OnLoad Вызывает событие Load. (Унаследовано от Control.)
Защищенный метод OnPreRender Инфраструктура. Регистрирует клиентский скрипт для генерации событий обратной передачи перед отрисовкой на клиенте, если AutoPostBack имеет значение true. (Переопределяет Control.OnPreRender(EventArgs).)
Защищенный метод OnTextChanged Генерирует событие TextChanged. Это позволяет непосредственно обрабатывать событие.
Защищенный метод OnUnload Вызывает событие Unload. (Унаследовано от Control.)
Защищенный метод OpenFile Возвращает Stream, используемое для чтения файла. (Унаследовано от Control.)
Защищенный метод RaiseBubbleEvent Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control.)
Защищенный метод RaisePostDataChangedEvent Вызывает событие OnTextChanged, если отправленные данные текстового поля для элемента управления TextBox изменены.
Защищенный метод RemovedControl Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control.)
Защищенный метод Render Выполняет визуализацию элемента управления TextBox в указанный объект HtmlTextWriter. (Переопределяет WebControl.Render(HtmlTextWriter).)
Открытый метод RenderBeginTag Выводит открывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.)
Защищенный метод RenderChildren Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента. (Унаследовано от Control.)
Защищенный метод RenderContents Выводит содержимое элемента управления в заданный модуль записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.)
Открытый метод RenderControl(HtmlTextWriter) Выводит содержимое серверного элемента управления в предоставленный объект HtmlTextWriter и сохраняет сведения трассировки элемента управления, если трассировка включена. (Унаследовано от Control.)
Защищенный метод RenderControl(HtmlTextWriter, ControlAdapter) Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control.)
Открытый метод RenderEndTag Отображает закрывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl.)
Защищенный метод ResolveAdapter Возвращает адаптер элемента управления, отвечающий за визуализацию определенного элемента управления. (Унаследовано от Control.)
Открытый метод ResolveClientUrl Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control.)
Открытый метод ResolveUrl Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control.)
Защищенный метод SaveControlState Сохраняет изменения состояния элемента управления, произошедшие с момента отправки обратной передачи на сервер. (Унаследовано от Control.)
Защищенный метод SaveViewState Сохраняет изменения в состоянии отображения текстового поля после того, как страница отправлена на сервер. (Переопределяет WebControl.SaveViewState.)
Защищенный метод SetDesignModeState Задает данные времени разработки для элемента управления. (Унаследовано от Control.)
Открытый метод SetRenderMethodDelegate Инфраструктура. Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого в родительский элемент управления. (Унаследовано от Control.)
Открытый метод ToString Возвращение строки, представляющей текущий объект. (Унаследовано от Object.)
Защищенный метод TrackViewState Инициирует отслеживание элементом управления изменений в состоянии его представления для сохранения этих изменений в свойстве ViewState данного объекта. (Унаследовано от WebControl.)
В начало страницы
  Имя Описание
Открытое событие DataBinding Происходит при привязке серверного элемента управления к источнику данных. (Унаследовано от Control.)
Открытое событие Disposed Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET. (Унаследовано от Control.)
Открытое событие Init Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла. (Унаследовано от Control.)
Открытое событие Load Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control.)
Открытое событие PreRender Происходит после загрузки объекта Control, но перед визуализацией. (Унаследовано от Control.)
Открытое событие TextChanged Происходит при изменении содержимого текстового окна между отправками на сервер.
Открытое событие Unload Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control.)
В начало страницы
  Имя Описание
Открытый метод расширения FindDataSourceControl Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. (Определено в DynamicDataExtensions.)
Открытый метод расширения FindFieldTemplate Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. (Определено в DynamicDataExtensions.)
Открытый метод расширения FindMetaTable Возвращает объект метатаблицы для контейнерного элемента управления данными. (Определено в DynamicDataExtensions.)
В начало страницы
  Имя Описание
Явная реализация интерфейса Закрытый метод IAttributeAccessor.GetAttribute Инфраструктура. Возвращает атрибуту веб-элемента управления указанное имя. (Унаследовано от WebControl.)
Явная реализация интерфейса Закрытый метод IAttributeAccessor.SetAttribute Задает атрибуту веб-элемента управления указанное имя и значение. (Унаследовано от 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, если отправленные данные текстового поля изменены.
В начало страницы

Содержание раздела

Введение

Серверный элемент управления TextBox является элементом управления вводом, позволяющим пользователю вводить текст. По умолчанию для свойства TextMode данного элемента управления задано значение TextBoxMode.SingleLine, что соответствует отображению однострочного текстового поля. Однако элемент управления TextBox может также отображать многострочное или накладывающее маску на ввод пользователя текстовое окно, если для свойства TextMode задать значение TextBoxMode.MultiLine или TextBoxMode.Password соответственно. Текст, отображаемый в элементе управления TextBox, задается или определяется свойством Text.

Элемент управления TextBox содержит несколько свойств, которые позволяют настраивать его внешний вид. Ширина отображаемого текстового окна в знаках определяется свойством Columns. Если элемент управления TextBox представляет собой многострочное текстовое окно, то число строк определяется свойством Rows. Для обеспечения переноса текста в элементе управления TextBox для свойства Wrap надо задать значение true.

Задав некоторые свойства, можно определить то, каким образом данные должны вводиться в элемент управления TextBox. Чтобы запретить возможность изменять текст, содержащийся в элементе управления, установите для свойства ReadOnly значение true. Для ограничения числа введенных пользователем знаков задайте свойство MaxLength.

Список исходных значений свойств для экземпляра класса TextBox см. в описании конструктора TextBox.

Предупреждающее замечание Внимание

Этот элемент управления можно использовать для приема введенных данных, в которых потенциально содержится вредоносный клиентский скрипт. Проверьте всю информацию, которая отправляется с клиента для исполняемых скриптов, операторов SQL или другого кода, прежде чем отображать ее в приложении. Можно использовать проверяющие элементы управления для проверки введенных пользователем данных перед их отображением в элементе управления. ASP.NET предоставляет функцию проверки входных запросов для блокировки скриптов и кода HTML во вводимых пользователем данных. Дополнительные сведения см. в разделах Защита стандартных элементов управления, Практическое руководство. Защита от использования скриптов в веб-приложениях с помощью применения кодирования HTML к строкам и Проверка сведений, вводимых пользователем на веб-страницах ASP.NET.

Декларативный синтаксис

Копировать 
<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"
/>
Topic Location
Практическое руководство. Получение и установка значений в серверных веб-элементах управления TextBox Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Отклик на изменения в серверном веб-элементе управления TextBox Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Задание свойств серверного веб-элемента управления ASP.NET Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Создание и использование главных страниц ASP.NET в Visual Web Developer Построение приложений при помощи Visual Web Developer
Практическое руководство. Настройка серверного веб-элемента управления TextBox для ввода пароля Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Защита от использования сценариев в веб-приложениях с помощью применения кодирования HTML к строкам Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Проверка сведений, вводимых пользователем на странице веб-форм Построение приложений при помощи Visual Web Developer
Практическое руководство. Установка фокуса на серверных веб-элементах управления ASP.NET Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Привязка данных к пользовательским бизнес-объектам Построение веб-приложений ASP.NET в Visual Studio
Пошаговое руководство. Создание базовой веб-страницы в Visual Web Developer Построение веб-приложений ASP.NET в Visual Studio
Практическое руководство. Задание возможности многострочного ввода для серверного веб-элемента управления TextBox Построение веб-приложений ASP.NET в Visual Studio

Проект веб-сайта Visual Studio с исходным кодом этого примера доступен на следующей странице: Download.

В следующем примере кода демонстрируется использование элемента управления TextBox для получения вводимых данных. При нажатии пользователем на кнопку Add отображается сумма значений, введенных в текстовые окна.

Примечание о безопасности Примечание по безопасности

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

C#
VB
Копировать 

<%@ 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, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista с пакетом обновления 1 (SP1) или выше, Windows XP с пакетом обновления 3 (SP3), 64-разрядный выпуск Windows XP с пакетом обновления 2 (SP2), Windows Server 2008 (Server Core не поддерживается), Windows Server 2008 R2 (Server Core поддерживается с пакетом обновления 1 (SP1) или более поздним), Windows Server 2003 SP2

.NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.
Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.
Считаете ли вы эту страницу полезной?
(Осталось символов: 1500)
Содержимое сообщества Добавить
Аннотации вопросы и ответы