Shape.Tag-Eigenschaft

Artikel
05/16/2015

Ruft das Objekt ab, das Daten über ein 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

[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: Object
Ein Object , die mit dem Steuerelement verknüpfte Daten enthält.Der Standardwert ist ein NULL-Verweis (Nothing in Visual Basic).

Hinweise

Alle abgeleiteten Typ der Object Klasse kann diese Eigenschaft zugewiesen werden. Wenn die Tag -Eigenschaft über den Windows Forms-Designer festgelegt wird, kann nur Text zugewiesen werden.

Ein typisches Szenario für die Tag Eigenschaft wird zum Speichern von Daten, die eng mit dem Steuerelement zugeordnet ist. Sie z. B., wenn Sie eine Shape-Steuerelement, die ein Objekt in einem Netzwerktopografie darstellt verfügen, möglicherweise speichern ein DataSet , enthält Informationen über das Objekt in der Tag Eigenschaft, sodass die Daten schnell zugegriffen werden können.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die Tag -Eigenschaft übergeben eine Instanz von einer NodeInfo Klasse, um ein neues Formular. In diesem Beispiel benötigen Sie ein RectangleShape -Steuerelement namens RectangleShape1 in einem Formular, Sie haben ein zweites Formular mit dem Namen NetworkForm und definiert haben eine NodeInfo Klasse im Projekt.

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.