Udostępnij za pośrednictwem

TreeView.AutoGenerateDataBindings Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia wartość wskazującą, czy kontrolka TreeView automatycznie generuje powiązania węzła drzewa.

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

Wartość właściwości

Boolean

true aby kontrolka TreeView automatycznie generowała powiązania węzła drzewa; w przeciwnym razie false. Wartość domyślna to true.

Przykłady

Ten rozdział zawiera dwa przykłady kodu. W pierwszym przykładzie kodu pokazano, jak wyłączyć automatyczne generowanie powiązań węzła drzewa przez ustawienie AutoGenerateDataBindings właściwości na false. Drugi przykład kodu zawiera przykładowe dane mapy witryny dla pierwszego przykładu kodu.

W poniższym przykładzie kodu pokazano, jak wyłączyć automatyczne generowanie powiązań węzła drzewa przez ustawienie AutoGenerateDataBindings właściwości na false. Następnie DataBindings zdefiniowano kolekcję w celu ustanowienia relacji między elementami danych w kontrolce SiteMapDataSource a węzłami kontrolki TreeView . Aby ten przykład działał poprawnie, należy skopiować przykładowe dane mapy witryny dostarczone po tym przykładzie kodu do pliku o nazwie 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>

Poniższy przykład kodu zawiera przykładowe dane mapy witryny dla poprzedniego przykładu.

<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>

Uwagi

Powiązania węzła drzewa definiują relację między elementem danych a węzłem, z który jest wiązany. W przypadku powiązania ze źródłem danych, w którym każdy element danych zawiera wiele właściwości (takich jak element XML z kilkoma atrybutami), kontrolka TreeView musi wiedzieć, która właściwość elementu danych ma być powiązana z którą TreeNode właściwością. AutoGenerateDataBindings Jeśli właściwość jest ustawiona na truewartość , kontrolka TreeView automatycznie generuje domyślne powiązania węzła drzewa, które ustawiają Text właściwość TreeNode obiektu skojarzonego z powiązaniem z wartością zwracaną przez ToString metodę elementu danych.

Uwaga

Automatycznie generowane powiązania węzła drzewa nie są dodawane do kolekcji DataBindings .

W przypadku elementu XML wartość zwracana przez ToString metodę jest nazwą elementu, która pokazuje podstawową strukturę pliku XML, ale nie jest bardzo przydatna. Aby utworzyć bardziej przydatne drzewo, należy zdefiniować własne powiązania węzła drzewa przez wypełnienie kolekcji DataBindings .

Uwaga

Jeśli zdefiniujesz kolekcję, kontrolka DataBindings TreeView używa tych wartości zamiast automatycznie generowanych powiązań węzła drzewa.

Wartość tej właściwości jest przechowywana w stanie widoku.

Dotyczy

Zobacz też