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 named 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 窗体设计器设置的，则只能分配文本。
属性的 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, 4.8.1 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9, 10 |
