Proprietà Shape.Tag

Articolo
05/16/2015

Ottiene o imposta l'oggetto che contiene i dati relativi a un controllo Line o Shape.

Spazio dei nomi: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintassi

'Dichiarazione
<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)

Valore proprietà

Tipo: Object
Interfaccia Object che contiene i dati utente associati al controllo.L'impostazione predefinita è un riferimento Null (Nothing in Visual Basic).

Note

Qualsiasi tipo derivato dal Object classe può essere assegnata a questa proprietà. Se il Tag proprietà viene impostata tramite Progettazione Windows Form, è possibile assegnare solo testo.

Un utilizzo comune per la Tag è di proprietà per archiviare dati strettamente associati al controllo. Ad esempio, se si dispone di un controllo di forma che rappresenta un oggetto in una topologia di rete, è possibile archiviare un DataSet che contiene informazioni su tale oggetto nel Tag proprietà accedere ai dati.

Esempi

Nell'esempio seguente viene illustrato come utilizzare il Tag proprietà per passare un'istanza di un NodeInfo classe a un nuovo modulo. Si suppone di disporre di un RectangleShape controllo denominato RectangleShape1 in un form, che si dispone di un secondo form denominato networkForm e che è stato definito un NodeInfo classe nel progetto.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.