Proprietà RibbonComponent.Tag

Articolo
08/11/2011

Ottiene o imposta dati specifici dell'applicazione associati a RibbonComponent.

Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Sintassi

'Dichiarazione
Property Tag As Object
    Get
    Set

Object Tag { get; set; }

Valore proprietà

Tipo: System.Object
Oggetto System.Object che rappresenta dati specifici dell'applicazione associati a RibbonComponent.

Note

A questa proprietà può essere assegnato qualsiasi tipo derivato dalla classe System.Object. Tuttavia, se la proprietà Tag nella finestra Proprietà di Visual Studio è impostata, è possibile unicamente assegnare testo.

Un uso comune della proprietà Tag consiste nel memorizzare i dati strettamente associati al controllo. Nel caso di un pulsante che consente di visualizzare informazioni relative a un cliente, ad esempio, è possibile archiviare un oggetto System.Data.DataSet contenente la cronologia degli ordini del cliente nella proprietà Tag del pulsante in modo da accedere rapidamente ai dati.

Esempi

Nell'esempio seguente viene illustrato come impostare una matrice di oggetti Employee sulla proprietà Tag di un gruppo e come recuperare il valore della proprietà Tag. In questo esempio viene richiesta la definizione di una classe denominata Employee in cui viene esposto l'ID della proprietà String e di un metodo GetEmployees che restituisce una matrice di oggetti Employee.

Per eseguire questo esempio di codice, effettuare innanzitutto le seguenti operazioni:

Aggiungere un elemento Barra multifunzione (finestra di progettazione visiva) a un progetto creato utilizzando gli strumenti di sviluppo Office di Visual Studio.
Aggiungere un pulsante al gruppo predefinito Group1.

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);
    }
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

RibbonComponent Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Ribbon

Condividi tramite