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 , который представляет . Дополнительные сведения о XPath синтаксисе привязки данных и XPathSelect см. в 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
По умолчанию элемент управления загружает все XML-данные в XML-файле, XmlDataSource идентифицируемые свойством DataFile или встроенные в свойстве Data , но вы можете отфильтровать данные с помощью выражения XPath. Свойство XPath поддерживает синтаксический фильтр XPath, который применяется после загрузки и преобразования XML-данных.
Кэширование
Для повышения производительности кэширование включено для XmlDataSource элемента управления по умолчанию. Открытие и чтение XML-файла на сервере при каждом запросе страницы может снизить производительность приложения. Кэширование позволяет снизить нагрузку на обработку на сервере за счет памяти на веб-сервере; в большинстве случаев это хороший компромисс. Автоматически XmlDataSource кэширует данные, если свойству EnableCaching присвоено значение true, а свойству CacheDuration присваивается количество секунд, в течение которых кэш хранит данные до того, как кэш становится недействительным. Можно использовать для CacheExpirationPolicy дальнейшей настройки поведения кэширования в элементе управления источником данных.
Дополнительные функции
В следующей таблице перечислены дополнительные функции, поддерживаемые элементом XmlDataSource управления .
| Функция | Описание: |
|---|---|
| Сортировка | Элемент управления не поддерживается XmlDataSource . |
| Фильтрация | Свойство XPath можно использовать для фильтрации XML-данных с помощью соответствующего выражения XPath. |
| Разбивка на страницы | Элемент управления не поддерживается XmlDataSource . |
| Обновление | Поддерживается путем непосредственного XmlDataDocument управления и последующего Save вызова метода . |
| Удаление | Поддерживается путем непосредственного XmlDataDocument управления и последующего Save вызова метода . |
| Вставка | Поддерживается путем непосредственного XmlDataDocument управления и последующего Save вызова метода . |
| Кэширование | Включено по умолчанию со свойством CacheDuration 0 (бесконечно), а CacheExpirationPolicy для свойства — значение Absolute. |
Объект представления данных
XmlDataSource Так как элемент управления поддерживает элементы управления с привязкой к данным, которые отображают иерархические данные, а также элементы управления, отображающие табличные данные, элемент управления источником данных поддерживает несколько типов объектов представления источников данных в своих базовых XML-данных. Элемент XmlDataSource управления извлекает один именованный XmlDataSourceView объект при использовании с элементом управления с привязкой к данным, который отображает табличные данные. Метод GetViewNames идентифицирует это одно именованное представление. При использовании с элементом управления с привязкой к данным, который отображает иерархические XmlDataSourceXmlHierarchicalDataSourceView данные, элемент управления получает для любого уникального иерархического пути, переданного методу 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-файла (.xsl), который определяет преобразование 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) |
Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от 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) |
Выполняет поиск серверного элемента управления с заданным параметром |
| FindControl(String, Int32) |
Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным |
| 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) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Отправляет содержимое серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает содержимое для отрисовки в клиенте. (Унаследовано от Control) |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от HierarchicalDataSourceControl) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
| ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
| Save() |
Сохраняет на диске данные XML, хранимые в настоящий момент в памяти элементом управления XmlDataSource, если задано свойство DataFile. |
| SaveControlState() |
Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет любые изменения состояния просмотра серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
| SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, 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) |
Определяет, доступны ли метаданные таблицы. |
Применяется к
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по