RibbonComponent.Tag 속성

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

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

구문

‘선언
Property Tag As Object

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 네임스페이스