Control.Tag Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
Um Object que contém dados sobre o controle. O padrão é null
.
- Atributos
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.