XmlDataSource Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет источник данных XML для элементов управления с привязкой к данным.
public ref class XmlDataSource : System::Web::UI::HierarchicalDataSourceControl, System::ComponentModel::IListSource, System::Web::UI::IDataSource[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))]
public class XmlDataSource : System.Web.UI.HierarchicalDataSourceControl, System.ComponentModel.IListSource, System.Web.UI.IDataSource[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))>]
type XmlDataSource = class
inherit HierarchicalDataSourceControl
interface IDataSource
interface IListSourcePublic Class XmlDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource- Наследование
- Атрибуты
- Реализации
Примеры
В этом разделе содержатся два примера кода. В первом примере кода показано, как использовать XmlDataSource элемент управления с элементом TreeView управления для отображения XML-данных из примера XML-файла. Во втором примере показано, как использовать XmlDataSource элемент управления с шаблонным Repeater элементом управления для отображения XML-данных.
В следующем примере кода показано, как использовать XmlDataSource элемент управления с элементом TreeView управления для отображения XML-данных. Загружает XmlDataSource XML-данные из XML-файла, определяемого свойством DataFile .
<%@ Page Language="C#" %>
<!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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</form>
</body>
</html>
XML-файл в примере кода содержит следующие данные:
<books>
<computerbooks>
<book title="Secrets of Silicon Valley" author="Sheryl Hunter"/>
<book title="Straight Talk About Computers" author="Dean Straight"/>
<book title="You Can Combat Computer Stress!" author="Marjorie Green"/>
</computerbooks>
<cookbooks>
<book title="Silicon Valley Gastronomic Treats" author="Innes del Castill"/>
</cookbooks>
</books>
В следующем примере кода показано, как использовать XmlDataSource элемент управления с шаблонным Repeater элементом управления для отображения XML-данных. Элемент Repeater управления использует выражение привязки данных XPath для привязки к элементам данных в XML-документе, который XmlDataSource представляет. Дополнительные сведения о XPathXPathSelect синтаксисе привязки данных см. в XPathBinder классе.
<%@ Page Language="C#" %>
<!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>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
XML-файл в примере кода содержит следующие данные:
<?xml version="1.0" encoding="iso-8859-1"?>
<orders>
<order>
<customer id="12345" />
<customername>
<firstn>John</firstn>
<lastn>Smith</lastn>
</customername>
<transaction id="12345" />
<shipaddress>
<address1>1234 Tenth Avenue</address1>
<city>Bellevue</city>
<state>Washington</state>
<zip>98001</zip>
</shipaddress>
<summary>
<item dept="tools">screwdriver</item>
<item dept="tools">hammer</item>
<item dept="plumbing">fixture</item>
</summary>
</order>
</orders>
Комментарии
В этом разделе:
Введение
Элемент XmlDataSource управления — это элемент управления источниками данных, который предоставляет XML-данные элементам управления с привязкой к данным. Элемент XmlDataSource управления можно использовать элементами управления, привязанными к данным, для отображения иерархических и табличных данных. Элемент XmlDataSource управления обычно используется для отображения иерархических XML-данных в сценариях только для чтения. XmlDataSource Так как элемент управления расширяет HierarchicalDataSourceControl класс, он работает с иерархическими данными. Элемент XmlDataSource управления также реализует IDataSource интерфейс и работает с табличными или списками данных.
Замечание
В целях безопасности ни один из XmlDataSource свойств элемента управления не хранится в состоянии представления. Так как технически можно декодировать содержимое состояния представления на клиенте, хранение конфиденциальной информации о структуре данных или его содержимом может привести к угрозе раскрытия информации. Обратите внимание, что если необходимо хранить такие сведения, как XPath свойство в состоянии представления, можно включить шифрование для защиты содержимого, задав директиву ViewStateEncryptionMode@ Page .
Разработчики страниц используют XmlDataSource элемент управления для отображения XML-данных с помощью элементов управления с привязкой к данным.
Источники XML-данных
Обычно XmlDataSource xml-данные загружаются из XML-файла, указанного свойством DataFile . XML-данные также могут храниться непосредственно элементом управления источниками данных в строковой Data форме с помощью свойства. Если вы хотите преобразовать XML-данные перед отображением элемента управления с привязкой к данным, вы можете предоставить таблицу стилей XSL для преобразования. Как и в случае с XML-данными, обычно загружается таблица стилей из файла, указанная TransformFile свойством, но ее также можно хранить в строковой Transform форме непосредственно с помощью свойства.
Обновление XML-данных
Элемент XmlDataSource управления обычно используется в сценариях данных только для чтения, где элемент управления с привязкой к данным отображает XML-данные. Однако можно также использовать XmlDataSource элемент управления для редактирования XML-данных. Чтобы изменить XML-данные, вызовите GetXmlDocument метод для получения XmlDataDocument объекта, который является представлением XML-данных в памяти. Объектная модель, предоставленная XmlDataDocument объектами, XmlNode содержащимися в документе, или использовать выражение фильтрации XPath для управления данными в документе. При внесении изменений в представление XML-данных в памяти его можно сохранить на диск, вызвав Save метод.
Существуют некоторые ограничения для возможностей редактирования XmlDataSource элемента управления:
XML-данные должны быть загружены из XML-файла, указанного свойством DataFile , а не из встроенного XML, указанного в свойстве Data .
Преобразование XSLT не может быть указано в Transform или TransformFile свойствах.
Метод Save не обрабатывает одновременные операции сохранения различными запросами. Если через XML-файл XmlDataSourceредактируется несколько пользователей, все пользователи работают с одинаковыми данными. Кроме того, операция может завершиться ошибкой Save из-за таких же проблем параллелизма.
Указание преобразования XSL
Общая операция, выполняемая с XML-данными, преобразует ее из одного набора данных XML в другой. Элемент XmlDataSource управления поддерживает преобразования XML с Transform свойствами, TransformFile которые указывают таблицу стилей XSL для применения к XML-данным перед передачей в элемент управления с привязкой к данным и TransformArgumentList свойство, которое позволяет предоставлять динамические аргументы таблицы стилей XSLT, которые будут использоваться таблицей стилей XSL во время преобразования. Если указать выражение фильтрации XPath с помощью XPath свойства, оно применяется после преобразования.
Замечание
Класс XmlDataSource использует устаревший XslTransform класс для выполнения преобразований XSL. Если вы хотите использовать функции таблицы стилей, которые были представлены после XslTransform отмены класса, примените преобразования вручную с помощью XslCompiledTransform класса.
Фильтрация с помощью выражения XPath
По умолчанию XmlDataSource элемент управления загружает все XML-данные в XML-файле, определяемом DataFile свойством или найденным встроенным в Data свойстве, но вы можете фильтровать данные с помощью выражения XPath. Свойство XPath поддерживает фильтр синтаксиса XPath, который применяется после загрузки и преобразования XML-данных.
Кэширование
Для повышения производительности кэширование по умолчанию включено для XmlDataSource элемента управления. Открытие и чтение XML-файла на сервере при каждом запросе страницы может снизить производительность приложения. Кэширование позволяет снизить нагрузку на обработку на сервере за счет памяти на веб-сервере; В большинстве случаев это хороший компромисс. Автоматически XmlDataSource кэширует данные, если EnableCaching для свойства задано trueзначение , а CacheDuration свойство устанавливается на количество секунд, в течение которых кэш сохраняет данные до того, как кэш будет недопустим. Вы можете использовать CacheExpirationPolicy для дальнейшего точного настройки поведения кэширования элемента управления версиями данных.
Дополнительные функции
В следующей таблице перечислены дополнительные функции, поддерживаемые элементом XmlDataSource управления.
| Функциональность | Описание |
|---|---|
| Сортировка | Не поддерживается элементом XmlDataSource управления. |
| Фильтрация | Свойство XPath можно использовать для фильтрации XML-данных с помощью соответствующего выражения XPath. |
| Paging | Не поддерживается элементом XmlDataSource управления. |
| Обновление | Поддерживается путем управления XmlDataDocument напрямую, а затем вызовом Save метода. |
| Удаление | Поддерживается путем управления XmlDataDocument напрямую, а затем вызовом Save метода. |
| Вставка | Поддерживается путем управления XmlDataDocument напрямую, а затем вызовом Save метода. |
| Кэширование | Включен по умолчанию со свойством CacheDuration , равным 0 (бесконечно) и свойству CacheExpirationPolicy , равным Absolute. |
Объект представления данных
Так как элемент XmlDataSource управления поддерживает элементы управления с привязкой к данным, которые отображают иерархические данные, а также элементы управления, отображающие табличные данные, элемент управления источником данных поддерживает несколько типов объектов представления источников данных на своих базовых XML-данных. Элемент XmlDataSource управления получает один именованный XmlDataSourceView объект при использовании с элементом управления с привязкой к данным, отображающим табличные данные. Метод GetViewNames определяет это одно именованное представление. При использовании с элементом управления с привязкой к данным, отображающим иерархические данные, XmlDataSource элемент управления извлекает XmlHierarchicalDataSourceView любой уникальный иерархический путь, переданный методу GetHierarchicalView .
Декларативный синтаксис
<asp:XmlDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
DataFile="string"
EnableCaching="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnTransforming="Transforming event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
TransformArgumentList="string"
TransformFile="string"
Visible="True|False"
XPath="string"
>
<Data>string</Data>
<Transform>string</Transform>
</asp:XmlDataSource>
Конструкторы
| Имя | Описание |
|---|---|
| XmlDataSource() |
Создает новый экземпляр XmlDataSource класса. |
Свойства
| Имя | Описание |
|---|---|
| Adapter |
Возвращает адаптер, зависящий от браузера, для элемента управления. (Унаследовано от Control) |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительный к приложению виртуальный каталог Page объекта или UserControl объекта, содержащего этот элемент управления. (Унаследовано от Control) |
| BindingContainer |
Возвращает элемент управления, содержащий привязку данных этого элемента управления. (Унаследовано от Control) |
| CacheDuration |
Возвращает или задает продолжительность времени (в секундах), в течение которого элемент управления источниками данных кэширует полученные данные. |
| CacheExpirationPolicy |
Возвращает или задает политику истечения срока действия кэша, которая объединяется с длительностью кэша для описания поведения кэширования кэша, который использует элемент управления версиями данных. |
| CacheKeyContext |
Возвращает или задает значение ключа кэша для элемента управления источником данных из состояния представления или добавляет ключ кэша для просмотра состояния. |
| CacheKeyDependency |
Возвращает или задает определяемую пользователем зависимость ключа, связанную со всеми объектами кэша данных, созданными элементом управления источником данных. Все объекты кэша явно истекают, когда срок действия ключа истекает. |
| ChildControlsCreated |
Возвращает значение, указывающее, были ли созданы дочерние элементы управления сервера. (Унаследовано от Control) |
| ClientID |
Возвращает идентификатор элемента управления сервера, созданный ASP.NET. (Унаследовано от HierarchicalDataSourceControl) |
| ClientIDMode |
Это свойство не используется для элементов управления источниками данных. (Унаследовано от HierarchicalDataSourceControl) |
| ClientIDSeparator |
Возвращает значение символа, представляющее символ разделителя, используемый в свойстве ClientID . (Унаследовано от Control) |
| Context |
HttpContext Возвращает объект, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
ControlCollection Возвращает объект, представляющий дочерние элементы управления для указанного серверного элемента управления в иерархии пользовательского интерфейса. (Унаследовано от HierarchicalDataSourceControl) |
| Data |
Возвращает или задает блок XML-данных, к которым привязывается элемент управления источниками данных. |
| DataFile |
Указывает имя файла XML-файла, к которому привязывается источник данных. |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer. (Унаследовано от Control) |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl. (Унаследовано от Control) |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности конструктора. (Унаследовано от Control) |
| EnableCaching |
Возвращает или задает значение, указывающее, включен ли XmlDataSource элемент управления кэширование данных. |
| EnableTheming |
Возвращает значение, указывающее, поддерживает ли этот элемент управления темы. (Унаследовано от HierarchicalDataSourceControl) |
| EnableViewState |
Возвращает или задает значение, указывающее, сохраняет ли серверный элемент управления состояние представления и состояние представления всех дочерних элементов управления, содержащихся в нем, для запрашивающего клиента. (Унаследовано от Control) |
| Events |
Возвращает список делегатов обработчика событий для элемента управления. Это свойство доступно только для чтения. (Унаследовано от Control) |
| HasChildViewState |
Получает значение, указывающее, имеют ли дочерние элементы управления текущего элемента управления серверным элементом управления какие-либо сохраненные параметры состояния представления. (Унаследовано от Control) |
| ID |
Возвращает или задает программный идентификатор, назначенный элементу управления сервером. (Унаследовано от Control) |
| IdSeparator |
Возвращает символ, используемый для разделения идентификаторов элемента управления. (Унаследовано от Control) |
| IsChildControlStateCleared |
Возвращает значение, указывающее, имеют ли элементы управления, содержащиеся в этом элементе управления, состояние элемента управления. (Унаследовано от Control) |
| IsTrackingViewState |
Возвращает значение, указывающее, сохраняется ли серверная система управления изменениями в состоянии представления. (Унаследовано от Control) |
| IsViewStateEnabled |
Возвращает значение, указывающее, включено ли состояние представления для этого элемента управления. (Унаследовано от Control) |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния ID представления вместо индекса. (Унаследовано от Control) |
| NamingContainer |
Возвращает ссылку на контейнер именования серверного элемента управления, который создает уникальное пространство имен для различения между элементами управления сервера с ID одинаковым значением свойства. (Унаследовано от Control) |
| Page |
Возвращает ссылку на Page экземпляр, содержащий серверный элемент управления. (Унаследовано от Control) |
| Parent |
Возвращает ссылку на родительский элемент управления сервера в иерархии элементов управления страницами. (Унаследовано от Control) |
| RenderingCompatibility |
Возвращает значение, указывающее версию ASP.NET, с которым будет совместим отрисованный HTML. (Унаследовано от Control) |
| Site |
Получает сведения о контейнере, на котором размещается текущий элемент управления при отрисовки на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает кожу, применяемую к элементу HierarchicalDataSourceControl управления. (Унаследовано от HierarchicalDataSourceControl) |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный Page каталог или UserControl содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| Transform |
Возвращает или задает блок данных расширяемого языка таблицы стилей (XSL), определяющих преобразование XSLT, выполняемое для XML-данных, управляемых элементом XmlDataSource управления. |
| TransformArgumentList |
Предоставляет список аргументов XSLT, которые используются с таблицей стилей, определенной Transform или TransformFile свойствами для выполнения преобразования данных XML. |
| TransformFile |
Указывает имя файла расширяемого языка таблицы стилей (XSL), который определяет преобразование XSLT, которое определяет преобразование XSLT, выполняемое для XML-данных, управляемых элементом XmlDataSource управления. |
| UniqueID |
Возвращает уникальный иерархический идентификатор для элемента управления сервером. (Унаследовано от Control) |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления входные данные клиента из браузера для потенциально опасных значений. (Унаследовано от Control) |
| ViewState |
Получает словарь сведений о состоянии, позволяющий сохранять и восстанавливать состояние представления серверного элемента управления в нескольких запросах на одну и ту же страницу. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли StateBag объект нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления этого элемента управления. (Унаследовано от Control) |
| Visible |
Возвращает или задает значение, указывающее, отображается ли элемент управления визуально. (Унаследовано от HierarchicalDataSourceControl) |
| XPath |
Указывает выражение XPath, которое будет применяться к XML-данным, содержащимся Data свойством или XML-файлом, указанным свойством DataFile . |
Методы
| Имя | Описание |
|---|---|
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control) |
| AddParsedSubObject(Object) |
Уведомляет серверный элемент управления о том, что элемент , XML или HTML, был проанализирован, и добавляет элемент в объект элемента управления ControlCollection сервера. (Унаследовано от Control) |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от HierarchicalDataSourceControl) |
| BeginRenderTracing(TextWriter, Object) |
Начинает трассировку данных отрисовки во время разработки. (Унаследовано от Control) |
| BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и передает его Trace свойству, которое будет отображаться при включении трассировки для страницы. (Унаследовано от Control) |
| ClearCachedClientID() |
Задает кэшированное ClientID значение |
| ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearChildState() |
Удаляет сведения о состоянии представления и состояния элемента управления для всех дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов управления сервера. (Унаследовано от Control) |
| ClearEffectiveClientIDMode() |
ClientIDMode Задает свойство текущего экземпляра элемента управления и всех дочерних элементов управленияInherit. (Унаследовано от Control) |
| CreateChildControls() |
Вызывается платформой страницы ASP.NET, чтобы уведомить серверные элементы управления, использующие реализацию на основе композиции, чтобы создать все дочерние элементы управления, содержащиеся в подготовке к публикации обратной или отрисовки. (Унаследовано от Control) |
| CreateControlCollection() |
Создает новый ControlCollection объект для хранения дочерних элементов управления (как литерала, так и сервера) элемента управления сервером. (Унаследовано от HierarchicalDataSourceControl) |
| DataBind() |
Привязывает источник данных к вызываемой серверной системе управления и всем дочерним элементам управления. (Унаследовано от Control) |
| DataBind(Boolean) |
Привязывает источник данных к вызываемой серверной системе управления и всем его дочерним элементам управления с возможностью вызвать DataBinding событие. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления сервера. (Унаследовано от Control) |
| Dispose() |
Позволяет элементу управления сервера выполнять окончательную очистку перед освобождением из памяти. (Унаследовано от Control) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку времени разработки данных отрисовки. (Унаследовано от Control) |
| EnsureChildControls() |
Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления. (Унаследовано от Control) |
| EnsureID() |
Создает идентификатор для элементов управления, которым не назначен идентификатор. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindControl(String, Int32) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| FindControl(String) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| Focus() |
Задает фокус ввода для элемента управления. (Унаследовано от HierarchicalDataSourceControl) |
| GetDesignModeState() |
Возвращает данные во время разработки для элемента управления. (Унаследовано от Control) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetHierarchicalView(String) |
Возвращает объект представления источника данных для XmlDataSource элемента управления. Параметр |
| 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) |
| GetXmlDocument() |
Загружает XML-данные в память либо непосредственно из базового хранилища данных, либо из кэша, и возвращает его в виде XmlDataDocument объекта. |
| HasControls() |
Определяет, содержит ли серверный элемент управления какие-либо дочерние элементы управления. (Унаследовано от HierarchicalDataSourceControl) |
| HasEvents() |
Возвращает значение, указывающее, регистрируются ли события для элемента управления или любых дочерних элементов управления. (Унаследовано от Control) |
| IsLiteralContent() |
Определяет, содержит ли серверный элемент управления только литеральное содержимое. (Унаследовано от Control) |
| LoadControlState(Object) |
Восстанавливает сведения о состоянии элемента управления из предыдущего запроса страницы, сохраненного методом SaveControlState() . (Унаследовано от Control) |
| LoadViewState(Object) |
Восстанавливает сведения о состоянии представления из предыдущего запроса страницы, сохраненного методом SaveViewState() . (Унаследовано от Control) |
| MapPathSecure(String) |
Извлекает физический путь, с которым сопоставляется виртуальный путь( абсолютный или относительный). (Унаследовано от Control) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие для элемента управления сервером пользовательского интерфейса страницы. (Унаследовано от Control) |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
| OnDataSourceChanged(EventArgs) |
Вызывает событие DataSourceChanged. (Унаследовано от HierarchicalDataSourceControl) |
| OnInit(EventArgs) |
Вызывает событие Init. (Унаследовано от Control) |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
| OnPreRender(EventArgs) |
Вызывает событие PreRender. (Унаследовано от Control) |
| OnTransforming(EventArgs) |
Transforming Вызывает событие, прежде чем XmlDataSource элемент управления выполняет преобразование XSLT для данных XML. |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OpenFile(String) |
Возвращает используемый Stream для чтения файла. (Унаследовано от Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Назначает любые источники события и ее сведения родительскому элементу управления. (Унаследовано от Control) |
| RemovedControl(Control) |
Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Отправляет содержимое элемента управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от HierarchicalDataSourceControl) |
| ResolveAdapter() |
Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control) |
| Save() |
Сохраняет XML-данные, которые в настоящее время хранятся в памяти XmlDataSource элементом управления, на диск, если DataFile свойство задано. |
| SaveControlState() |
Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет все изменения состояния представления представления сервера, которые произошли с момента отправки страницы на сервер. (Унаследовано от Control) |
| SetDesignModeState(IDictionary) |
Задает данные во время разработки для элемента управления. (Унаследовано от Control) |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Вызывает отслеживание изменений состояния представления в серверном элементе управления, чтобы они могли храниться в объекте серверного элемента управления StateBag . Этот объект доступен через ViewState свойство. (Унаследовано от Control) |
События
| Имя | Описание |
|---|---|
| DataBinding |
Происходит, когда серверный элемент управления привязывается к источнику данных. (Унаследовано от Control) |
| Disposed |
Происходит при освобождении серверного элемента управления из памяти, который является последним этапом жизненного цикла управления сервера при запросе страницы ASP.NET. (Унаследовано от Control) |
| Init |
Происходит при инициализации серверного элемента управления, который является первым шагом в его жизненном цикле. (Унаследовано от Control) |
| Load |
Происходит при загрузке серверного элемента управления в Page объект. (Унаследовано от Control) |
| PreRender |
Происходит после Control загрузки объекта, но до отрисовки. (Унаследовано от Control) |
| Transforming |
Происходит до того, как таблица стилей определяется свойством Transform или определяется TransformFile свойством, применяется к XML-данным. |
| Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| 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) |
| IDataSource.DataSourceChanged |
Описание этого элемента см. в разделе DataSourceChanged. |
| IDataSource.GetView(String) |
Возвращает именованное представление источника данных, связанное с элементом управления версиями данных. |
| IDataSource.GetViewNames() |
Описание этого элемента см. в разделе GetViewNames(). |
| IExpressionsAccessor.Expressions |
Описание этого элемента см. в разделе Expressions. (Унаследовано от Control) |
| IExpressionsAccessor.HasExpressions |
Описание этого элемента см. в разделе HasExpressions. (Унаследовано от Control) |
| IHierarchicalDataSource.DataSourceChanged |
Происходит при изменении определенного HierarchicalDataSourceControl изменения, влияющего на элементы управления с привязкой к данным. (Унаследовано от HierarchicalDataSourceControl) |
| IHierarchicalDataSource.GetHierarchicalView(String) |
Возвращает вспомогательный объект представления для IHierarchicalDataSource интерфейса для указанного пути. (Унаследовано от HierarchicalDataSourceControl) |
| IListSource.ContainsListCollection |
Описание этого элемента см. в разделе ContainsListCollection. |
| IListSource.GetList() |
Описание этого элемента см. в разделе GetList(). |
| IParserAccessor.AddParsedSubObject(Object) |
Описание этого элемента см. в разделе AddParsedSubObject(Object). (Унаследовано от Control) |
Методы расширения
| Имя | Описание |
|---|---|
| FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными для указанного элемента управления. |
| FindFieldTemplate(Control, String) |
Возвращает шаблон поля для указанного столбца в контейнере именования указанного элемента управления. |
| FindMetaTable(Control) |
Возвращает объект метатабли для содержащего элемента управления данными. |
| GetDefaultValues(IDataSource) |
Возвращает коллекцию значений по умолчанию для указанного источника данных. |
| GetMetaTable(IDataSource) |
Возвращает метаданные таблицы в указанном объекте источника данных. |
| TryGetMetaTable(IDataSource, MetaTable) |
Определяет, доступны ли метаданные таблицы. |
