Control.Tag Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen des Objekts, das Daten zum Steuerelement enthält.
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
Eigenschaftswert
Eine Object , die Daten zum Steuerelement enthält. Der Standardwert lautet null.
- Attribute
Beispiele
Im folgenden Codebeispiel wird ein Formular angezeigt und eine Customer in seiner Tag Eigenschaft gespeichert. In diesem Beispiel müssen Sie eine Klasse definiert haben, die von Form benannten CustomerForm und von Ihnen definierten .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
Hinweise
Jeder von der Object Klasse abgeleitete Typ kann dieser Eigenschaft zugewiesen werden. Wenn die Tag Eigenschaft über den Windows Forms-Designer festgelegt wird, können 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 z. B. über ein Steuerelement verfügen, das Informationen zu einem Kunden anzeigt, können Sie ein DataSet Steuerelement speichern, das den Bestellverlauf des Kunden in der Eigenschaft dieses Steuerelements Tag enthält, damit schnell auf die Daten zugegriffen werden kann.