Control.Tag Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o objeto que contém dados sobre o controlo.
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, setPublic Property Tag As ObjectValor de Propriedade
Um Object que contém dados sobre o controlo. A predefinição é null.
- Atributos
Exemplos
O seguinte exemplo de código mostra um formulário e armazena a Customer na sua Tag propriedade. Este exemplo exige que tenha definido uma classe que deriva de Form nomeada CustomerForm e que 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
Observações
Qualquer tipo derivado da Object classe pode ser atribuído a esta propriedade. Se a propriedade Tag for definida pelo designer Windows Forms, apenas texto pode ser atribuído.
Uma utilização comum da Tag propriedade é armazenar dados que estejam intimamente associados ao controlo. Por exemplo, se tiver um controlo que exibe informação sobre um cliente, pode armazenar um DataSet que contenha o histórico de encomendas do cliente na propriedade desse Tag controlo para que os dados possam ser acedidos rapidamente.
