Control.Tag 屬性
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定物件，其包含控制項相關資料。
public:
property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };C#
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object Tag { get; set; }C#
[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, setPublic Property Tag As Object包含有關控制項資料的 Object。 預設為 null。
- 屬性
下列程式碼範例會顯示表單，並將 儲存 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();
}
C#
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 屬性中，以便快速存取資料。
| 產品 | 版本 |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |