Бөлісу құралы:

TreeView.DataBindings Свойство

Определение

Пространство имен:
System.Web.UI.WebControls
Сборка:
System.Web.dll

Возвращает коллекцию объектов, определяющих TreeNodeBinding связь между элементом данных и узлом, к которому она привязана.

public:
 property System::Web::UI::WebControls::TreeNodeBindingCollection ^ DataBindings { System::Web::UI::WebControls::TreeNodeBindingCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.TreeNodeBindingCollection DataBindings { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.DataBindings : System.Web.UI.WebControls.TreeNodeBindingCollection
Public ReadOnly Property DataBindings As TreeNodeBindingCollection

Значение свойства

TreeNodeBindingCollection

Объект, TreeNodeBindingCollection представляющий связь между элементом данных и узлом, к которому она привязана.

Атрибуты
PersistenceModeAttribute

Примеры

В этом разделе содержатся два примера кода. В первом примере кода показано, как использовать DataBindings коллекцию для определения связи между элементом данных и узлом, к которому она привязана. Второй пример кода содержит примеры XML-данных для первого примера кода.

В следующем примере кода показано, как использовать DataBindings коллекцию для определения связи между элементом данных и узлом, к которому она привязана. Для правильной работы этого примера необходимо скопировать примеры XML-данных, предоставленных после этого примера кода, в файл с именем Book.xml. В этом примере указывается только DataMember свойство привязки. Можно добавить небольшое повышение производительности, указав Depth свойство.


<%@ 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>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </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>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
    
    </form>
  </body>
</html>

В следующем примере кода приведены примеры XML-данных для предыдущего примера.

<Book Title="Book Title">
    <Chapter Heading="Chapter 1">
        <Section Heading="Section 1">
        </Section>
        <Section Heading="Section 2">
        </Section>
    </Chapter>
    <Chapter Heading="Chapter 2">
        <Section Heading="Section 1">
        </Section>
    </Chapter>
</Book>

Комментарии

Коллекция DataBindings содержит TreeNodeBinding объекты, определяющие связь между элементом данных и узлом, к которому она привязана. При привязке к источнику данных, где каждый элемент данных содержит несколько свойств (например, XML-элемент с несколькими атрибутами), узел отображает значение, возвращаемое методом ToString элемента данных, по умолчанию. В случае XML-элемента узел отображает имя элемента, которое показывает базовую структуру дерева, но не очень полезно в противном случае. Вы можете привязать узел к определенному свойству элемента данных, указав привязки узлов дерева.

При определении связи между элементом данных и узлом необходимо указать как критерии привязки, так и значения для привязки к свойствам TreeNode объекта. Критерии указывают, когда элемент данных должен быть привязан к узлу. Критерии можно указать с глубиной узла, членом данных или обоими. Глубина узла указывает уровень узла, который получает привязку. Например, если указать глубину узла 0, все узлы в структуре дерева на уровне 0 привязаны с помощью привязки узла дерева. Элемент данных указывает тип элемента данных в базовом источнике данных, но может представлять разные сведения в зависимости от источника данных. Например, элемент данных для XML-элемента указывает имя элемента.

Если несколько TreeNodeBinding объектов определены друг с другом, TreeView элемент управления применяет привязки узлов дерева в следующем порядке приоритета:

  1. Объект TreeNodeBinding , определяющий глубину и элемент данных.

  2. Объект TreeNodeBinding , определяющий только глубину.

  3. Объект TreeNodeBinding , определяющий только элемент данных.

  4. Объект TreeNodeBinding , определяющий ни глубину, ни элемент данных.

Если указаны несколько привязок, которые соответствуют одному и тому же критерию приоритета, применяется первая привязка в коллекции.

После установки условий привязки можно привязать свойство TreeNode объекта, которое можно привязать к значению. Можно привязать к атрибуту или полю элемента данных или отобразить статическое значение. Дополнительные сведения о привязке свойств TreeNode объекта к значению см. в разделе TreeNodeBinding.

DataBindings Хотя коллекция может быть программно заполнена, обычно она устанавливается декларативно. Чтобы указать привязки узла дерева, сначала вложенное открытие и закрытие тегов между открывающим и закрывающим <DataBindings> тегами TreeView элемента управления. Затем поместите <asp:TreeNodeBinding> элементы между открывающим и закрывающим <DataBindings> тегами для каждой привязки узла дерева, которую необходимо указать.

Когда привязки данных создаются путем задания AutoGenerateDataBindings свойства TreeView элемента управления true, созданные привязки имеют PopulateOnDemand значение trueсвойства. Привязки данных, созданные декларативно, имеют PopulateOnDemand значение falseсвойства. С помощью декларативного синтаксиса можно управлять поведением отдельных привязок данных.

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

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