TreeNodeBinding.Depth Eigenschaft
Definition
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 Knotentiefe ab, in der das TreeNodeBinding-Objekt angewendet wird, oder legt diese fest.
public:
property int Depth { int get(); void set(int value); };[System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public int Depth { get; set; }[System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public int Depth { get; set; }[<System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Depth : int with get, set[<System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.TreeNodeBindingDepthConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Depth : int with get, setPublic Property Depth As IntegerEigenschaftswert
Die Knotentiefe, in der das TreeNodeBinding-Objekt angewendet wird. Der Standardwert ist -1 und bedeutet, dass die Depth-Eigenschaft nicht festgelegt wurde.
- Attribute
Beispiele
Dieser Abschnitt enthält zwei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie die Depth -Eigenschaft verwendet wird, um ein TreeNodeBinding Objekt in einer bestimmten Knotentiefe anzuwenden. Das zweite Codebeispiel enthält XML-Beispieldaten für das erste Codebeispiel.
Im folgenden Codebeispiel wird veranschaulicht, wie die Depth -Eigenschaft verwendet wird, um ein TreeNodeBinding Objekt in einer bestimmten Knotentiefe anzuwenden. Damit dieses Beispiel ordnungsgemäß funktioniert, müssen Sie die XML-Beispieldaten, die nach diesem Codebeispiel bereitgestellt werden, in eine Datei namens Book.xml kopieren.
<%@ 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>TreeViewBinding DataMember and Depth Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeViewBinding DataMember and Depth Example</h3>
<!-- Set the DataMember and Depth properties of a -->
<!-- TreeNodeBinding object declaratively. You -->
<!-- can render items at the same node level -->
<!-- by setting each item's Depth property to -->
<!-- the same value. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book" Depth="0" TextField="Title"/>
<asp:TreeNodeBinding DataMember="Chapter" Depth="1" TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Appendix" Depth="1" 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>TreeViewBinding DataMember and Depth Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>TreeViewBinding DataMember and Depth Example</h3>
<!-- Set the DataMember and Depth properties of a -->
<!-- TreeNodeBinding object declaratively. You -->
<!-- can render items at the same node level -->
<!-- by setting each item's Depth property to -->
<!-- the same value. -->
<asp:TreeView id="BookTreeView"
DataSourceID="BookXmlDataSource"
runat="server">
<DataBindings>
<asp:TreeNodeBinding DataMember="Book" Depth="0" TextField="Title"/>
<asp:TreeNodeBinding DataMember="Chapter" Depth="1" TextField="Heading"/>
<asp:TreeNodeBinding DataMember="Appendix" Depth="1" TextField="Heading"/>
</DataBindings>
</asp:TreeView>
<asp:XmlDataSource id="BookXmlDataSource"
DataFile="Book.xml"
runat="server">
</asp:XmlDataSource>
</form>
</body>
</html>
Das folgende Codebeispiel enthält XML-Beispieldaten für das vorangehende 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>
<Appendix Heading="Appendix A">
</Appendix>
</Book>
Hinweise
Eine Knotentiefe gibt die Knotenebene an, die gebunden wird. Mit der folgenden TreeNodeBinding Deklaration werden beispielsweise die Name Felder und ID der Datenquelle an die Text Eigenschaften und Value aller Knoten mit einer Tiefe von 0 gebunden:
<asp:TreeNodeBinding Depth="0" TextField="Name" ValueField="ID">
Beim Erstellen eines TreeNodeBinding Objekts müssen Sie die Kriterien für die Bindung angeben. Die Kriterien geben an, wann ein Datenelement an einen Knoten gebunden werden soll. Sie können die - oder DataMember -DepthEigenschaft oder beide Eigenschaften angeben. Es gibt einen leichten Leistungsgewinn, wenn beide angegeben werden.
Nachdem die Bindungskriterien festgelegt wurden, können Sie eine Eigenschaft eines TreeNode Objekts binden, die an einen Wert gebunden werden kann. Sie können an ein Feld eines Datenelements oder an einen statischen Wert binden. Wenn sie an einen statischen Wert gebunden sind, verwenden alle TreeNode Objekte, auf die das TreeNodeBinding Objekt angewendet wird, den gleichen Wert.
Der Wert dieser Eigenschaft wird im Ansichtszustand gespeichert.
