Właściwość RibbonComponent.Tag —
Pobiera lub ustawia dane specyficzne dla aplikacji, która jest skojarzona z tym RibbonComponent.
Przestrzeń nazw: Microsoft.Office.Tools.Ribbon
Zestawy: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)
Microsoft.Office.Tools.Common.v4.0.Utilities (w Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
Składnia
'Deklaracja
Property Tag As Object
Object Tag { get; set; }
Wartość właściwości
Typ: System.Object
System.Object , Oznaczającą dane specyficzne dla aplikacji, który jest skojarzony z tym RibbonComponent.
Uwagi
Dowolnego typu, pochodzące z System.Object klasy mogą być przypisane do tej właściwości.Jednakże jeśli ustawisz Tag właściwość w programie Visual Studio Właściwości okna, można przypisać tylko tekst.
Typowe zastosowanie dla Tag właściwość jest do przechowywania danych, która jest ściśle związany z formantem.Na przykład, jeśli przycisk, który wyświetla informacje o kliencie, może przechowywać System.Data.DataSet który zawiera historię zamówień klienta w przycisku Tag właściwość, więc dane mogą być szybko uzyskiwać dostęp.
Przykłady
Poniższy przykład ilustruje sposób ustawić szereg pracownika nie sprzeciwia się Tag właściwość, grupy i sposób pobierania wartości Tag właściwość.W tym przykładzie wymaga zdefiniowano klasę o nazwie pracownika , która naraża String właściwość ID i zdefiniowanej przez użytkownika GetEmployees metodę, która zwraca tablicę pracownika obiektów.
Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:
Dodać wstążki (Visual Designer) element, aby projekt utworzony przy użyciu narzędzia programowania pakietu Office w programie Visual Studio.
Dodawanie przycisku do domyślnej grupy grupa1.
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);
}
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..