TreeView.MaxDataBindDepth-Eigenschaft
Assembly: System.Web (in system.web.dll)
/** @property */ public int get_MaxDataBindDepth () /** @property */ public void set_MaxDataBindDepth (int value)
public function get MaxDataBindDepth () : int public function set MaxDataBindDepth (value : int)
Eigenschaftenwert
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.Wenn Sie ein TreeView-Steuerelement an eine Datenquelle binden, begrenzen Sie die Anzahl der an das Steuerelement zu bindenden Strukturebenen mithilfe der MaxDataBindDepth-Eigenschaft. Wenn Sie diese Eigenschaft z. B. auf 2 festlegen, werden nur der Stammknoten sowie alle Knoten direkt unter dem Stammknoten an das TreeView-Steuerelement gebunden. Alle übrigen Knoten in der Datenquelle werden ignoriert.
 Sicherheitshinweis |
|---|
| Böswillige Benutzer können eine Rückrufanforderung erstellen und die Daten für die Knoten des TreeView-Steuerelements abrufen, die der Entwickler der Seite nicht anzeigt. Deshalb muss die Sicherheit der Daten von der Datenquelle implementiert werden. Verwenden Sie nicht die MaxDataBindDepth-Eigenschaft, um Daten auszublenden. |
Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.
Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie mithilfe der MaxDataBindDepth-Eigenschaft nur die ersten beiden Knotenebenen (Tiefe 0 (null) und Tiefe 1) an das TreeView-Steuerelement gebunden werden. Das zweite Codebeispiel enthält Beispiel-XML-Daten für das erste Codebeispiel.
Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der MaxDataBindDepth-Eigenschaft nur die ersten beiden Knotenebenen (Tiefe 0 (null) und Tiefe 1) an das TreeView-Steuerelement gebunden werden. Alle übrigen Knotenebenen in der Datenquelle werden ignoriert. Damit dieses Beispiel wie vorgesehen ausgeführt wird, müssen Sie die Beispiel-XML-Daten, die nach diesem Codebeispiel angegeben werden, in eine Datei mit dem Namen Book.xml kopieren.
<%@ Page Language="C#" %> <html> <body> <form 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>
Das folgende Codebeispiel enthält Beispiel-XML-Daten für das vorherige Codebeispiel.
<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>
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
