Shape.Tag, propriété

Article
05/16/2015

Obtient ou définit l'objet qui contient les données sur un contrôle Line ou Shape.

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
<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)

Valeur de propriété

Type : Object
Object qui contient les données associées au contrôle.La valeur par défaut est une référence null (Nothing en Visual Basic).

Notes

N'importe quel type dérivé de la Object classe peut être affectée à cette propriété. Si le Tag propriété est définie via le Concepteur Windows Forms, seul le texte peut être attribué.

Une utilisation courante de la Tag propriété consiste à stocker des données étroitement associées au contrôle. Par exemple, si vous avez un contrôle de la forme qui représente un objet dans une topographie réseau, vous pourriez stocker un DataSet qui contient des informations relatives à cet objet dans le Tag propriété afin d'accéder rapidement aux données.

Exemples

L'exemple suivant montre comment utiliser le Tag propriété pour passer une instance d'un NodeInfo classe à un nouveau formulaire. Cet exemple suppose que vous disposez d'un RectangleShape contrôle nommé RectangleShape1 sur le formulaire, que vous avez un deuxième formulaire nommé networkForm et que vous avez défini un NodeInfo classe dans votre projet.

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.