Control.Tag プロパティ

コントロールに関するデータを格納するオブジェクトを取得または設定します。

Public Property Tag As Object
[C#]
public object Tag {get; set;}
[C++]
public: __property Object* get_Tag();public: __property void set_Tag(Object*);
[JScript]
public function get Tag() : Object;public function set Tag(Object);

プロパティ値

コントロールに関するデータを格納している Object 。既定値は null 参照 (Visual Basic では Nothing) です。

解説

Object クラスから派生した任意の型をこのプロパティに割り当てることができます。 Tag プロパティが Windows フォーム デザイナを使用して設定されている場合は、テキストだけを割り当てることができます。

Tag プロパティは、一般的に、コントロールに密接に関連付けられたデータを格納するために使用します。たとえば、顧客に関する情報を表示するコントロールがある場合は、顧客のオーダー履歴を含む DataSet をそのコントロールの Tag プロパティに格納して、データにすばやくアクセスできるようにします。

使用例

[Visual Basic, C#, C++] フォームを表示して、 Tag プロパティに Customer オブジェクトを格納する例を次に示します。この例は、 CustomerForm という Form から派生したクラス、および 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

[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();
}

[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();
    }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

Control クラス | Control メンバ | System.Windows.Forms 名前空間 | Object