Udostępnij za pośrednictwem


Control.Tag Właściwość

Definicja

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

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ż