Propriedade Shape.Tag

Artigo
08/25/2010

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

<BrowsableAttribute(True)> _
Public Property Tag As Object

Dim instance As Shape
Dim value As Object

value = instance.Tag

instance.Tag = value

[BrowsableAttribute(true)]
public Object Tag { get; set; }

[BrowsableAttribute(true)]
public:
property Object^ Tag {
    Object^ get ();
    void set (Object^ value);
}

public function get Tag () : Object
public function set Tag (value : Object)

Valor de propriedade

Tipo: System.Object
An Object que contém dados associados ao controle. O padrão é uma referência nula (Nothing em Visual Basic).

Comentários

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

Um uso comum para o Tag propriedade é armazenar dados que está intimamente associados ao controle. Por exemplo, se você tiver um controle de forma que representa um objeto em uma rede topografia, você pode armazenar um DataSet que contém informações sobre esse objeto a 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 a um novo formulário. Este exemplo requer que você tenha um RectangleShape controle chamado 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.

PrivateSub Form1_Load(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) HandlesMyBase.Load
    ' Declare an instance of a NodeInfo class.Dim MyNode AsNew NodeInfo
    ' Assign the instance to the Tag property.
    RectangleShape1.Tag = MyNode
EndSubPrivateSub RectangleShape1_Click(ByVal sender As System.Object, _
  ByVal e As System.EventArgs) Handles RectangleShape1.Click
    ' Declare an instance of a networkForm form.Dim networkForm AsNew 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()
EndSub

privatevoid 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;
}

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

Permissões

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ódigos parcialmente Confiável.