Propriedade Shape.Tag

Artigo
10/26/2012

Obtém ou define o objeto que contém dados sobre um controle de linha ou forma.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
<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 propriedade

Tipo: System.Object
Um Object que contém os dados associados com o controle.O padrão é uma referência nula (Nothing na Visual Basic).

Comentários

Qualquer tipo derivado de Object classe pode ser atribuído a essa propriedade.Se a Tag propriedade é definida por meio do Windows Forms Designer, pode ser atribuído apenas texto.

Um uso comum para o Tag é de propriedade armazenar dados que está intimamente associados ao controle.Por exemplo, se você tiver um controle de forma que representa um objeto em uma topografia de rede, você pode armazenar um DataSet que contém informações sobre o objeto do Tag propriedade para que os dados podem ser acessados rapidamente.

Exemplos

O exemplo a seguir demonstra como usar o Tag propriedade para passar uma instância de um NodeInfo classe para um novo formulário.Este exemplo requer que você tenha um RectangleShape controle denominado RectangleShape1 em um formulário que você tem um segundo formulário chamado networkForm e que você tenha definido um NodeInfo classe em seu projeto.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.