TreeView.AutoGenerateDataBindings Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das TreeView-Steuerelement Strukturknotenbindungen automatisch generiert.

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

Eigenschaftswert

Boolean

true, damit das TreeView-Steuerelement automatisch Strukturknotenbindungen generiert, andernfalls false. Der Standardwert ist true.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie die automatische Generierung der Strukturknotenbindung deaktiviert wird, indem die AutoGenerateDataBindings Eigenschaft auf falsefestgelegt wird. Das zweite Codebeispiel stellt Beispielwebsitezuordnungsdaten für das erste Codebeispiel bereit.

Im folgenden Codebeispiel wird veranschaulicht, wie die automatische Generierung der Strukturknotenbindung deaktiviert wird, indem die AutoGenerateDataBindings Eigenschaft auf falsefestgelegt wird. Anschließend wird eine DataBindings Auflistung definiert, um die Beziehung zwischen den Datenelementen in einem SiteMapDataSource Steuerelement und den Knoten des TreeView Steuerelements herzustellen. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-Websitezuordnungsdaten kopieren, die nach diesem Codebeispiel angegeben wurden, in eine Datei mit dem Namen "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>

Im folgenden Codebeispiel werden Beispiel-Websitezuordnungsdaten für das vorherige Beispiel bereitgestellt.

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

Hinweise

Strukturknotenbindungen definieren die Beziehung zwischen einem Datenelement und dem Knoten, an den er gebunden ist. Beim Binden an eine Datenquelle, in der jedes Datenelement mehrere Eigenschaften enthält (z. B. ein XML-Element mit mehreren Attributen), muss das TreeView Steuerelement wissen, welche Datenelementeigenschaft an welche TreeNode Eigenschaft gebunden werden soll. Wenn die AutoGenerateDataBindings Eigenschaft auf true"Festgelegt" festgelegt ist, generiert das TreeView Steuerelement automatisch Standardstrukturknotenbindungen, die die Text Eigenschaft des TreeNode Objekts festlegen, das der Bindung mit dem Wert zugeordnet ist, der von der ToString Methode des Datenelements zurückgegeben wird.

Hinweis

Die automatisch generierten Strukturknotenbindungen werden der DataBindings Auflistung nicht hinzugefügt.

Bei einem XML-Element ist der von der ToString Methode zurückgegebene Wert der Elementname, der die zugrunde liegende Struktur der XML-Datei anzeigt, aber ansonsten nicht sehr nützlich ist. Um eine nützlichere Struktur zu erstellen, müssen Sie Ihre eigenen Strukturknotenbindungen definieren, indem Sie die DataBindings Auflistung auffüllen.

Hinweis

Wenn Sie eine DataBindings Auflistung definieren, verwendet das TreeView Steuerelement diese Werte anstelle automatisch generierter Strukturknotenbindungen.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für

Siehe auch