Control.Tag 속성

정의

컨트롤에 대한 데이터가 포함된 개체를 가져오거나 설정합니다.Gets or sets the object that contains data about the control.

public:
 property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.StringConverter))]
public object Tag { get; set; }
member this.Tag : obj with get, set
Public Property Tag As Object

속성 값

컨트롤에 대한 데이터가 포함된 Object입니다.An Object that contains data about the control. 기본값은 null입니다.The default is null.

특성

예제

다음 코드 예제에서는 폼을 표시 하 고 Tag 속성에 Customer을 저장 합니다.The following code example displays a form and stores a Customer in its Tag property. 이 예제에서는 CustomerForm 라는 Form에서 파생 되 고 Customer를 정의한 클래스를 정의 해야 합니다.This example requires that you have defined a class that derives from Form named CustomerForm and that you have defined a 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();
   }
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 클래스에서 파생 된 모든 형식을이 속성에 할당할 수 있습니다.Any type derived from the Object class can be assigned to this property. Tag 속성이 Windows Forms 디자이너를 통해 설정 된 경우 텍스트만 할당할 수 있습니다.If the Tag property is set through the Windows Forms designer, only text can be assigned.

Tag 속성의 일반적인 용도는 컨트롤과 밀접 하 게 관련 된 데이터를 저장 하는 것입니다.A common use for the Tag property is to store data that is closely associated with the control. 예를 들어 고객에 대 한 정보를 표시 하는 컨트롤이 있는 경우 해당 컨트롤의 Tag 속성에서 고객의 주문 기록을 포함 하는 DataSet을 저장할 수 있습니다. 그러면 데이터에 빠르게 액세스할 수 있습니다.For example, if you have a control that displays information about a customer, you might store a DataSet that contains the customer's order history in that control's Tag property so the data can be accessed quickly.

적용 대상

추가 정보