Shape.Tag-Eigenschaft

Artikel
10/24/2012

Ruft das Objekt ab, das Daten über ein Linien-oder Formsteuerelement enthält.

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

Syntax

'Declaration
<BrowsableAttribute(True)> _
Public Property Tag As Object

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

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

[<BrowsableAttribute(true)>]
member Tag : Object with get, set

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

Eigenschaftswert

Typ: System.Object
Object , das die Daten enthält, die dem Steuerelement zugeordnet sind.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 vom 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.Wenn Sie beispielsweise ein Formsteuerelement haben, dass ein Objekt in einem Netzwerk topographie darstellt, DataSet Sie gespeichert haben, das Informationen über dieses Objekt in der Tag-Eigenschaft enthält, sodass die Daten schnell zugegriffen werden kann.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Tag-Eigenschaft eine Instanz einer NodeInfo-Klasse in einem neuen Formular zu übergeben.Dieses Beispiel setzt voraus, dass Sie ein RectangleShape-Steuerelement mit dem Namen RectangleShape1 in einem Formular, dass Sie ein zweites Formular mit dem Namen networkForm und dass Sie eine NodeInfo-Klasse im Projekt definiert haben.

Private Sub Form1_Load() 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() 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();
}

.NET Framework-Sicherheit

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.