Control.Tag Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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))]
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 contient les données relatives au contrôle. La valeur par défaut est null
.
- Attributs
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.