Control.Tag Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o objeto que contém dados sobre o controle.

public:
 property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object Tag { get; set; }

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object? Tag { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))>]
member this.Tag : obj with get, set

Public Property Tag As Object

Valor da propriedade

Object

Um Object que contém dados sobre o controle. O padrão é null.

Atributos

BindableAttribute TypeConverterAttribute

Exemplos

O exemplo de código a seguir exibe um formulário e armazena um Customer em sua Tag propriedade. Este exemplo exige que você tenha definido uma classe que deriva de Form nome e CustomerForm que você tenha definido um Customer.

private:
   void buttonNewCustomer_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      /* Create a new customer form and assign a new
                  * Customer object to the Tag property. */
      CustomerForm^ customerForm = gcnew CustomerForm;
      customerForm->Tag = gcnew Customer;
      customerForm->Show();
   }

private void buttonNewCustomer_Click(object sender, EventArgs e)
{
   /* Create a new customer form and assign a new 
    * Customer object to the Tag property. */
   CustomerForm customerForm = new CustomerForm();
   customerForm.Tag = new Customer();
   customerForm.Show();
}

Private Sub buttonNewCustomer_Click(sender As Object, _
  e As EventArgs) Handles buttonNewCustomer.Click
   ' Create a new customer form and assign a new 
   ' Customer object to the Tag property. 
   Dim customerForm As New CustomerForm()
   customerForm.Tag = New Customer()
   customerForm.Show()
End Sub

Comentários

Qualquer tipo derivado da Object classe pode ser atribuído a essa propriedade. Se a Tag propriedade for definida por meio do designer de Windows Forms, somente o texto poderá ser atribuído.

Um uso comum para a Tag propriedade é armazenar dados que estão intimamente associados ao controle. Por exemplo, se você tiver um controle que exibe informações sobre um cliente, poderá armazenar um DataSet que contenha o histórico de pedidos do cliente na propriedade desse Tag controle para que os dados possam ser acessados rapidamente.

Confira também

• Object