TreeView.AutoGenerateDataBindings Vlastnost

Definice

Obor názvů:
System.Web.UI.WebControls
Sestavení:
System.Web.dll

Získá nebo nastaví hodnotu určující, zda TreeView ovládací prvek automaticky generuje vazby stromového uzlu.

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

Hodnota vlastnosti

Boolean

true TreeView mít ovládací prvek automaticky generovat vazby stromového uzlu; jinak , false. Výchozí hodnota je true.

Příklady

Tato část obsahuje dva příklady kódu. První příklad kódu ukazuje, jak zakázat automatické generování vazby uzlu stromu nastavením AutoGenerateDataBindings vlastnosti na false. Druhý příklad kódu poskytuje ukázková data mapy webu pro první příklad kódu.

Následující příklad kódu ukazuje, jak zakázat automatické generování vazby uzlu stromu nastavením AutoGenerateDataBindings vlastnosti na false. DataBindings Kolekce se pak definuje tak, aby vytvořila vztah mezi datovými položkami v ovládacím SiteMapDataSource prvku a uzly TreeView ovládacího prvku. Aby tento příklad fungoval správně, musíte zkopírovat ukázková data mapy webu zadanou po tomto příkladu kódu do souboru s názvem Web.mapa webu.


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

Následující příklad kódu poskytuje ukázková data mapy webu pro předchozí příklad.

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

Poznámky

Vazby uzlu stromu definují vztah mezi datovou položkou a uzlem, ke které je vázán. Při vazbě ke zdroji dat, kde každá datová položka obsahuje více vlastností (například element XML s několika atributy), TreeView musí ovládací prvek vědět, která vlastnost datové položky se má svázat s jakou TreeNode vlastností. Pokud je vlastnost nastavena AutoGenerateDataBindings na true, TreeView ovládací prvek automaticky vygeneruje výchozí vazby stromového uzlu, které nastaví Text vlastnost TreeNode objektu, který je přidružen k vazbě na hodnotu vrácenou metodou ToString datové položky.

Poznámka:

Automaticky generované vazby uzlů stromu se do DataBindings kolekce nepřidají.

V případě elementu XML je hodnota vrácená metodou ToString název elementu, který zobrazuje základní strukturu souboru XML, ale není velmi užitečné jinak. Pokud chcete vytvořit užitečnější strom, musíte definovat vlastní vazby uzlů stromu naplněním DataBindings kolekce.

Poznámka:

Pokud definujete DataBindings kolekci, TreeView ovládací prvek použije tyto hodnoty místo automaticky generovaných vazeb uzlů stromu.

Hodnota této vlastnosti je uložena ve stavu zobrazení.

Platí pro

Viz také