Control.Tag 属性

获取或设置包含有关控件的数据的对象。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms(在 system.windows.forms.dll 中)

语法

声明
<LocalizableAttribute(False)> _
<BindableAttribute(True)> _
Public Property Tag As Object
用法
Dim instance As Control
Dim value As Object

value = instance.Tag

instance.Tag = value
[LocalizableAttribute(false)] 
[BindableAttribute(true)] 
public Object Tag { get; set; }
[LocalizableAttribute(false)] 
[BindableAttribute(true)] 
public:
property Object^ Tag {
    Object^ get ();
    void set (Object^ value);
}
/** @property */
public Object get_Tag ()

/** @property */
public void set_Tag (Object value)
public function get Tag () : Object

public function set Tag (value : Object)

属性值

一个 Object,它包含有关控件的数据。默认为 空引用(在 Visual Basic 中为 Nothing)。

备注

Object 类派生的任何类型都可以分配给该属性。如果通过 Windows 窗体设计器设置 Tag 属性,则只能分配文本。

Tag 属性的一个常见用途,是存储与控件密切关联的数据。例如,如果您有一个显示客户信息的控件,则可以在该控件的 Tag 属性中存储包含该客户的订购历史记录的 DataSet,以便可以快速地访问该数据。

示例

下面的代码示例显示一个窗体并将 Customer 存储在其 Tag 属性中。该示例要求已经定义了一个从 Form 派生的、名为 CustomerForm 的类,并且已经定义了一个 Customer

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
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:
   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.set_Tag(new Customer());
    customerForm.Show();
} //buttonNewCustomer_Click

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

.NET Compact Framework

受以下版本支持:2.0

请参见

参考

Control 类
Control 成员
System.Windows.Forms 命名空间
Object