RibbonComponent.Tag-Eigenschaft

Artikel
05/07/2013

Ruft anwendungsspezifische Daten ab, die RibbonComponent zugeordnet sind, oder legt diese fest.

Namespace: Microsoft.Office.Tools.Ribbon
Assemblys: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Microsoft.Office.Tools.Common.v4.0.Utilities (in Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Syntax

'Declaration
Property Tag As Object

Object Tag { get; set; }

Eigenschaftswert

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 ein Menüband (Visual Designer)-Element zu einem Projekt hinzu, in dem Sie die Office-Entwicklungstools in Visual Studio verwenden.
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);
    }
}

.NET Framework-Sicherheit

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.

Siehe auch

Referenz

RibbonComponent Schnittstelle

Microsoft.Office.Tools.Ribbon-Namespace

Freigeben über