UserControl Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет ASCX-файл, также известный как пользовательский элемент управления, запрошенный с сервера, на котором размещено ASP.NET веб-приложение. Файл должен вызываться со страницы веб-форм или возникнет ошибка синтаксического анализа.
public ref class UserControl : System::Web::UI::TemplateControl, System::Web::UI::IAttributeAccessor, System::Web::UI::IUserControlDesignerAccessor
public class UserControl : System.Web.UI.TemplateControl, System.Web.UI.IAttributeAccessor, System.Web.UI.IUserControlDesignerAccessor
type UserControl = class
inherit TemplateControl
interface IAttributeAccessor
interface IUserControlDesignerAccessor
type UserControl = class
inherit TemplateControl
interface IAttributeAccessor
interface INamingContainer
interface IUserControlDesignerAccessor
Public Class UserControl
Inherits TemplateControl
Implements IAttributeAccessor, IUserControlDesignerAccessor
- Наследование
- Производный
- Реализации
Примеры
Класс, определенный в следующем примере, SimpleControlнаследует UserControl класс и может использоваться в качестве класса ASP.NET кода программной части. Он использует TextBoxэлементы управления и LabelButton веб-серверы и определяет myButton_Click метод, который назначает TextBox.Text значение свойства вместе с двумя строками Label.Text для свойства.
Это важно
В этом примере есть текстовое поле, которое принимает входные данные пользователя, которое является потенциальной угрозой безопасности. По умолчанию ASP.NET веб-страницы проверяют, что входные данные пользователя не включают скрипт или ЭЛЕМЕНТЫ HTML. Дополнительные сведения см. в разделе "Обзор эксплойтов скриптов".
using System;
using System.Web.UI;
using System.Web.UI.WebControls;
public class SimpleControl:UserControl
{
public TextBox name;
public Label output;
public Button myButton;
public void myButton_Click(object sender, EventArgs e)
{
output.Text = "Hello, " + name.Text + ".";
}
}
Imports System.Web.UI
Imports System.Web.UI.WebControls
Public Class SimpleControl
Inherits UserControl
Public name As TextBox
Public output As Label
Public myButton As Button
Public Sub myButton_Click(sender As Object, e As EventArgs)
output.Text = "Hello, " + name.Text + "."
End Sub
End Class
Следующий пример — разметка, содержащаяся в ASCX-файле. Класс, определенный в предыдущем примере, можно использовать SimpleControl в качестве класса программной части для разметки в этом ASCX-файле.
<%@ control inherits = "SimpleControl" src = "SimpleControl.cs" %>
<table style="background-color:yellow;font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button id="myButton" text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>
<%@ control inherits = "SimpleControl" src = "SimpleControl.vb" %>
<table style="background-color: yellow; font: 10pt verdana;border-width:1;border-style:solid;border-color:black;" cellspacing="15">
<tr>
<td><b>Enter your name here: </b></td>
<td><ASP:TextBox id="name" runat="server"/></td>
</tr>
<tr>
<td><b><ASP:Label id="output" runat="server"/></b></td>
</tr>
<tr>
<td></td>
<td><asp:button text="Submit" OnClick="myButton_Click" runat="server" /></td>
</tr>
</table>
Комментарии
Класс UserControl связан с файлами с расширениями ASCX. Эти файлы компилируются во время выполнения как UserControl объекты и кэшируются в памяти сервера.
Вы можете вложить пользовательские элементы управления, объявив один ASCX-файл в другом, включая последний на странице веб-форм.
Пользовательские элементы управления содержатся на страницах веб-форм ASP.NET и предлагают веб-разработчикам простой способ захвата часто используемого веб-интерфейса. Они создаются и кэшируются таким образом, как Page объекты. В отличие от страниц, однако пользовательские элементы управления нельзя вызывать независимо. Их можно вызывать только из страницы или другого пользовательского элемента управления, содержащего их.
Наследуется от этого класса, если вы хотите создать пользовательский элемент управления с помощью метода программной части. Это рекомендуется, если вы разрабатываете страницы веб-форм с помощью этого метода.
Сведения о создании пользовательских элементов управления декларативно см. в ASP.NET пользовательских элементов управления.
Конструкторы
| Имя | Описание |
|---|---|
| UserControl() |
Инициализирует новый экземпляр класса UserControl. |
Свойства
| Имя | Описание |
|---|---|
| Adapter |
Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control) |
| Application |
Application Возвращает объект для текущего веб-запроса. |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control) |
| AppRelativeVirtualPath |
Возвращает или задает путь относительного приложения, виртуального каталога к файлу, из которого элемент управления анализируется и компилируется. (Унаследовано от TemplateControl) |
| Attributes |
Возвращает коллекцию всех пар атрибутов и значений, объявленных в теге пользовательского элемента управления в файле .aspx. |
| AutoHandlers |
Устаревшие..
Свойство AutoHandlers устарело в ASP.NET NET 2.0. Он используется созданными классами и не предназначен для использования в коде. (Унаследовано от TemplateControl) |
| BindingContainer |
Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control) |
| Cache |
Cache Возвращает объект, связанный с приложением, содержащим элемент управления пользователем. |
| CachePolicy |
Возвращает ссылку на коллекцию параметров кэширования для этого пользовательского элемента управления. |
| ChildControlsCreated |
Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control) |
| ClientID |
Возвращает идентификатор элемента управления для разметки HTML, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения ClientID свойства. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID . (Унаследовано от Control) |
| Context |
HttpContext Возвращает объект, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
ControlCollection Возвращает объект, представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от Control) |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer. (Унаследовано от Control) |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl. (Унаследовано от Control) |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control) |
| EnableTheming |
Возвращает или задает логическое значение, указывающее, применяются ли темы к элементу управления, производным TemplateControl от класса. (Унаследовано от TemplateControl) |
| EnableViewState |
Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control) |
| Events |
Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| HasChildViewState |
Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control) |
| ID |
Возвращает или задает программный идентификатор, назначенный элементу управления сервером. (Унаследовано от Control) |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элемента управления. (Унаследовано от Control) |
| IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control) |
| IsPostBack |
Возвращает значение, указывающее, загружается ли элемент управления пользователем в ответ на обратную передачу клиента или когда он загружается и обращается в первый раз. |
| IsTrackingViewState |
Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control) |
| IsViewStateEnabled |
Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control) |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния ID представления вместо индекса. (Унаследовано от Control) |
| NamingContainer |
Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с ID одинаковым значением свойства. (Унаследовано от Control) |
| Page |
Возвращает ссылку на Page экземпляр, содержащий серверный элемент управления. (Унаследовано от Control) |
| Parent |
Возвращает ссылку на родительский элемент управления сервера в иерархии элементов управления страницами. (Унаследовано от Control) |
| RenderingCompatibility |
Возвращает значение, указывающее версию ASP.NET, с которым будет совместим отрисованный HTML. (Унаследовано от Control) |
| Request |
HttpRequest Возвращает объект для текущего веб-запроса. |
| Response |
HttpResponse Возвращает объект для текущего веб-запроса. |
| Server |
HttpServerUtility Возвращает объект для текущего веб-запроса. |
| Session |
HttpSessionState Возвращает объект для текущего веб-запроса. |
| Site |
Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает кожу, применяемую к элементу управления. (Унаследовано от Control) |
| SupportAutoEvents |
Возвращает значение, указывающее, поддерживает ли TemplateControl элемент управления автоматические события. (Унаследовано от TemplateControl) |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| Trace |
TraceContext Возвращает объект для текущего веб-запроса. |
| UniqueID |
Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control) |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control) |
| ViewState |
Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control) |
| Visible |
Возвращает или задает значение, указывающее, отображается ли серверный элемент управления в виде пользовательского интерфейса на странице. (Унаследовано от Control) |
Методы
| Имя | Описание |
|---|---|
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control) |
| AddParsedSubObject(Object) |
Уведомляет серверный элемент управления о том, что элемент , XML или HTML, был проанализирован, и добавляет элемент в объект элемента управления ControlCollection сервера. (Унаследовано от Control) |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
| BeginRenderTracing(TextWriter, Object) |
Начинает трассировку данных отрисовки во время разработки. (Унаследовано от Control) |
| BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и передает его Trace свойству, которое будет отображаться при включении трассировки для страницы. (Унаследовано от Control) |
| ClearCachedClientID() |
Задает кэшированное ClientID значение |
| ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearChildState() |
Удаляет сведения о состоянии представления и состояния элемента управления для всех дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Задает свойство текущего экземпляра элемента управления и всех дочерних элементов управленияInherit. (Унаследовано от Control) |
| Construct() |
Выполняет логику времени разработки. (Унаследовано от TemplateControl) |
| CreateChildControls() |
Вызывается платформой страницы ASP.NET, чтобы уведомить серверные элементы управления, использующие реализацию на основе композиции, чтобы создать все дочерние элементы управления, содержащиеся в подготовке к публикации обратной или отрисовки. (Унаследовано от Control) |
| CreateControlCollection() |
Создает новый ControlCollection объект для хранения дочерних элементов управления (как литерала, так и сервера) элемента управления сервером. (Унаследовано от Control) |
| CreateResourceBasedLiteralControl(Int32, Int32, Boolean) |
Обращается к литеральным строкам, хранящимся в ресурсе. Метод CreateResourceBasedLiteralControl(Int32, Int32, Boolean) не предназначен для использования из кода. (Унаследовано от TemplateControl) |
| DataBind() |
Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления. (Унаследовано от Control) |
| DataBind(Boolean) |
Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления сервера. (Унаследовано от Control) |
| DesignerInitialize() |
Выполняет все шаги инициализации пользовательского элемента управления, необходимые конструкторам RAD. |
| Dispose() |
Позволяет элементу управления сервера выполнять окончательную очистку перед освобождением из памяти. (Унаследовано от Control) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку времени разработки данных отрисовки. (Унаследовано от Control) |
| EnsureChildControls() |
Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления. (Унаследовано от Control) |
| EnsureID() |
Создает идентификатор для элементов управления, которым не назначен идентификатор. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| Eval(String, String) |
Вычисляет выражение привязки данных с помощью указанной строки формата для отображения результата. (Унаследовано от TemplateControl) |
| Eval(String) |
Вычисляет выражение привязки данных. (Унаследовано от TemplateControl) |
| FindControl(String, Int32) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| FindControl(String) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| Focus() |
Задает фокус ввода элементу управления. (Унаследовано от Control) |
| FrameworkInitialize() |
Инициализирует элемент управления, производный TemplateControl от класса. (Унаследовано от TemplateControl) |
| GetDesignModeState() |
Возвращает данные во время разработки для элемента управления. (Унаследовано от Control) |
| GetGlobalResourceObject(String, String, Type, String) |
Возвращает объект ресурса уровня приложения на основе указанных ClassKey и ResourceKey свойств, типа объекта и имени свойства ресурса. (Унаследовано от TemplateControl) |
| GetGlobalResourceObject(String, String) |
Возвращает объект ресурса уровня приложения на основе указанных ClassKey и ResourceKey свойств. (Унаследовано от TemplateControl) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetLocalResourceObject(String, Type, String) |
Возвращает объект ресурса уровня страницы на основе указанного ResourceKey свойства, типа объекта и имени свойства. (Унаследовано от TemplateControl) |
| GetLocalResourceObject(String) |
Возвращает объект ресурса уровня страницы на основе указанного ResourceKey свойства. (Унаследовано от TemplateControl) |
| GetRouteUrl(Object) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(RouteValueDictionary) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, Object) |
Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Получает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetUniqueIDRelativeTo(Control) |
Возвращает префиксированную часть UniqueID свойства указанного элемента управления. (Унаследовано от Control) |
| HasControls() |
Определяет, содержит ли серверный элемент управления какие-либо дочерние элементы управления. (Унаследовано от Control) |
| HasEvents() |
Возвращает значение, указывающее, регистрируются ли события для элемента управления или любых дочерних элементов управления. (Унаследовано от Control) |
| InitializeAsUserControl(Page) |
Инициализирует UserControl объект, созданный декларативно. Так как между страницами и пользовательскими элементами управления существуют некоторые различия, этот метод гарантирует правильное инициализацию пользовательского элемента управления. |
| IsLiteralContent() |
Определяет, содержит ли серверный элемент управления только литеральное содержимое. (Унаследовано от Control) |
| LoadControl(String) |
Control Загружает объект из файла на основе указанного виртуального пути. (Унаследовано от TemplateControl) |
| LoadControl(Type, Object[]) |
Control Загружает объект на основе заданных параметров типа и конструктора. (Унаследовано от TemplateControl) |
| LoadControlState(Object) |
Восстанавливает сведения о состоянии элемента управления из предыдущего запроса страницы, сохраненного методом SaveControlState() . (Унаследовано от Control) |
| LoadTemplate(String) |
Получает экземпляр ITemplate интерфейса из внешнего файла. (Унаследовано от TemplateControl) |
| LoadViewState(Object) |
Восстанавливает сведения о состоянии представления из предыдущего запроса пользовательского элемента управления, сохраненного методом SaveViewState() . |
| MapPath(String) |
Назначает путь к виртуальному файлу ( абсолютный или относительный) физическому пути к файлу. |
| MapPathSecure(String) |
Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| OnAbortTransaction(EventArgs) |
Вызывает событие AbortTransaction. (Унаследовано от TemplateControl) |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие для элемента управления сервером пользовательского интерфейса страницы. (Унаследовано от Control) |
| OnCommitTransaction(EventArgs) |
Вызывает событие CommitTransaction. (Унаследовано от TemplateControl) |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
| OnError(EventArgs) |
Вызывает событие Error. (Унаследовано от TemplateControl) |
| OnInit(EventArgs) |
Вызывает событие Init. |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
| OnPreRender(EventArgs) |
Вызывает событие PreRender. (Унаследовано от Control) |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OpenFile(String) |
Возвращает используемый Stream для чтения файла. (Унаследовано от Control) |
| ParseControl(String, Boolean) |
Анализирует входную строку в Control объект на веб-странице ASP.NET или пользовательском элементе управления. (Унаследовано от TemplateControl) |
| ParseControl(String) |
Анализирует входную строку в Control объект на странице веб-форм или пользовательском элементе управления. (Унаследовано от TemplateControl) |
| RaiseBubbleEvent(Object, EventArgs) |
Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control) |
| ReadStringResource() |
Считывает строковый ресурс. Метод ReadStringResource() не предназначен для использования из кода. (Унаследовано от TemplateControl) |
| RemovedControl(Control) |
Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Отправляет содержимое элемента управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| ResolveAdapter() |
Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет все изменения состояния представления пользовательского элемента управления, которые произошли с момента последней публикации страницы. |
| SetDesignModeState(IDictionary) |
Задает данные во время разработки для элемента управления. (Унаследовано от Control) |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control) |
| SetStringResourcePointer(Object, Int32) |
Задает указатель на строковый ресурс. Метод SetStringResourcePointer(Object, Int32) используется созданными классами и не предназначен для использования из кода. (Унаследовано от TemplateControl) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| TestDeviceFilter(String) |
Возвращает логическое значение, указывающее, применяется ли фильтр устройства к HTTP-запросу. (Унаследовано от TemplateControl) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Вызывает отслеживание изменений состояния представления в серверном элементе управления, чтобы они могли храниться в объекте серверного элемента управления StateBag . Этот объект доступен через ViewState свойство. (Унаследовано от Control) |
| TryUpdateModel<TModel>(TModel, IValueProvider) |
Пытается обновить экземпляр модели, используя значения от поставщика значений. |
| TryUpdateModel<TModel>(TModel) |
Пытается обновить экземпляр модели с помощью значений из элемента управления, привязанного к данным. |
| UpdateModel<TModel>(TModel, IValueProvider) |
Обновляет указанный экземпляр модели, используя значения от поставщика значений пользовательского элемента управления. |
| UpdateModel<TModel>(TModel) |
Обновляет экземпляр модели с помощью значений из элемента управления с привязкой к данным. |
| WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) |
Записывает строку ресурса в HtmlTextWriter элемент управления. Метод WriteUTF8ResourceString(HtmlTextWriter, Int32, Int32, Boolean) используется созданными классами и не предназначен для использования из кода. (Унаследовано от TemplateControl) |
| XPath(String, IXmlNamespaceResolver) |
Вычисляет выражение привязки данных XPath с помощью указанных префиксов и сопоставлений пространств имен для разрешения пространства имен. (Унаследовано от TemplateControl) |
| XPath(String, String, IXmlNamespaceResolver) |
Вычисляет выражение привязки данных XPath с помощью указанных префиксов и сопоставлений пространств имен для разрешения пространства имен и указанной строки формата для отображения результата. (Унаследовано от TemplateControl) |
| XPath(String, String) |
Вычисляет выражение привязки данных XPath с помощью указанной строки формата для отображения результата. (Унаследовано от TemplateControl) |
| XPath(String) |
Вычисляет выражение привязки данных XPath. (Унаследовано от TemplateControl) |
| XPathSelect(String, IXmlNamespaceResolver) |
Вычисляет выражение привязки данных XPath с помощью указанных префиксов и сопоставлений пространств имен для разрешения пространства имен и возвращает коллекцию узлов, реализующую IEnumerable интерфейс. (Унаследовано от TemplateControl) |
| XPathSelect(String) |
Вычисляет выражение привязки данных XPath и возвращает коллекцию узлов, реализующую IEnumerable интерфейс. (Унаследовано от TemplateControl) |
События
| Имя | Описание |
|---|---|
| AbortTransaction |
Происходит, когда пользователь завершает транзакцию. (Унаследовано от TemplateControl) |
| CommitTransaction |
Происходит при завершении транзакции. (Унаследовано от TemplateControl) |
| DataBinding |
Происходит, когда серверный элемент управления привязывается к источнику данных. (Унаследовано от Control) |
| Disposed |
Происходит при освобождении серверного элемента управления из памяти, который является последним этапом жизненного цикла управления сервера при запросе страницы ASP.NET. (Унаследовано от Control) |
| Error |
Возникает при возникновении необработанного исключения. (Унаследовано от TemplateControl) |
| Init |
Происходит при инициализации серверного элемента управления, который является первым шагом в его жизненном цикле. (Унаследовано от Control) |
| Load |
Происходит при загрузке серверного элемента управления в Page объект. (Унаследовано от Control) |
| PreRender |
Происходит после Control загрузки объекта, но до отрисовки. (Унаследовано от Control) |
| Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| IAttributeAccessor.GetAttribute(String) |
Возвращает значение указанного атрибута пользовательского элемента управления. |
| IAttributeAccessor.SetAttribute(String, String) |
Задает значение указанного атрибута пользовательского элемента управления. |
| IControlBuilderAccessor.ControlBuilder |
Описание этого элемента см. в разделе ControlBuilder. (Унаследовано от Control) |
| IControlDesignerAccessor.GetDesignModeState() |
Описание этого элемента см. в разделе GetDesignModeState(). (Унаследовано от Control) |
| IControlDesignerAccessor.SetDesignModeState(IDictionary) |
Описание этого элемента см. в разделе SetDesignModeState(IDictionary). (Унаследовано от Control) |
| IControlDesignerAccessor.SetOwnerControl(Control) |
Описание этого элемента см. в разделе SetOwnerControl(Control). (Унаследовано от Control) |
| IControlDesignerAccessor.UserData |
Описание этого элемента см. в разделе UserData. (Унаследовано от Control) |
| IDataBindingsAccessor.DataBindings |
Описание этого элемента см. в разделе DataBindings. (Унаследовано от Control) |
| IDataBindingsAccessor.HasDataBindings |
Описание этого элемента см. в разделе HasDataBindings. (Унаследовано от Control) |
| IExpressionsAccessor.Expressions |
Описание этого элемента см. в разделе Expressions. (Унаследовано от Control) |
| IExpressionsAccessor.HasExpressions |
Описание этого элемента см. в разделе HasExpressions. (Унаследовано от Control) |
| IFilterResolutionService.CompareFilters(String, String) |
Возвращает значение, указывающее, существует ли связь родительского или дочернего устройства между двумя указанными фильтрами устройств. (Унаследовано от TemplateControl) |
| IFilterResolutionService.EvaluateFilter(String) |
Возвращает значение, указывающее, является ли указанный фильтр типом текущего объекта фильтра. (Унаследовано от TemplateControl) |
| IParserAccessor.AddParsedSubObject(Object) |
Описание этого элемента см. в разделе AddParsedSubObject(Object). (Унаследовано от Control) |
| IUserControlDesignerAccessor.InnerText |
Возвращает или задает текст, отображаемый между открывающим и закрывающим тегами пользовательского элемента управления. |
| IUserControlDesignerAccessor.TagName |
Возвращает или задает полное имя тега пользовательского элемента управления. |
Методы расширения
| Имя | Описание |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Включает поведение динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type, Object) |
Включает поведение динамических данных для указанного элемента управления данными. |
| EnableDynamicData(INamingContainer, Type) |
Включает поведение динамических данных для указанного элемента управления данными. |
| FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными для указанного элемента управления. |
| FindFieldTemplate(Control, String) |
Возвращает шаблон поля для указанного столбца в контейнере именования указанного элемента управления. |
| FindMetaTable(Control) |
Возвращает объект метатабли для содержащего элемента управления данными. |
| GetDefaultValues(INamingContainer) |
Возвращает коллекцию значений по умолчанию для указанного элемента управления данными. |
| GetMetaTable(INamingContainer) |
Возвращает метаданные таблицы для указанного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Задает сопоставление метаданных таблицы и значений по умолчанию для указанного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Задает сопоставление метаданных таблицы и значений по умолчанию для указанного элемента управления данными. |
| SetMetaTable(INamingContainer, MetaTable) |
Задает метаданные таблицы для указанного элемента управления данными. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Определяет, доступны ли метаданные таблицы. |