RibbonComponent.Tag-Eigenschaft (2007 System)
Aktualisiert: November 2007
Ruft anwendungsspezifische Daten ab, die RibbonComponent zugeordnet sind, oder legt diese fest.
Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Syntax
'Declaration
Public Property Tag As Object
'Usage
Dim instance As RibbonComponent
Dim value As Object
value = instance.Tag
instance.Tag = value
public Object Tag { get; set; }
Eigenschaftenwert
Typ: System.Object
Ein System.Object, das anwendungsspezifische Daten darstellt, die RibbonComponent zugeordnet sind.
Hinweise
Dieser Eigenschaft kann jeder von der System.Object-Klasse abgeleitete Typ zugewiesen werden. Wird jedoch die Tag-Eigenschaft im Fenster Eigenschaften von Visual Studio festgelegt, kann nur Text zugeordnet werden.
Die Tag-Eigenschaft wird häufig zum Speichern von Daten verwendet, die eng mit dem Steuerelement verknüpft sind. Werden auf einer Schaltfläche z. B., Informationen zu einem Kunden angezeigt, können Sie ein System.Data.DataSet mit den bisherigen Aufträgen dieses Kunden in der Tag-Eigenschaft der Schaltfläche speichern, sodass ein schneller Zugriff auf die Daten möglich ist.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie ein Array mit Employee-Objekten auf die Tag-Eigenschaft einer Gruppe festgelegt und wie der Wert der Tag-Eigenschaft abgerufen wird. Für dieses Beispiel muss eine Klasse mit dem Namen Employee definiert werden, die die String-Eigenschafts-ID verfügbar macht. Außerdem muss eine GetEmployees-Methode definiert werden, die ein Array mit Employee-Objekten zurückgibt.
Zum Ausführen dieses Codebeispiels müssen zuerst die folgenden Schritte ausgeführt werden:
Fügen Sie einem Visual Studio Tools for Office-Projekt ein Element von Multifunktionsleiste (Visual Designer) hinzu.
Fügen Sie der Standardgruppe Group1 eine Schaltfläche hinzu.
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);
}
}
Berechtigungen
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.