Shape.Tag-Eigenschaft

Článek
08/23/2008

Aktualisiert: November 2007

Ruft das Objekt ab, das Daten zu einem Line- oder Shape-Steuerelement enthält, oder legt dieses fest.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Property Tag As Object
'Usage
Dim instance As Shape
Dim value As Object

value = instance.Tag

instance.Tag = value

[BrowsableAttribute(true)]
public Object Tag { get; set; }

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

public function get Tag () : Object
public function set Tag (value : Object)

Eigenschaftenwert

Typ: System.Object

Object , das die dem Steuerelement zuzuordnenden Daten enthält. Der Standardwert ist ein NULL-Verweis (Nothing in Visual Basic).

Hinweise

Dieser Eigenschaft kann jeder von der Object-Klasse abgeleitete Typ zugewiesen werden. Wenn die Tag-Eigenschaft über den Windows Forms-Designer festgelegt wird, kann nur Text zugewiesen werden.

Die Tag-Eigenschaft wird häufig zum Speichern von Daten verwendet, die eng mit dem Steuerelement verknüpft sind. Bei einem Shape-Steuerelement, das ein Objekt in einer Netzwerktopografie darstellt, können Sie beispielsweise ein DataSet mit Informationen zu dem Objekt in der Tag-Eigenschaft speichern, sodass ein schneller Zugriff auf die Daten möglich ist.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mit der Tag-Eigenschaft eine Instanz einer NodeInfo-Klasse an ein neues Formular übergeben. Für dieses Beispiel sind ein RectangleShape-Steuerelement mit dem Namen RectangleShape1 auf einem Formular, ein zweites Formular mit dem Namen networkForm und eine definierte NodeInfo-Klasse im Projekt erforderlich.

Private Sub Form1_Load(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) Handles MyBase.Load
    ' Declare an instance of a NodeInfo class.
    Dim MyNode As New NodeInfo
    ' Assign the instance to the Tag property.
    RectangleShape1.Tag = MyNode
End Sub

Private Sub RectangleShape1_Click(ByVal sender As System.Object, _
  ByVal e As System.EventArgs) Handles RectangleShape1.Click
    ' Declare an instance of a networkForm form.
    Dim networkForm As New Form()
    ' Assign the Tag property of the RectangleShape to the new form.
    ' This passes the MyNode instance of the NodeInfo class to the
    ' form.
    networkForm.Tag = RectangleShape1.Tag
    ' Show the new form.
    networkForm.Show()
End Sub

private void Form1_Load(System.Object sender, System.EventArgs e)
{
    // Declare an instance of a NodeInfo class.
    NodeInfo MyNode = new NodeInfo();
    // Assign the instance to the Tag property.
    rectangleShape1.Tag = MyNode;
}

private void rectangleShape1_Click(System.Object sender, System.EventArgs e)
{
    // Declare an instance of a networkForm form.
    Form networkForm = new Form();
    // Assign the Tag property of the RectangleShape to the new form.
    // This passes the MyNode instance of the NodeInfo class to the
    // form.
    networkForm.Tag = rectangleShape1.Tag;
    // Show the new form.
    networkForm.Show();
}

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.