Shape.Tag (Propiedad)

Obtiene o establece el objeto que contiene datos sobre un control de línea o forma.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
<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)

Valor de propiedad

Tipo: System.Object
Object que contiene los datos asociados con el control.El valor predeterminado es una referencia nula (Nothing en Visual Basic).

Comentarios

A esta propiedad se le puede asignar cualquier tipo derivado de la clase Object.Si la propiedad de Tag se establece a través de Windows Forms, sólo el texto puede asignar.

Una uso muy común de la propiedad Tag es almacenar datos estrechamente relacionados con el control.Por ejemplo, si tiene un control de forma que representa un objeto en una topografía de red, podría almacenar DataSet que contiene información sobre ese objeto en la propiedad de Tag para que los datos se pueden obtener acceso rápidamente.

Ejemplos

El ejemplo siguiente se muestra cómo utilizar la propiedad de Tag para pasar una instancia de una clase de NodeInfo un nuevo formulario.Este ejemplo requiere tener un control de RectangleShape denominado RectangleShape1 en un formulario, que tiene un networkForm denominado segundo formulario, y que tiene definida una clase de NodeInfo en el proyecto.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.