Control.Tag 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得或設定物件，其包含控制項相關資料。

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

屬性值

Object

包含有關控制項資料的 Object。 預設為 null。

屬性

BindableAttribute TypeConverterAttribute

範例

下列程式碼範例會顯示表單，並將 儲存 Customer 在其 屬性中 Tag 。 此範例會要求您定義衍生自 Form 具名 CustomerForm 的類別，而且您已定義 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

備註

任何衍生自 類別的類型 Object 都可以指派給這個屬性。 Tag如果屬性是透過Windows Forms設計工具設定，則只能指派文字。

屬性的常見用法 Tag 是儲存與 控制項緊密關聯的資料。 例如，如果您有一個顯示客戶相關資訊的控制項，您可能會將 包含客戶訂單歷程記錄的 儲存 DataSet 在該控制項的 Tag 屬性中，以便快速存取資料。

另請參閱

• Object