Sdílet prostřednictvím

TreeView.AutoGenerateDataBindings Vlastnost

  • Reference

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

trueaby TreeView ovládací prvek automaticky vygeneroval vazby stromového uzlu; jinak . false Výchozí formát 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. Kolekce DataBindings se pak definuje tak, aby vytvořila vztah mezi datovými položkami TreeView v ovládacím SiteMapDataSource prvku a uzly 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.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>

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 stromového uzlu definují relaci mezi položkou dat a uzlem, na který je vázán. Při vazbě ke zdroji dat, kde každá položka dat obsahuje více vlastností (například element XML s několika atributy), TreeView musí ovládací prvek zjistit, která vlastnost datové položky má být svázána s jakou TreeNode vlastností. AutoGenerateDataBindings Pokud je vlastnost nastavena 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ě k hodnotě, která je vrácena metodou ToString datové položky.

Poznámka

Do kolekce se nepřidají DataBindings automaticky generované vazby uzlů stromu.

V případě elementu XML je hodnota vrácená ToString metodou název elementu, který zobrazuje základní strukturu souboru XML, ale není velmi užitečné jinak. Chcete-li vytvořit užitečnější strom, je nutné 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é