Control.Tag Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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.

Dotyczy

Zobacz też

Object