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 свойства элемента управленияtrue, для создаваемых PopulateOnDemand привязок задано значение trueсвойства.TreeView Привязки данных, созданные декларативно, имеют PopulateOnDemand свойство false. Использование декларативного синтаксиса позволяет управлять поведением отдельных привязок данных.

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

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