TreeView.AutoGenerateDataBindings Свойство

Определение

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

Возвращает или задает значение, указывающее, автоматически ли TreeView элемент управления создает привязки узлов дерева.

public:
 property bool AutoGenerateDataBindings { bool get(); void set(bool value); };
public bool AutoGenerateDataBindings { get; set; }
member this.AutoGenerateDataBindings : bool with get, set
Public Property AutoGenerateDataBindings As Boolean

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

Boolean

Значение />, если элемент управления автоматически создает привязки узлов дерева; в противном случае . Значение по умолчанию — true.

Примеры

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

В следующем примере кода показано, как отключить автоматическое создание привязки узла дерева, задав AutoGenerateDataBindings для свойства значение false. Затем DataBindings коллекция определяется для установления связи между элементами данных в элементе SiteMapDataSource управления и узлами TreeView элемента управления. Для правильной работы этого примера необходимо скопировать примеры данных карты сайта, предоставленные после этого примера кода, в файл с именем Web.sitemap.


<%@ 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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </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 AutoGenerateBindings Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView AutoGenerateBindings Example</h3>
    
      <!-- Set the AutoGenerateBindings property -->
      <!-- to false declaratively to allow for   -->
      <!-- the user-defined Bindings collection. -->
      <asp:TreeView id="SiteTreeView" 
        DataSourceID="SiteMapSource"
        AutoGenerateDataBindings="False"
        runat="server">
        
        <DataBindings>
        
          <asp:TreeNodeBinding TextField="title" NavigateUrlField="url"/>
        
        </DataBindings>
            
      </asp:TreeView>
      
      <asp:SiteMapDataSource ID="SiteMapSource" runat="server"/>
         
    </form>
  </body>
</html>

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

<siteMap>
    <siteMapNode title="Home" description="Home" url="default.aspx">
        <siteMapNode title="Products" description="Products" url="Products.aspx">
            <siteMapNode title="Computers" url="Computers.aspx"/>
            <siteMapNode title="Accessories" url="Accessories.aspx"/>
        </siteMapNode>
    </siteMapNode>
</siteMap>

Комментарии

Привязки узлов дерева определяют связь между элементом данных и узлом, к который он привязан. При привязке к источнику данных, где каждый элемент данных содержит несколько свойств (например, XML-элемент с несколькими атрибутами), элемент управления должен знать, TreeView какое свойство элемента данных необходимо привязать к этому TreeNode свойству. AutoGenerateDataBindings Если для свойства задано trueзначение, TreeView элемент управления автоматически создает привязки узла дерева по умолчанию, которые задают Text свойство TreeNode объекта, связанного с привязкой к значению, возвращаемого методом ToString элемента данных.

Замечание

Автоматически созданные привязки узлов дерева не добавляются в коллекцию DataBindings .

В случае XML-элемента значение, возвращаемое ToString методом, является именем элемента, которое показывает базовую структуру XML-файла, но не очень полезно в противном случае. Чтобы создать более полезное дерево, необходимо определить собственные привязки узлов дерева, заполняя коллекцию DataBindings .

Замечание

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

Значение этого свойства хранится в состоянии представления.

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

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