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 Reprezentująca dane aplikacji, która jest skojarzona z tym RibbonComponent.
Uwagi
Dowolny typ 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.
Częstym zastosowaniem Tag właściwości mają być przechowywane dane, które są ściśle związane z kontrolą.Na przykład, jeśli masz przycisku, który wyświetla informacje o kliencie, może przechowywać System.Data.DataSet zawierający historii zamówień odbiorcy w przycisku Tag właściwość, więc dane mogą być szybko uzyskiwać dostęp.
Przykłady
Poniższy przykład pokazuje, jak ustawić tablicę pracownika obiekty do Tag właściwość grupy i jak pobrać wartość Tag właściwość.Wymaga w tym przykładzie zdefiniowano klasę o nazwie pracownika , która naraża String właściwość ID i zdefiniowanych GetEmployees metoda, która zwraca tablicę pracownika obiektów.
Aby uruchomić ten przykład kodu, należy najpierw wykonać następujące czynności:
Dodaj wstążki (wizualnego projektowania) element do projektu utworzone za pomocą narzędzi programistycznych 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 Używanie bibliotek pochodzących z częściowo zaufanego kodu.