RibbonComponent.Tag 속성

이 RibbonComponent와 연결된 응용 프로그램별 데이터를 가져오거나 설정합니다.

네임스페이스:  Microsoft.Office.Tools.Ribbon
어셈블리:  Microsoft.Office.Tools.Common(Microsoft.Office.Tools.Common.dll)

구문

‘선언
Property Tag As Object
    Get
    Set

Object Tag { get; set; }

속성 값

형식: System.Object
이 RibbonComponent와 연결된 응용 프로그램별 데이터를 나타내는 System.Object입니다.

설명

System.Object 클래스에서 파생된 형식은 모두 이 속성에 할당될 수 있습니다. 그러나 Visual Studio 속성 창에서 Tag 속성을 설정한 경우 텍스트만 할당할 수 있습니다.

Tag 속성은 대개 컨트롤과 밀접하게 연결된 데이터를 저장하는 데 사용됩니다. 예를 들어, 고객 정보를 표시하는 단추가 있는 경우 데이터에 빠르게 액세스할 수 있도록 해당 단추의 Tag 속성에 고객의 주문 기록이 들어 있는 System.Data.DataSet을 저장할 수 있습니다.

예제

다음 코드 예제에서는 Employee 개체의 배열을 그룹의 Tag 속성으로 설정하는 방법과 Tag 속성의 값을 검색하는 방법을 보여 줍니다. 이 예제를 실행하려면 먼저 String 속성 ID를 노출하는 Employee라는 클래스를 정의하고 Employee 개체의 배열을 반환하는 GetEmployees 메서드를 정의해야 합니다.

이 코드 예제를 실행하려면 먼저 다음 단계를 수행해야 합니다.

1. 리본(비주얼 디자이너) 항목을 Visual Studio에 있는 Office 개발 도구를 사용하여 만든 프로젝트에 추가합니다.

2. 기본 그룹 Group1에 단추를 추가합니다.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Button1.Click
    ' Set the group's Tag property
    Group1.Tag = GetEmployees()

    ' Show all customers by retrieving them from the group's Tag property
    For Each emp As Employee In CType(Group1.Tag, Employee())
        System.Windows.Forms.MessageBox.Show(emp.ID)
    Next
End Sub

private void button1_Click(object sender, RibbonControlEventArgs e)
{
    // Set the group's Tag property
    group1.Tag = GetEmployees();

    // Show all customers by retrieving them from the group's Tag property
    foreach (Employee emp in (Employee[])group1.Tag)
    {
        System.Windows.Forms.MessageBox.Show(emp.ID);
    }
}

.NET Framework 보안

• 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

RibbonComponent 인터페이스

Microsoft.Office.Tools.Ribbon 네임스페이스