RibbonComponent.Tag 屬性

定義

命名空間:

Microsoft.Office.Tools.Ribbon

組件:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

取得或設定與這個 RibbonComponent 關聯的應用程式特定資料。

public:
 property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };

public object Tag { get; set; }

member this.Tag : obj with get, set

Public Property Tag As Object

屬性值

Object

System.Object，表示與此 RibbonComponent相關聯的應用程式特定數據。

範例

下列範例示範如何將 對象的數位 Employee 設定為 Tag 群組的 屬性，以及如何擷取 屬性的值 Tag 。 這個範例會要求您定義名為 Employee 的類別，該類別會公開 String 屬性ID，而且您已定義GetEmployees傳回 物件數位式。Employee

若要執行此程式碼範例，您必須先執行下列步驟：

1. 將功能區 (Visual Designer) 專案新增至使用 Visual Studio 中的 Office 開發工具所建立的專案。

2. 將按鈕新增至預設群組 Group1。

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

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

備註

任何衍生自 類別的類型 System.Object 都可以指派給這個屬性。 不過，如果您在 Visual Studio [屬性] 視窗中設定 Tag 屬性，則只能指派文字。

屬性的常見用法 Tag 是儲存與 控件緊密關聯的數據。 例如，如果您有顯示客戶相關信息的按鈕，您可以在按鈕的 Tag 屬性中儲存System.Data.DataSet包含客戶訂單歷程記錄的 ，以便快速存取數據。