TreeNode.Tag-Eigenschaft

Ruft das Objekt ab, das Daten über den Strukturknoten enthält, oder legt dieses fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
<LocalizableAttribute(False)> _
<BindableAttribute(True)> _
Public Property Tag As Object
'Usage
Dim instance As TreeNode
Dim value As Object

value = instance.Tag

instance.Tag = value

[LocalizableAttribute(false)] 
[BindableAttribute(true)] 
public Object Tag { get; set; }

[LocalizableAttribute(false)] 
[BindableAttribute(true)] 
public:
property Object^ Tag {
    Object^ get ();
    void set (Object^ value);
}

/** @property */
public Object get_Tag ()

/** @property */
public void set_Tag (Object value)

public function get Tag () : Object

public function set Tag (value : Object)

Eigenschaftenwert

Ein Object, das Daten über den Strukturknoten enthält. Der Standardwert ist NULL (Nothing in Visual Basic).

Hinweise

Dieser Eigenschaft kann jeder von Object abgeleitete Typ zugewiesen werden. Wenn diese Eigenschaft mit dem Windows Forms-Designer festgelegt wird, kann nur Text zugewiesen werden.

Beispiel

Im folgenden Codebeispiel wird ein Stammknoten erstellt, dem untergeordnete Strukturknoten zugewiesen werden sollen. Dem Stammknoten wird ein untergeordneter Strukturknoten für jedes Customer-Objekt in einer ArrayList hinzugefügt. Außerdem wird dem Customer-Objekt ein untergeordneter Strukturknoten für jedes Order-Objekt zugeordnet. Das Customer-Objekt wird der Tag-Eigenschaft zugeordnet, und die Strukturknoten, die Customer-Objekte darstellen, werden in Orange-Text angezeigt. Für dieses Beispiel ist es erforderlich, dass ein Customer-Objekt und ein Order-Objekt definiert wurden und dass ein TreeView-Steuerelement in einem Form und eine ArrayList mit der Bezeichnung customerArray mit darin enthaltenen Customer-Objekten vorhanden sind.

Public Sub AddRootNodes()
   ' Add a root node to assign the customer nodes to.
   Dim rootNode As TreeNode
   rootNode = New TreeNode()
   rootNode.Text = "CustomerList"
   ' Add a main root treenode.
   myTreeView.Nodes.Add(rootNode)

   ' Add a root treenode for each Customer object in the ArrayList.
   Dim myCustomer As Customer
   For Each myCustomer In customerArray
      ' Add a child treenode for each Order object.
      Dim i As Integer = 0
      Dim myTreeNodeArray(4) As TreeNode
      Dim myOrder As Order
      For Each myOrder In  myCustomer.CustomerOrders
         myTreeNodeArray(i) = New TreeNode(myOrder.OrderID)
         i += 1
      Next myOrder
      Dim customerNode As New TreeNode(myCustomer.CustomerName, _
        myTreeNodeArray)
      ' Display the customer names with and Orange font.
      customerNode.ForeColor = Color.Orange
      ' Store the Customer object in the Tag property of the TreeNode.
      customerNode.Tag = myCustomer
      myTreeView.Nodes(0).Nodes.Add(customerNode)
   Next myCustomer
End Sub

public void AddRootNodes()
{
   // Add a root node to assign the customer nodes to.
   TreeNode rootNode = new TreeNode();
   rootNode.Text = "CustomerList";
   // Add a main root treenode.
   myTreeView.Nodes.Add(rootNode);

   // Add a root treenode for each 'Customer' object in the ArrayList.
   foreach(Customer myCustomer in customerArray)
   {
      // Add a child treenode for each Order object.
      int i = 0;
      TreeNode[] myTreeNodeArray = new TreeNode[5];
      foreach(Order myOrder in myCustomer.CustomerOrders)
      {
         myTreeNodeArray[i] = new TreeNode(myOrder.OrderID);
         i++;
      }
      TreeNode customerNode = new TreeNode(myCustomer.CustomerName,
        myTreeNodeArray);
        // Display the customer names with and Orange font.
        customerNode.ForeColor = Color.Orange;
        // Store the Customer object in the Tag property of the TreeNode.
        customerNode.Tag = myCustomer;
      myTreeView.Nodes[0].Nodes.Add(customerNode);
   }
}

void AddRootNodes()
{
   
   // Add a root node to assign the customer nodes to.
   TreeNode^ rootNode = gcnew TreeNode;
   rootNode->Text = "CustomerList";
   
   // Add a main root treenode.
   myTreeView->Nodes->Add( rootNode );
   
   // Add a root treenode for each 'Customer' object in the ArrayList.
   IEnumerator^ myEnum = customerArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Customer^ myCustomer = safe_cast<Customer^>(myEnum->Current);
      
      // Add a child treenode for each Order object.
      int i = 0;
      array<TreeNode^>^myTreeNodeArray = gcnew array<TreeNode^>(5);
      IEnumerator^ myEnum = myCustomer->CustomerOrders->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Order^ myOrder = safe_cast<Order^>(myEnum->Current);
         myTreeNodeArray[ i ] = gcnew TreeNode( myOrder->OrderID );
         i++;
      }
      TreeNode^ customerNode = gcnew TreeNode( myCustomer->CustomerName,myTreeNodeArray );
      
      // Display the customer names with and Orange font.
      customerNode->ForeColor = Color::Orange;
      
      // Store the Customer Object* in the Tag property of the TreeNode.
      customerNode->Tag = myCustomer;
      myTreeView->Nodes[ 0 ]->Nodes->Add( customerNode );
   }
}

public void AddRootNodes()
{
    // Add a root node to assign the customer nodes to.
    TreeNode rootNode = new TreeNode();
    rootNode.set_Text("CustomerList");
    // Add a main root treenode.
    myTreeView.get_Nodes().Add(rootNode);
    // Add a root treenode for each 'Customer' object in the ArrayList.
    for (int iCtr1 = 0; iCtr1 < customerArray.get_Count(); iCtr1++) {
        Customer myCustomer = (Customer)customerArray.get_Item(iCtr1);
        // Add a child treenode for each Order object.
        int i = 0;
        TreeNode myTreeNodeArray[] = new TreeNode[5];
        for (int iCtr2 = 0; iCtr2 < myCustomer.customerOrders.get_Count();
            iCtr2++) {
            Order myOrder = (Order)myCustomer.customerOrders.get_Item(iCtr2);
            myTreeNodeArray.set_Item(i, new TreeNode(myOrder.orderID));
            i++;
        }
        TreeNode customerNode =
            new TreeNode(myCustomer.customerName, myTreeNodeArray);
        // Display the customer names with and Orange font.
        customerNode.set_ForeColor(Color.get_Orange());
        // Store the Customer object in the Tag property of the TreeNode.
        customerNode.set_Tag(myCustomer);
        myTreeView.get_Nodes().get_Item(0).get_Nodes().Add(customerNode);
    }
} //AddRootNodes

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, 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.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

TreeNode-Klasse
TreeNode-Member
System.Windows.Forms-Namespace
Object