TreeNodeBindingCollection Klas

Definitie

Naamruimte:: System.Web.UI.WebControls

Assembly:: System.Web.dll

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.

Vertegenwoordigt een verzameling TreeNodeBinding objecten in het TreeView besturingselement. Deze klasse kan niet worden overgenomen.

public ref class TreeNodeBindingCollection sealed : System::Web::UI::StateManagedCollection

public sealed class TreeNodeBindingCollection : System.Web.UI.StateManagedCollection

type TreeNodeBindingCollection = class
    inherit StateManagedCollection

Public NotInheritable Class TreeNodeBindingCollection
Inherits StateManagedCollection

Overname: Object

StateManagedCollection
TreeNodeBindingCollection

Voorbeelden

Deze sectie bevat twee codevoorbeelden. In het eerste codevoorbeeld ziet u hoe u een TreeNodeBindingCollection object declaratief kunt vullen. In het tweede codevoorbeeld ziet u hoe u een TreeNodeBindingCollection object programmatisch kunt vullen.

In het volgende codevoorbeeld ziet u hoe u een TreeNodeBindingCollection object declaratief kunt vullen. Als dit voorbeeld correct werkt, moet u de XML-gegevens die zich aan het einde van deze sectie bevinden, kopiëren 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>TreeView XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        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 XML Data Binding Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView XML Data Binding Example</h3>
    
      <asp:TreeView id="BookTreeView" 
        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>

In het volgende codevoorbeeld ziet u hoe u een TreeNodeBindingCollection object programmatisch kunt vullen. Als dit voorbeeld correct werkt, moet u de voorbeeld-XML-gegevens die zich aan het einde van deze sectie bevinden, kopiëren 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">
<script runat="server">

  void Page_Load(Object sender, EventArgs e)
  {

    // Create a new TreeView control.
    TreeView NewTree = new TreeView();

    // Set the properties of the TreeView control.
    NewTree.ID = "BookTreeView";
    NewTree.DataSourceID = "BookXmlDataSource";

    // Create the tree node binding relationship.

    // Create the root node binding.
    TreeNodeBinding RootBinding = new TreeNodeBinding();
    RootBinding.DataMember = "Book";
    RootBinding.TextField = "Title";

    // Create the parent node binding.
    TreeNodeBinding ParentBinding = new TreeNodeBinding();
    ParentBinding.DataMember = "Chapter";
    ParentBinding.TextField = "Heading";

    // Create the leaf node binding.
    TreeNodeBinding LeafBinding = new TreeNodeBinding();
    LeafBinding.DataMember = "Section";
    LeafBinding.TextField = "Heading";

    // Add bindings to the DataBindings collection.
    NewTree.DataBindings.Add(RootBinding);
    NewTree.DataBindings.Add(ParentBinding); 
    NewTree.DataBindings.Add(LeafBinding);

    // Manually register the event handler for the SelectedNodeChanged event.
    NewTree.SelectedNodeChanged += new EventHandler(this.Node_Change);

    // Add the TreeView control to the Controls collection of the PlaceHolder control.
    ControlPlaceHolder.Controls.Add(NewTree);

  }

  void Node_Change(Object sender, EventArgs e)
  {

    // Retrieve the TreeView control from the Controls collection of the PlaceHolder control.
    TreeView LocalTree = (TreeView)ControlPlaceHolder.FindControl("BookTreeView");

    // Display the selected node.
    Message.Text = "You selected: " + LocalTree.SelectedNode.Text;

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Constructor Example</h3>
      
      <asp:PlaceHolder id="ControlPlaceHolder" runat="server">
      </asp:PlaceHolder>
   
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      
      <br /><br />
      
      <asp:Label id="Message" 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">
<script runat="server">

  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)

    ' Create a new TreeView control.
    Dim NewTree As New TreeView

    ' Set the properties of the TreeView control.
    NewTree.ID = "BookTreeView"
    NewTree.DataSourceID = "BookXmlDataSource"

    ' Create the tree node binding relationship.

    ' Create the root node binding.
    Dim RootBinding As New TreeNodeBinding
    RootBinding.DataMember = "Book"
    RootBinding.TextField = "Title"

    ' Create the parent node binding.
    Dim ParentBinding As New TreeNodeBinding
    ParentBinding.DataMember = "Chapter"
    ParentBinding.TextField = "Heading"

    ' Create the leaf node binding.
    Dim LeafBinding As New TreeNodeBinding
    LeafBinding.DataMember = "Section"
    LeafBinding.TextField = "Heading"

    ' Add bindings to the DataBindings collection.
    NewTree.DataBindings.Add(RootBinding)
    NewTree.DataBindings.Add(ParentBinding)
    NewTree.DataBindings.Add(LeafBinding)

    ' Manually register the event handler for the SelectedNodeChanged event.
    AddHandler NewTree.SelectedNodeChanged, AddressOf Node_Change

    ' Add the TreeView control to the Controls collection of the PlaceHolder control.
    ControlPlaceHolder.Controls.Add(NewTree)

  End Sub

  Sub Node_Change(ByVal sender As Object, ByVal e As EventArgs)

    ' Retrieve the TreeView control from the Controls collection of the PlaceHolder control.
    Dim LocalTree As TreeView = CType(ControlPlaceHolder.FindControl("BookTreeView"), TreeView)

    ' Display the selected node.
    Message.Text = "You selected: " & LocalTree.SelectedNode.Text

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>TreeView Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>TreeView Constructor Example</h3>
      
      <asp:PlaceHolder id="ControlPlaceHolder" runat="server">
      </asp:PlaceHolder>
   
      <asp:XmlDataSource id="BookXmlDataSource"  
        DataFile="Book.xml"
        runat="server">
      </asp:XmlDataSource>
      
      <br /><br />
      
      <asp:Label id="Message" runat="server"/>
    
    </form>
  </body>
</html>

Hier volgen de XML-gegevens voor de voorgaande codevoorbeelden.

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

Opmerkingen

De TreeNodeBindingCollection klasse wordt gebruikt voor het opslaan en beheren van TreeNodeBinding een verzameling objecten in het TreeView besturingselement. Het TreeView besturingselement gebruikt de klasse voor TreeNodeBindingCollection de DataBindings eigenschap.

De DataBindings eigenschap bevat TreeNodeBinding objecten waarmee de relatie tussen een gegevensitem en het knooppunt waarmee het is verbonden, wordt gedefinieerd. Wanneer u een binding maakt met een gegevensbron waarin elk gegevensitem meerdere eigenschappen bevat (zoals een XML-element met verschillende kenmerken), wordt in een knooppunt standaard de waarde weergegeven die wordt geretourneerd door de ToString methode van het gegevensitem. In het geval van een XML-element geeft het knooppunt de naam van het element weer, waarin de onderliggende structuur van de structuur wordt weergegeven, maar anders niet erg nuttig is. U kunt een knooppunt binden aan een specifieke gegevensitemeigenschap door structuurknooppuntbindingen op te geven. Hoewel de verzameling programmatisch kan worden gevuld, wordt deze DataBindings meestal declaratief ingesteld.

De structuurknooppuntbindingen declaratief instellen:

Nest tags voor openen en sluiten tussen de openings- en sluitingstags <DataBindings> van het TreeView besturingselement.
Plaats <asp:TreeNodeBinding> elementen tussen de openings- en sluittags <DataBindings> voor elke structuurknooppuntbinding die u wilt opgeven.

U kunt een TreeNodeBindingCollection programmatisch beheren door objecten toe te voegen en te verwijderen TreeNodeBinding . Als u een TreeNodeBinding object aan de verzameling wilt toevoegen, gebruikt u de Add of Insert methode. Als u knooppunten uit de verzameling wilt verwijderen, gebruikt u de Removeof RemoveAt StateManagedCollection.Clear methode.

De TreeNodeBindingCollection klasse ondersteunt verschillende manieren om toegang te krijgen tot de items in de verzameling:

Gebruik de Item[] indexeerfunctie om een TreeNode object rechtstreeks op een specifieke op nul gebaseerde index op te halen.
Gebruik de StateManagedCollection.GetEnumerator methode om een enumerator te maken die kan worden gebruikt om de verzameling te herhalen.

Eigenschappen

Name	Description
Count	Hiermee haalt u het aantal elementen op dat in de StateManagedCollection verzameling is opgenomen. (Overgenomen van StateManagedCollection)
Item[Int32]	Hiermee wordt het TreeNodeBinding object opgehaald of ingesteld op de opgegeven index in het TreeNodeBindingCollection object.

Methoden

Name	Description
Add(TreeNodeBinding)	Voegt het opgegeven TreeNodeBinding object toe aan het einde van het TreeNodeBindingCollection object.
Clear()	Hiermee verwijdert u alle items uit de StateManagedCollection verzameling. (Overgenomen van StateManagedCollection)
Contains(TreeNodeBinding)	Bepaalt of het opgegeven TreeNodeBinding object zich in de verzameling bevindt.
CopyTo(Array, Int32)	Kopieert de elementen van de StateManagedCollection verzameling naar een matrix, beginnend bij een bepaalde matrixindex. (Overgenomen van StateManagedCollection)
CopyTo(TreeNodeBinding[], Int32)	Kopieert alle items van het TreeNodeBindingCollection object naar een compatibele eendimensionale matrix van TreeNodeBinding objecten, te beginnen bij de opgegeven index in de doelmatrix.
CreateKnownType(Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, maakt u een exemplaar van een klasse die wordt geïmplementeerd IStateManager. Het type object dat is gemaakt, is gebaseerd op het opgegeven lid van de verzameling die door de GetKnownTypes() methode wordt geretourneerd. (Overgenomen van StateManagedCollection)
Equals(Object)	Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object)
GetEnumerator()	Retourneert een iterator die door de StateManagedCollection verzameling wordt herhaald. (Overgenomen van StateManagedCollection)
GetHashCode()	Fungeert als de standaardhashfunctie. (Overgenomen van Object)
GetKnownTypes()	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u een matrix op met IStateManager typen die de StateManagedCollection verzameling kan bevatten. (Overgenomen van StateManagedCollection)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
IndexOf(TreeNodeBinding)	Bepaalt de index van het opgegeven TreeNodeBinding object in de verzameling.
Insert(Int32, TreeNodeBinding)	Hiermee voegt u het opgegeven TreeNodeBinding object in het TreeNodeBindingCollection object op de opgegeven indexlocatie in.
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
OnClear()	Wanneer deze worden overschreven in een afgeleide klasse, voert u extra werk uit voordat met de Clear() methode alle items uit de verzameling worden verwijderd. (Overgenomen van StateManagedCollection)
OnClearComplete()	Wanneer deze wordt overschreven in een afgeleide klasse, voert u extra werk uit nadat de Clear() methode alle items uit de verzameling heeft verwijderd. (Overgenomen van StateManagedCollection)
OnInsert(Int32, Object)	Wanneer deze wordt overschreven in een afgeleide klasse, voert u extra werk uit voordat de IList.Insert(Int32, Object) of IList.Add(Object) methode een item aan de verzameling toevoegt. (Overgenomen van StateManagedCollection)
OnInsertComplete(Int32, Object)	Wanneer deze wordt overschreven in een afgeleide klasse, voert u extra werk uit nadat de IList.Insert(Int32, Object) of IList.Add(Object) methode een item aan de verzameling heeft toegevoegd. (Overgenomen van StateManagedCollection)
OnRemove(Int32, Object)	Wanneer deze wordt overschreven in een afgeleide klasse, voert u extra werk uit voordat de IList.Remove(Object) of IList.RemoveAt(Int32) methode het opgegeven item uit de verzameling verwijdert. (Overgenomen van StateManagedCollection)
OnRemoveComplete(Int32, Object)	Wanneer deze wordt overschreven in een afgeleide klasse, voert u extra werk uit nadat de IList.Remove(Object) of IList.RemoveAt(Int32) methode het opgegeven item uit de verzameling heeft verwijderd. (Overgenomen van StateManagedCollection)
OnValidate(Object)	Wanneer deze wordt overschreven in een afgeleide klasse, valideert u een element van de StateManagedCollection verzameling. (Overgenomen van StateManagedCollection)
Remove(TreeNodeBinding)	Hiermee verwijdert u het opgegeven TreeNodeBinding object uit het TreeNodeBindingCollection object.
RemoveAt(Int32)	Hiermee verwijdert u het TreeNodeBinding object op de opgegeven indexlocatie uit het TreeNodeBindingCollection object.
SetDirty()	Hiermee dwingt u af dat de volledige StateManagedCollection verzameling wordt geserialiseerd in de weergavestatus. (Overgenomen van StateManagedCollection)
SetDirtyObject(Object)	Wanneer deze wordt overschreven in een afgeleide klasse, geeft u een `object` ingesloten verzameling opdracht om de volledige status op te nemen om de status weer te geven, in plaats van alleen wijzigingsinformatie op te nemen. (Overgenomen van StateManagedCollection)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Expliciete interface-implementaties

Name	Description
ICollection.Count	Hiermee haalt u het aantal elementen op dat in de StateManagedCollection verzameling is opgenomen. (Overgenomen van StateManagedCollection)
ICollection.IsSynchronized	Hiermee wordt een waarde opgehaald die aangeeft of de StateManagedCollection verzameling is gesynchroniseerd (thread safe). Deze methode retourneert `false` in alle gevallen. (Overgenomen van StateManagedCollection)
ICollection.SyncRoot	Hiermee haalt u een object op dat kan worden gebruikt om de toegang tot de StateManagedCollection verzameling te synchroniseren. Deze methode retourneert `null` in alle gevallen. (Overgenomen van StateManagedCollection)
IEnumerable.GetEnumerator()	Retourneert een iterator die door de StateManagedCollection verzameling wordt herhaald. (Overgenomen van StateManagedCollection)
IList.Add(Object)	Voegt een item toe aan de StateManagedCollection verzameling. (Overgenomen van StateManagedCollection)
IList.Clear()	Hiermee verwijdert u alle items uit de StateManagedCollection verzameling. (Overgenomen van StateManagedCollection)
IList.Contains(Object)	Bepaalt of de StateManagedCollection verzameling een specifieke waarde bevat. (Overgenomen van StateManagedCollection)
IList.IndexOf(Object)	Bepaalt de index van een opgegeven item in de StateManagedCollection verzameling. (Overgenomen van StateManagedCollection)
IList.Insert(Int32, Object)	Hiermee voegt u een item toe aan de StateManagedCollection verzameling op de opgegeven index. (Overgenomen van StateManagedCollection)
IList.IsFixedSize	Hiermee wordt een waarde opgehaald die aangeeft of de StateManagedCollection verzameling een vaste grootte heeft. Deze methode retourneert `false` in alle gevallen. (Overgenomen van StateManagedCollection)
IList.IsReadOnly	Hiermee wordt een waarde opgehaald die aangeeft of de StateManagedCollection verzameling het kenmerk Alleen-lezen heeft. (Overgenomen van StateManagedCollection)
IList.Item[Int32]	Hiermee haalt u het IStateManager element op de opgegeven index op. (Overgenomen van StateManagedCollection)
IList.Remove(Object)	Hiermee verwijdert u het eerste exemplaar van het opgegeven object uit de StateManagedCollection verzameling. (Overgenomen van StateManagedCollection)
IList.RemoveAt(Int32)	Hiermee verwijdert u het IStateManager element in de opgegeven index. (Overgenomen van StateManagedCollection)
IStateManager.IsTrackingViewState	Hiermee wordt een waarde opgehaald die aangeeft of de verzameling wijzigingen in de StateManagedCollection weergavestatus opslaat. (Overgenomen van StateManagedCollection)
IStateManager.LoadViewState(Object)	Hiermee herstelt u de eerder opgeslagen weergavestatus van de StateManagedCollection verzameling en de IStateManager items die deze bevat. (Overgenomen van StateManagedCollection)
IStateManager.SaveViewState()	Hiermee worden de wijzigingen in de StateManagedCollection verzameling en elk IStateManager object opgeslagen dat het bevat sinds het moment dat de pagina op de server is geplaatst. (Overgenomen van StateManagedCollection)
IStateManager.TrackViewState()	Hiermee zorgt u ervoor dat de StateManagedCollection verzameling en elk van de IStateManager objecten die deze bevat, wijzigingen in de weergavestatus bijhouden, zodat ze kunnen worden opgeslagen in aanvragen voor dezelfde pagina. (Overgenomen van StateManagedCollection)

Extensiemethoden

Name	Description
AsParallel(IEnumerable)	Hiermee schakelt u parallelle uitvoering van een query in.
AsQueryable(IEnumerable)	Converteert een IEnumerable naar een IQueryable.
Cast<TResult>(IEnumerable)	Cast de elementen van een IEnumerable naar het opgegeven type.
OfType<TResult>(IEnumerable)	Hiermee filtert u de elementen van een IEnumerable op basis van een opgegeven type.

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?