AdRotator Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отображает рекламный баннер на веб-странице.
public ref class AdRotator : System::Web::UI::WebControls::WebControl
public ref class AdRotator : System::Web::UI::WebControls::DataBoundControl
public class AdRotator : System.Web.UI.WebControls.WebControl
public class AdRotator : System.Web.UI.WebControls.DataBoundControl
type AdRotator = class
inherit WebControl
type AdRotator = class
inherit DataBoundControl
Public Class AdRotator
Inherits WebControl
Public Class AdRotator
Inherits DataBoundControl
- Наследование
- Наследование
Примеры
В следующем примере кода показано, как использовать AdRotator элемент управления для отображения рекламного баннера на веб-странице.
<%@ 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 runat="server">
<title>AdRotator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>AdRotator Example</h3>
<asp:AdRotator id="AdRotator1" runat="server"
Target="_self"
AdvertisementFile="~/App_Data/Ads.xml"/>
</form>
</body>
</html>
<%@ Page Language="VB" 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 runat="server">
<title>AdRotator Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>AdRotator Example</h3>
<asp:AdRotator id="AdRotator1" runat="server"
Target="_self"
AdvertisementFile="~/App_Data/Ads.xml"/>
</form>
</body>
</html>
В следующем примере кода показан формат xml-файла, который содержит сведения об объявлении для предыдущего примера. Дополнительные сведения о формате файла см. в AdvertisementFile разделе Member.
<Advertisements>
<Ad>
<ImageUrl>~/Images/image1.jpg</ImageUrl>
<height>60</height>
<width>190</width>
<NavigateUrl>http://www.microsoft.com</NavigateUrl>
<AlternateText>Microsoft Main Site</AlternateText>
<Impressions>80</Impressions>
<Keyword>Topic1</Keyword>
</Ad>
<Ad>
<ImageUrl>~/Images/image2.jpg</ImageUrl>
<height>90</height>
<width>90</width>
<NavigateUrl>http://www.wingtiptoys.com</NavigateUrl>
<AlternateText>Wingtip Toys</AlternateText>
<Impressions>80</Impressions>
<Keyword>Topic2</Keyword>
</Ad>
</Advertisements>
Комментарии
В этом разделе:
Вступление
AdRotator Используйте элемент управления для отображения случайно выбранного рекламного баннера на веб-странице. Отображаемое объявление изменяется при каждом обновлении страницы.
Сведения об объявлении хранятся в отдельном XML-файле. XML-файл позволяет хранить список объявлений и связанных с ними атрибутов. К атрибутам относятся путь к отображаемого изображения, URL-адрес для ссылки при щелчке элемента управления, альтернативный текст, отображаемый, когда изображение недоступно, ключевое слово и частота объявления. Сведения в этом файле не проверяются элементом AdRotator управления . Чтобы рекламные объявления не выполняли вредоносные сценарии, всегда следует проверка данные перед их выпуском или принимать рекламные сведения только из надежных источников.
Чтобы защитить файл объявления от несанкционированного доступа к Интернету, выполните одно или несколько из следующих действий.
- Сохраните его в каталоге App_Data, который настроен для запрета доступа к Интернету для файлов любого типа.
- Переименуйте файл с расширением, которое не является .xml, и сопоставьте его с расширением
HttpForbiddenHandler
в Web.config. Дополнительные сведения см. вhttpHandlers
разделе файла Machine.config.
В качестве альтернативы XML-файлу в качестве источника данных можно предоставить рекламные сведения с помощью события обратного вызова. Это событие также можно использовать в сочетании с XML-файлом для расширения поведения AdRotator элемента управления, например перенаправления на другую страницу. AdvertisementFile Дополнительные сведения о формате файла см. в свойстве .
Примечание
Если кэширование страниц включено, AdRotator элемент управления не кэшируется. При каждом обновлении веб-страницы выбирается новое объявление. Однако новое объявление не выбрано, если предоставить обработчик событий для AdCreated события.
Формат XML-файла объявления
Элемент AdRotator управления использует отдельный XML-файл объявления для хранения сведений о объявлении, таких как расположение отображаемого изображения и URL-адрес страницы для ссылки. Свойство AdvertisementFileAdRotator элемента управления указывает путь к этому файлу.
При создании файла объявления открывающий и закрывающий <Advertisements>
теги помечают начало и конец файла соответственно. Открывающие и закрывающие <Ad>
теги разделяют каждое объявление. Все объявления вложены между открывающим и закрывающим <Advertisements>
тегами. Если файл содержит несколько <Advertisements>
тегов, элемент управления будет анализировать только первый набор <Advertisements>
тегов AdRotator в файле. Все остальные <Advertisements>
теги будут игнорироваться.
Элементы данных для каждого объявления вложены между открывающим и закрывающим <Ad>
тегами. Хотя некоторые элементы данных являются предопределенными (например, ImageUrl и NavigateUrl), пользовательские элементы можно размещать между <Ad>
тегами. Эти элементы будут считываться элементом AdRotator управления при анализе файла. Затем сведения передаются событию AdCreated в свойстве AdProperties словаря.
В следующей таблице перечислены элементы данных, предопределенные для XML-файла объявления.
Элемент | Описание |
---|---|
ImageUrl |
Абсолютный или относительный URL-адрес файла изображения (необязательно). |
NavigateUrl |
URL-адрес страницы, на который следует ссылаться, если пользователь щелкает объявление (необязательно).
Примечание: Если этот элемент не задан, HRef свойство не отображается в теге привязки. |
Height |
Высота изображения в пикселях (необязательно). |
Width |
Ширина изображения в пикселях (необязательно). |
AlternateText |
Текст отображается вместо изображения, если изображение, указанное свойством ImageUrl , недоступно (необязательно). В некоторых браузерах этот текст также отображается как для ToolTip объявления. |
Keyword |
Категория объявления (например, "компьютеры"), по которому можно отфильтровать (необязательно). |
Impressions |
Число, указывающее важность объявления в расписании ротации относительно других объявлений в файле (необязательно). Чем больше число, тем чаще отображается объявление. Общее количество всех <Impressions> значений в XML-файле не может превышать 2 047 999 999. Если это так, AdRotator элемент управления создает исключение во время выполнения. |
В следующем примере показан формат XML-файла объявления.
<Advertisements>
<Ad>
<ImageUrl>
URL of image to display for Advertisement #1
</ImageUrl>
<NavigateUrl>
URL of page to link to for Advertisement #1
</NavigateUrl>
<AlternateText>
Text to show as a ToolTip for Advertisement #1
</AlternateText>
<Keyword>
Keyword used to filter for Advertisement #1
</Keyword>
<Impressions>
Relative importance of Advertisement #1
</Impressions>
<CustomInformation>
Custom Data about Advertisement #1
</CustomInformation>
</Ad>
</Advertisements>
Декларативный синтаксис
<asp:AdRotator
AccessKey="string"
AdvertisementFile="uri"
AlternateTextField="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
ImageUrlField="string"
KeywordFilter="string"
NavigateUrlField="string"
OnAdCreated="AdCreated event handler"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Target="string|_blank|_parent|_search|_self|_top"
ToolTip="string"
Visible="True|False"
Width="size"
/>
Конструкторы
AdRotator() |
Инициализирует новый экземпляр класса AdRotator. |
Свойства
AccessKey |
Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления. (Унаследовано от WebControl) |
Adapter |
Возвращает конкретный адаптер браузера для элемента управления. (Унаследовано от Control) |
AdvertisementFile |
Получает или задает путь к XML-файлу, содержащему рекламные сведения. |
AlternateTextField |
Получает или задает пользовательское поле данных, используемое для объявления вместо атрибута |
AppRelativeTemplateSourceDirectory |
Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control) |
Attributes |
Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления. (Унаследовано от WebControl) |
BackColor |
Получает или задает цвет фона серверного веб-элемента управления. (Унаследовано от WebControl) |
BindingContainer |
Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control) |
BorderColor |
Возвращает или задает цвет рамки элемента управления Веба. (Унаследовано от WebControl) |
BorderStyle |
Получает или задает стиль границы серверного веб-элемента управления. (Унаследовано от WebControl) |
BorderWidth |
Возвращает или задает ширину границы серверного веб-элемента управления. (Унаследовано от WebControl) |
ChildControlsCreated |
Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления. (Унаследовано от Control) |
ClientID |
Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control) |
ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control) |
ClientIDSeparator |
Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control) |
Context |
Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
Controls |
Возвращает объект ControlCollection, который представляет дочерние элементы управления для указанного элемента управления сервера в иерархии пользовательского интерфейса. (Унаследовано от Control) |
ControlStyle |
Возвращает или задает стиль серверного веб-элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
ControlStyleCreated |
Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle. Этот свойство в основном используется разработчиками элементов управления. (Унаследовано от WebControl) |
CssClass |
Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере. (Унаследовано от WebControl) |
DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control) |
DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control) |
DataMember |
Возвращает или задает имя списка данных, к которому выполняется привязка элемента управления с привязкой к данным, в случае наличия в источнике данных нескольких отдельных списков элементов данных. (Унаследовано от DataBoundControl) |
DataSource |
Получает или задает объект, из которого элемент управления, присоединенный к данным, извлекает свои данные. (Унаследовано от BaseDataBoundControl) |
DataSourceID |
Получает или задает идентификатор элемента управления, из которого элемент управления с привязкой к данным извлекает список элементов данных. (Унаследовано от DataBoundControl) |
DataSourceObject |
Возвращает объект, реализующий интерфейс IDataSource, который предоставляет доступ к содержимому данных объекта. (Унаследовано от DataBoundControl) |
DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки. (Унаследовано от Control) |
Enabled |
Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления. (Унаследовано от WebControl) |
EnableTheming |
Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления. (Унаследовано от WebControl) |
EnableViewState |
Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления. (Унаследовано от Control) |
Events |
Возвращает список делегатов обработчиков событий элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
Font |
Получает свойства шрифта, связанные с элементом управления баннерами. |
ForeColor |
Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления. (Унаследовано от WebControl) |
HasAttributes |
Получает значение, определяющие наличие атрибутов у элемента управления. (Унаследовано от WebControl) |
HasChildViewState |
Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления. (Унаследовано от Control) |
Height |
Получает или задает высоту серверного веб-элемента управления. (Унаследовано от WebControl) |
ID |
Возвращает или задает программный идентификатор, назначенный серверному элементу управления. (Унаследовано от Control) |
IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элементов управления. (Унаследовано от Control) |
ImageUrlField |
Получает или задает пользовательское поле данных, используемое для объявления вместо атрибута |
Initialized |
Получает значение, указывающее, был ли проинициализирован элемент управления, присоединенный к данным. (Унаследовано от BaseDataBoundControl) |
IsBoundUsingDataSourceID |
Получает значение, указывающее, установлено ли свойство DataSourceID. (Унаследовано от BaseDataBoundControl) |
IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления. (Унаследовано от Control) |
IsDataBindingAutomatic |
Получаемое значение указывает, является ли привязка данных автоматической. (Унаследовано от BaseDataBoundControl) |
IsEnabled |
Возвращает значение, определяющее, включен ли элемент управления. (Унаследовано от WebControl) |
IsTrackingViewState |
Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления. (Унаследовано от Control) |
IsUsingModelBinders |
Получает значение, указывающее, используется ли привязка модели. (Унаследовано от DataBoundControl) |
IsViewStateEnabled |
Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления. (Унаследовано от Control) |
ItemType |
Получает или задает имя типа элемента данных для привязки строго типизированных данных. (Унаследовано от DataBoundControl) |
KeywordFilter |
Получает или задает ключевое слово категории для фильтрации по конкретным типам объявлений в XML-файле, содержащем объявления. |
LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса. (Унаследовано от Control) |
NamingContainer |
Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID. (Унаследовано от Control) |
NavigateUrlField |
Получает или задает пользовательское поле данных, используемое для объявления вместо атрибута |
Page |
Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control) |
Parent |
Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы. (Унаследовано от Control) |
RenderingCompatibility |
Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control) |
RequiresDataBinding |
Получает или задает значение, указывающее, должен ли вызываться метод DataBind(). (Унаследовано от BaseDataBoundControl) |
SelectArguments |
Возвращает объект DataSourceSelectArguments, который используется элементом управления с привязкой к данным при извлечении данных из элемента управления источником данных. (Унаследовано от DataBoundControl) |
SelectMethod |
Имя метода, вызываемого для чтения данных. (Унаследовано от DataBoundControl) |
Site |
Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control) |
SkinID |
Возвращает или задает обложку, применяемую к элементу управления. (Унаследовано от WebControl) |
Style |
Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления. (Унаследовано от WebControl) |
SupportsDisabledAttribute |
Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута |
SupportsDisabledAttribute |
Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута |
TabIndex |
Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления. (Унаследовано от WebControl) |
TagKey |
Получает HTML-тег для элемента управления AdRotator. |
TagKey |
Возвращает значение HtmlTextWriterTag, которое соответствует этому элементу управления веб-сервера. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
TagName |
Возвращает имя тега элемента управления. Это свойство используется преимущественно разработчиками элементов управления. (Унаследовано от WebControl) |
Target |
Получает или задает имя окна браузера или фрейма, в которых отображается содержимое веб-страницы, на которую осуществляется переход при щелчке элемента управления AdRotator. |
TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
TemplateSourceDirectory |
Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control) |
ToolTip |
Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления. (Унаследовано от WebControl) |
UniqueID |
Получает уникальный идентификатор элемента управления AdRotator в иерархии. |
UniqueID |
Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control) |
ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений. (Унаследовано от Control) |
ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control) |
ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control) |
ViewStateMode |
Возвращает или задает режим состояния представления данного элемента управления. (Унаследовано от Control) |
Visible |
Получает или задает значение, указывающее, отрисовывается ли серверный элемент управления как пользовательский интерфейс на странице. (Унаследовано от Control) |
Width |
Получает или задает ширину серверного веб-элемента управления. (Унаследовано от WebControl) |
Методы
AddAttributesToRender(HtmlTextWriter) |
Добавляет атрибуты и стили HTML, которые должны быть отображены в указанном элементе управления HtmlTextWriterTag. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
AddedControl(Control, Int32) |
Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control) |
AddParsedSubObject(Object) |
Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection. (Унаследовано от Control) |
ApplyStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля. Этот метод, в основном, используется разработчиками элементов управления. (Унаследовано от WebControl) |
ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
BeginRenderTracing(TextWriter, Object) |
Запускает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control) |
ClearCachedClientID() |
Задает для кэшированного свойства ClientID значение |
ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control) |
ClearChildState() |
Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
ClearEffectiveClientIDMode() |
Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control) |
ConfirmInitState() |
Устанавливает исходное состояние элемента управления, присоединенного к данным. (Унаследовано от BaseDataBoundControl) |
CopyBaseAttributes(WebControl) |
Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
CreateChildControls() |
Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки. (Унаследовано от Control) |
CreateControlCollection() |
Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления. |
CreateControlCollection() |
Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления. (Унаследовано от Control) |
CreateControlStyle() |
Создает объект стиля, который используется внутри класса WebControl для реализации всех относящихся к стилю свойств. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
CreateDataSourceSelectArguments() |
Создает используемый по умолчанию объект DataSourceSelectArguments, применяемый элементом управления с привязкой к данным, если не заданы аргументы. (Унаследовано от DataBoundControl) |
DataBind() |
Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления. (Унаследовано от Control) |
DataBind() |
Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления. (Унаследовано от BaseDataBoundControl) |
DataBind(Boolean) |
Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control) |
DataBindChildren() |
Привязывает источник данных к дочерним элементам управления серверного элемента управления. (Унаследовано от Control) |
Dispose() |
Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control) |
EndRenderTracing(TextWriter, Object) |
Завершает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
EnsureChildControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control) |
EnsureDataBound() |
Вызывает метод DataBind(), если установлено свойство DataSourceID и элемент управления, присоединенный к данным, помечен, как требующий привязки. (Унаследовано от BaseDataBoundControl) |
EnsureID() |
Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
FindControl(String) |
Выполняет поиск серверного элемента управления с заданным параметром |
FindControl(String, Int32) |
Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным |
Focus() |
Задает фокус ввода на элемент управления. (Унаследовано от Control) |
GetData() |
Извлекает объект DataSourceView, используемый элементом управления с привязкой к данным для выполнения операций с данными. (Унаследовано от DataBoundControl) |
GetDataSource() |
Извлекает интерфейс IDataSource, с которым связан элемент управления с привязкой к данным, если таковой существует. (Унаследовано от DataBoundControl) |
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(Control) |
Возвращает часть с префиксом свойства UniqueID указанного элемента управления. (Унаследовано от Control) |
HasControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. (Унаследовано от Control) |
HasEvents() |
Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления. (Унаследовано от Control) |
IsLiteralContent() |
Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control) |
LoadControlState(Object) |
Восстанавливает сведения о состоянии элемента управления предыдущего запроса страницы, сохраненные методом SaveControlState(). (Унаследовано от Control) |
LoadViewState(Object) |
Восстанавливает сведения о состоянии просмотра из предыдущего запроса, сохраненного с помощью метода SaveViewState(). (Унаследовано от WebControl) |
LoadViewState(Object) |
Восстанавливает сведения о состоянии представления из предыдущего запроса страницы, сохраненного методом SaveViewState(). (Унаследовано от DataBoundControl) |
MapPathSecure(String) |
Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control) |
MarkAsDataBound() |
Задает в данных о состоянии представления состояние элемента управления, соответствующее успешной привязке к данным. (Унаследовано от DataBoundControl) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
MergeStyle(Style) |
Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
OnAdCreated(AdCreatedEventArgs) | |
OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы. (Унаследовано от Control) |
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Вызывает событие CreatingModelDataSource. (Унаследовано от DataBoundControl) |
OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
OnDataBound(EventArgs) |
Вызывает событие DataBound. (Унаследовано от BaseDataBoundControl) |
OnDataPropertyChanged() |
Выполняет повторную привязку элемента управления к своим данным после того, как изменилось одно из свойств, идентифицирующих источник данных. (Унаследовано от DataBoundControl) |
OnDataSourceViewChanged(Object, EventArgs) |
Вызывает событие DataSourceViewChanged. (Унаследовано от DataBoundControl) |
OnInit(EventArgs) |
Вызывает событие Init. |
OnInit(EventArgs) |
Вызывает событие Init. (Унаследовано от Control) |
OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
OnLoad(EventArgs) |
Обрабатывает событие Load. (Унаследовано от DataBoundControl) |
OnPagePreLoad(Object, EventArgs) |
Устанавливает исходное состояние элемента управления, привязанного к данным, перед его загрузкой. (Унаследовано от DataBoundControl) |
OnPreRender(EventArgs) |
Получает рекламные сведения для отрисовки путем поиска данных в файле или вызова пользовательского события. |
OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
OpenFile(String) |
Возвращает Stream, используемое для чтения файла. (Унаследовано от Control) |
PerformDataBinding(IEnumerable) |
Привязывает указанный источник данных к элементу управления AdRotator. |
PerformSelect() |
Получает рекламные данные из соответствующего источника данных. |
RaiseBubbleEvent(Object, EventArgs) |
Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control) |
RemovedControl(Control) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
Render(HtmlTextWriter) |
Отображает элемент управления AdRotator на клиентском компьютере. |
RenderBeginTag(HtmlTextWriter) |
Выводит открывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
RenderContents(HtmlTextWriter) |
Выводит содержимое элемента управления в заданный модуль записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
RenderEndTag(HtmlTextWriter) |
Отображает закрывающий HTML-тег элемента управления в указанное средство записи. Этот метод используется в основном разработчиками элементов управления. (Унаследовано от WebControl) |
ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
SaveControlState() |
Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
SaveViewState() |
Сохраняет любое состояние, которое было изменено после вызова метода TrackViewState(). (Унаследовано от WebControl) |
SaveViewState() |
Сохраняет изменения состояния представления, произошедшие с момента обратной отправки страницы на сервер. (Унаследовано от DataBoundControl) |
SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
TrackViewState() |
Заставляет элемент управления отслеживать изменения в состоянии его представления, чтобы их можно было сохранить в свойстве ViewState объекта. (Унаследовано от WebControl) |
TrackViewState() |
Вызывает отслеживание изменений состояния представления элемента управления для сохранения в объекте StateBag элемента управления. (Унаследовано от DataBoundControl) |
ValidateDataSource(Object) |
Проверяет, может ли элемент управления с привязкой к данным, привязываемый к объекту, работать с этим объектом. (Унаследовано от DataBoundControl) |
События
AdCreated |
Происходит один раз за время цикла обращения к серверу после создания элемента управления, но до преобразования страницы для просмотра. |
CallingDataMethods |
Возникает при вызове методов данных. (Унаследовано от DataBoundControl) |
CreatingModelDataSource |
Происходит, когда объект ModelDataSource создается. (Унаследовано от DataBoundControl) |
DataBinding |
Происходит при привязке серверного элемента управления к источнику данных. (Унаследовано от Control) |
DataBound |
Происходит после привязки серверного элемента управления к источнику данных. (Унаследовано от BaseDataBoundControl) |
Disposed |
Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET. (Унаследовано от Control) |
Init |
Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла. (Унаследовано от Control) |
Load |
Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control) |
PreRender |
Происходит после загрузки объекта Control, но перед отрисовкой. (Унаследовано от Control) |
Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
Явные реализации интерфейса
Методы расширения
EnablePersistedSelection(BaseDataBoundControl) |
Устаревшие..
Включает возможность сохранения в элементах управления данными, поддерживающих выделение и разбиение по страницам. |
FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. |
FindFieldTemplate(Control, String) |
Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. |
FindMetaTable(Control) |
Возвращает объект метатаблицы для контейнерного элемента управления данными. |