Proprietà Shape.Tag

Articolo
10/30/2012

Ottiene o imposta l'oggetto che contiene dati su una un controllo line o.

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: System.Object
Object contenente i dati associati al controllo.l'impostazione predefinita è un riferimento Null (Nothing in Visual Basic).

Note

Qualsiasi tipo derivato da Object la classe può essere assegnata alla proprietà.se Tag la proprietà viene impostata mediante Progettazione Windows Form, solo il testo può essere assegnato.

un utilizzo comune per Tag la proprietà è di archiviare i dati che sono strettamente associati al controllo.Ad esempio, se un controllo line che rappresenta un oggetto in topografia di rete, è possibile archiviare un oggetto DataSet che contengono informazioni su tale oggetto in Tag la proprietà in modo dai dati è possibile accedervi rapidamente.

Esempi

Nell'esempio seguente viene illustrato come utilizzare Tag proprietà per passare un'istanza di un oggetto NodeInfo classe in un nuovo form.Questo esempio presuppone che l'utente abbia a RectangleShape controllare RectangleShape1 denominato in un form, che è un networkForm denominato secondo form e che sono a definita 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 ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.