Control.Tag Propiedad

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Source:: Control.cs

Source:: Control.cs

Source:: Control.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene o establece el objeto que contiene datos sobre el control.

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 de propiedad

Object

Object que contiene datos sobre el control. De manera predeterminada, es null.

Atributos: BindableAttribute TypeConverterAttribute

Ejemplos

En el ejemplo de código siguiente se muestra un formulario y se almacena en Customer su Tag propiedad . En este ejemplo se requiere que haya definido una clase que derive de Form con nombre CustomerForm y que haya definido un 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

Comentarios

Cualquier tipo derivado de la Object clase se puede asignar a esta propiedad. Si la Tag propiedad se establece a través del diseñador de Windows Forms, solo se puede asignar texto.

Un uso común de la Tag propiedad es almacenar datos que están estrechamente asociados con el control. Por ejemplo, si tiene un control que muestra información sobre un cliente, puede almacenar un DataSet que contenga el historial de pedidos del cliente en esa propiedad del Tag control para que se pueda acceder a los datos rápidamente.

Se aplica a

Producto	Versiones
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9, 10

Consulte también

Object

Compartir a través de