RibbonDropDownItem.Tag-Eigenschaft

Artikel
05/07/2013

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

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

'Declaration
<BindableAttribute(True)> _
<TypeConverterAttribute> _
Property Tag As Object

[BindableAttribute(true)]
[TypeConverterAttribute]
Object Tag { get; set; }

Eigenschaftswert

Typ: System.Object
Ein Objekt, das anwendungsspezifische Daten darstellt, die RibbonDropDownItem 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 Element verknüpft sind.

Beispiele

Im folgenden Beispiel wird die Tag-Eigenschaft eines RibbonDropDownItem in einem Dropdownfeld festgelegt.

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 ein Dropdownfeld hinzu.

Public Class CourseInfo
    Private ID As String
    Public Sub New(ByVal _courseID As String)
        ID = _courseID
    End Sub
End Class

Private Sub AddDropDownTag()
    Dim item1 As RibbonDropDownItem = Me.Factory.CreateRibbonDropDownItem()
    item1.Label = "Class 101"
    item1.Tag = New CourseInfo("101")
    DropDown1.Items.Add(item1)
End Sub

public class CourseInfo
{
    private string ID;
    public CourseInfo(string _courseID)
    {
        ID = _courseID;
    }
}

private void AddDropDownTag()
{
    RibbonDropDownItem item1 = this.Factory.CreateRibbonDropDownItem(); 
    item1.Label = "Class 101";
    item1.Tag = new CourseInfo("101");
    dropDown1.Items.Add(item1);
}

.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.