Control.Tag プロパティとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Control.Tag プロパティ

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<LocalizableAttribute(False)> _
<BindableAttribute(True)> _
Public Property Tag As Object

Visual Basic (使用法)

Dim instance As Control
Dim value As Object

value = instance.Tag

instance.Tag = value

[LocalizableAttribute(false)] 
[BindableAttribute(true)] 
public Object Tag { get; set;
 }

C++

[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)

JScript

public function get Tag
 () : Object

public function set Tag
 (value : Object)

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

解説

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

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

使用例

フォームを表示して、Tag プロパティに Customer を格納するコード例を次に示します。この例では、Form から派生した CustomerForm という名前のクラス、および Customer が定義されていることが必要です。

Visual Basic

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

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 = 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