Поделиться через


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 IListSource
Public 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 значение null.

(Унаследовано от Control)
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)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.

(Унаследовано от HierarchicalDataSourceControl)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску. Эту версию метода FindControl не следует переопределять.

(Унаследовано от Control)
Focus()

Устанавливает фокус ввода на элемент управления.

(Унаследовано от HierarchicalDataSourceControl)
GetDesignModeState()

Возвращает данные времени разработки для элемента управления.

(Унаследовано от Control)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetHierarchicalView(String)

Получает объект представления источника данных для элемента управления XmlDataSource. Значением параметра viewPath может быть выражение XPath.

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)

Определяет, доступны ли метаданные таблицы.

Применяется к

См. также раздел