Control.Tag Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Control.cs

Obtient ou définit l’objet qui contient des données sur le 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

Qui Object contient des données sur le 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 formulaire dans sa Tag propriété. Cet exemple nécessite que vous ayez défini une classe dérivée du Form nom CustomerForm et que vous avez 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

Tout type dérivé de la Object classe peut être affecté à cette propriété. Si la Tag propriété est définie via le concepteur Windows Forms, seul le 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 que les données soient accessibles rapidement.

Voir aussi

• Object