Control.Tag Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft das Objekt ab, das Daten über das Steuerelement enthält, oder legt dieses fest.

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

Eigenschaftswert

Object

Ein Object, das Daten über das Steuerelement enthält. Der Standardwert ist null.

Attribute

BindableAttribute TypeConverterAttribute

Beispiele

Im folgenden Codebeispiel wird ein Formular angezeigt und in seiner Tag Eigenschaft gespeichertCustomer. Dieses Beispiel erfordert, dass Sie eine Klasse definiert haben, die von Form benannt CustomerForm abgeleitet wird und dass Sie eine Customerdefiniert haben.

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

Hinweise

Dieser Eigenschaft kann jeder von der Object -Klasse abgeleitete Typ zugewiesen werden. Wenn die Tag Eigenschaft über den Windows Forms-Designer festgelegt wird, kann nur Text zugewiesen werden.

Eine häufige Verwendung für die Tag -Eigenschaft besteht darin, Daten zu speichern, die eng mit dem Steuerelement verknüpft sind. Wenn Sie beispielsweise über ein Steuerelement verfügen, das Informationen zu einem Kunden anzeigt, können Sie ein DataSet speichern, das den Bestellverlauf des Kunden in der Eigenschaft dieses Steuerelements Tag enthält, damit schnell auf die Daten zugegriffen werden kann.

Weitere Informationen

• Object