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

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, чтобы элемент управления TreeView автоматически создавал привязки к узлам дереве; в противном случае — false. Значение по умолчанию — 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 элемент управления использует эти значения вместо автоматически созданных привязок узлов дерева.

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

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

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