TreeView.MaxDataBindDepth Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die maximale Anzahl von Strukturebenen ab, die an das TreeView-Steuerelement gebunden werden können, oder legt diese fest.

public:
 property int MaxDataBindDepth { int get(); void set(int value); };

public int MaxDataBindDepth { get; set; }

member this.MaxDataBindDepth : int with get, set

Public Property MaxDataBindDepth As Integer

Eigenschaftswert

Int32

Die maximale Anzahl von Strukturebenen, die an das TreeView-Steuerelement gebunden werden sollen. Der Standardwert ist -1, d. h., alle Strukturebenen in der Datenquelle werden an das Steuerelement gebunden.

Ausnahmen

ArgumentOutOfRangeException

Der ausgewählte Wert ist kleiner als -1.

Beispiele

Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie Sie die MaxDataBindDepth Eigenschaft verwenden, um nur die ersten beiden Knotenebenen (Tiefen 0 und 1) an das TreeView Steuerelement zu binden. Im zweiten Codebeispiel werden Beispiel-XML-Daten für das erste Codebeispiel bereitgestellt.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die MaxDataBindDepth Eigenschaft verwenden, um nur die ersten beiden Knotenebenen (Tiefen 0 und 1) an das TreeView Steuerelement zu binden. Alle Knotenebenen in der Datenquelle werden ignoriert. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die Beispiel-XML-Daten kopieren, die nach diesem Codebeispiel angegeben wurden, in eine Datei mit dem Namen Book.xml.


<%@ 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 MaxDataBindDepth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView MaxDataBindDepth Example</h3>
    
      <asp:TreeView id="BookTreeView"
        MaxDataBindDepth="1"  
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      

    </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 MaxDataBindDepth Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView MaxDataBindDepth Example</h3>
    
      <asp:TreeView id="BookTreeView"
        MaxDataBindDepth="1"  
        DataSourceID="BookXmlDataSource"
        runat="server">
         
        <DataBindings>
          <asp:TreeNodeBinding DataMember="Book" TextField="Title"/>
          <asp:TreeNodeBinding DataMember="Chapter" TextField="Heading"/>
          <asp:TreeNodeBinding DataMember="Section" TextField="Heading"/>
        </DataBindings>
         
      </asp:TreeView>

      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      

    </form>
  </body>
</html>

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

<Book Title="Book Title">
    <Chapter Heading="Chapter 1">
        <Section Heading="Section 1">
        </Section>
        <Section Heading="Section 2">
        </Section>
    </Chapter>
    <Chapter Heading="Chapter 2">
        <Section Heading="Section 1">
        </Section>
    </Chapter>
</Book>

Hinweise

Verwenden Sie beim Binden des TreeView Steuerelements an eine Datenquelle die MaxDataBindDepth Eigenschaft, um die Anzahl der Strukturebenen einzuschränken, um die Bindung an das Steuerelement zu binden. Wenn Sie diese Eigenschaft beispielsweise so festlegen, dass 2 nur der Stammknoten und alle Knoten gebunden werden, die sich unmittelbar unter dem Stammknoten befinden, an das TreeView Steuerelement. Alle verbleibenden Knoten in der Datenquelle werden ignoriert.

Wichtig

Ein böswilliger Benutzer kann eine Rückrufanforderung erstellen und Daten für die Knoten des TreeView Steuerelements abrufen, das der Seitenentwickler nicht anzeigt. Daher müssen die Sicherheit der Daten von der Datenquelle implementiert werden. Verwenden Sie die MaxDataBindDepth Eigenschaft nicht, um Daten auszublenden.

Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.

Gilt für

Siehe auch

ExpandDepth