Control.Tag Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia obiekt zawierający dane dotyczące kontrolki.

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

Wartość właściwości

Object

Element Object zawierający dane dotyczące kontrolki. Wartość domyślna to null.

Atrybuty

BindableAttribute TypeConverterAttribute

Przykłady

Poniższy przykład kodu wyświetla formularz i przechowuje obiekt Customer we właściwości Tag . W tym przykładzie zdefiniowano klasę, która pochodzi z Form nazwy CustomerForm i zdefiniowano element 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

Uwagi

Do tej właściwości można przypisać dowolny typ pochodzący z Object klasy. Tag Jeśli właściwość jest ustawiana za pośrednictwem projektanta Windows Forms, można przypisać tylko tekst.

Typowym zastosowaniem właściwości Tag jest przechowywanie danych, które są ściśle skojarzone z kontrolką. Jeśli na przykład masz kontrolkę, która wyświetla informacje o kliencie, możesz przechowywać DataSet element zawierający historię zamówień klienta we właściwości tej kontrolki Tag , aby można było szybko uzyskać dostęp do danych.

Zobacz też

• Object