Shape.Tag, propriété

Article
11/15/2012

Obtient ou définit l'objet qui contient des données sur d'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 : System.Object
Object qui contient des données associées avec le contrôle.La valeur par défaut est une référence null (Nothing en Visual Basic).

Notes

Vous pouvez assigner n'importe quel type dérivé de la classe Object à cette propriété.Si la propriété d'Tag est définie via le Concepteur Windows Forms, seul le texte peut être assigné.

La propriété Tag sert souvent à stocker des données étroitement associées au contrôle.Par exemple, si vous avez un contrôle Shape qui représente un objet dans topographie de réseau, vous pouvez enregistrer DataSet qui contient des informations sur cet objet dans la propriété d'Tag donc les données sont accessibles rapidement.

Exemples

L'exemple suivant montre comment utiliser la propriété d'Tag pour passer une instance d'une classe d'NodeInfo à un nouveau formulaire.Cet exemple requiert que vous avez un contrôle d'RectangleShape nommé RectangleShape1 sur un formulaire, que vous avez un networkForm nommé le deuxième par formulaire, et que vous avez défini une classe d'NodeInfo 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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.