Control.Tag Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

Control.cs

Mendapatkan atau mengatur objek yang berisi data tentang kontrol.

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

Nilai Properti

Object

Yang Object berisi data tentang kontrol. Defaultnya adalah null.

Atribut

BindableAttribute TypeConverterAttribute

Contoh

Contoh kode berikut menampilkan formulir dan menyimpan Customer di propertinya Tag . Contoh ini mengharuskan Anda telah menentukan kelas yang berasal dari Form bernama CustomerForm dan Anda telah menentukan 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

Keterangan

Jenis apa pun yang berasal dari Object kelas dapat ditetapkan ke properti ini. Tag Jika properti diatur melalui perancang Windows Forms, hanya teks yang dapat ditetapkan.

Penggunaan umum untuk Tag properti adalah menyimpan data yang terkait erat dengan kontrol. Misalnya, jika Anda memiliki kontrol yang menampilkan informasi tentang pelanggan, Anda mungkin menyimpan DataSet yang berisi riwayat pesanan pelanggan di properti kontrol tersebut Tag sehingga data dapat diakses dengan cepat.

Lihat juga

• Object