Propriedade Shape.Tag

Artigo
05/17/2015

Obtém ou define o objeto que contém dados sobre um controle de linha ou de 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: Object
Um Object que contém os dados associados ao 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 o Tag está definida por meio do Designer de formulários do Windows, pode ser atribuído apenas texto.

Um uso comum para o Tag é de propriedade para armazenar dados que estão estreitamente relacionados com o 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 de Tag propriedade para que os dados possam 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 denominado RectangleShape1 em um formulário que tenha 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ável.