TreeNodeBinding.Depth Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt de knooppuntdiepte opgehaald of ingesteld waarop het TreeNodeBinding object wordt toegepast.
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 IntegerWaarde van eigenschap
De knooppuntdiepte waarop het TreeNodeBinding object wordt toegepast. De standaardwaarde is -1, waarmee wordt aangegeven dat de Depth eigenschap niet is ingesteld.
- Kenmerken
Voorbeelden
Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u de Depth eigenschap gebruikt om een TreeNodeBinding object toe te passen op een specifieke knooppuntdiepte. Het tweede codevoorbeeld bevat voorbeeld-XML-gegevens voor het eerste codevoorbeeld.
In het volgende codevoorbeeld ziet u hoe u de Depth eigenschap gebruikt om een TreeNodeBinding object toe te passen op een specifieke knooppuntdiepte. Als dit voorbeeld correct werkt, moet u de voorbeeld-XML-gegevens kopiëren, die na dit codevoorbeeld zijn opgegeven, naar een bestand met de naam 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>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>
Het volgende codevoorbeeld bevat voorbeeld-XML-gegevens voor het voorgaande codevoorbeeld.
<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>
Opmerkingen
Een knooppuntdiepte geeft het knooppuntniveau aan dat wordt gebonden. Met de volgende TreeNodeBinding declaratie worden bijvoorbeeld de Name en ID velden van de gegevensbron gekoppeld aan respectievelijk de Text en Value eigenschappen van alle knooppunten met een diepte van 0:
<asp:TreeNodeBinding Depth="0" TextField="Name" ValueField="ID">
Wanneer u een TreeNodeBinding object maakt, moet u de criteria voor binding opgeven. De criteria geven aan wanneer een gegevensitem moet worden gebonden aan een knooppunt. U kunt de Depth of DataMember eigenschap of beide eigenschappen opgeven. Er is een lichte prestatiewinst door beide op te geven.
Zodra de bindingscriteria tot stand zijn gebracht, kunt u vervolgens een eigenschap van een TreeNode object binden dat aan een waarde kan worden gebonden. U kunt een binding maken met een veld van een gegevensitem of met een statische waarde. Wanneer het afhankelijk is van een statische waarde, delen alle TreeNode objecten waarop het TreeNodeBinding object wordt toegepast dezelfde waarde.
De waarde van deze eigenschap wordt opgeslagen in de weergavestatus.
