Control.Tag Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit l'objet qui contient les données relatives au contrôle.

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))>]
member this.Tag : obj with get, set

Public Property Tag As Object

Valeur de propriété

Object

Object qui contient les données relatives au contrôle. La valeur par défaut est null.

Attributs

BindableAttribute TypeConverterAttribute

Exemples

L’exemple de code suivant affiche un formulaire et stocke un Customer dans sa Tag propriété. Cet exemple nécessite que vous ayez défini une classe qui dérive de Form nommé CustomerForm et que vous ayez défini 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

Remarques

N’importe quel type dérivé de la Object classe peut être affecté à cette propriété. Si la propriété est définie via le concepteur Windows Forms, seul le Tag texte peut être affecté.

Une utilisation courante de la Tag propriété consiste à stocker des données étroitement associées au contrôle. Par exemple, si vous avez un contrôle qui affiche des informations sur un client, vous pouvez stocker un DataSet qui contient l’historique des commandes du client dans la propriété de Tag ce contrôle afin d’accéder rapidement aux données.

Voir aussi

• Object