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
一个 System.Object，表示与此 RibbonComponent 关联的特定于应用程序的数据。

备注

从 System.Object 类派生的任何类型都可以分配给该属性。 但是，如果在 Visual Studio**“属性”**窗口中设置了 Tag 属性，则只能分配文本。

Tag 属性的一个常见用途，是存储与控件密切关联的数据。 例如，如果有一个显示客户信息的按钮，则可以在该按钮的 Tag 属性中存储包含客户的订购历史记录的 System.Data.DataSet，以便可以快速访问这些数据。

示例

下面的示例演示如何将 Employee 对象数组设置为组的 Tag 属性，以及如何检索 Tag 属性的值。 此示例要求您已经定义了名为 Employee 且公开 String 属性 ID 的类，而且您已经定义了返回 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 命名空间