RibbonComponent.Tag – vlastnost

Článek
08/11/2011

Získá nebo nastaví specifická data spojená s tímto RibbonComponent.

Obor názvů: Microsoft.Office.Tools.Ribbon
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)

Syntaxe

'Deklarace
Property Tag As Object
    Get
    Set

Object Tag { get; set; }

Hodnota vlastnosti

Typ: System.Object
System.Object , Představuje specifická data přidružená k této RibbonComponent.

Poznámky

Libovolný typ odvozený z System.Object třídy může být přiřazena vlastnost. Však nastavíte Tag vlastností v aplikaci Visual Studio Vlastnosti okna, můžete přiřadit pouze text.

Běžné použití Tag vlastnost je ukládání dat je úzce spojeno s ovládací prvek. Například pokud je tlačítko, které zobrazí informace o zákazník, může být uloženy System.Data.DataSet objednávky zákazník historie na tlačítku, která obsahuje Tag vlastnost tak data lze rychle přistupovat.

Příklady

Následující příklad ukazuje, jak nastavit pole zaměstnance objekty do Taga jak načíst hodnotuvlastnost skupiny Tagvlastnost. Tento příklad vyžaduje definovanou třída zaměstnance poskytuje String vlastnost ID a že jste definovali GetEmployees metoda vrátí pole zaměstnance objektů.

Chcete-li spustit příklad kódu je musí provést následující kroky:

Přidat Pás karet (vizuální Návrhář) položka projekt vytvořený pomocí nástroje Office vývoj v Visual Studio.
Přidat tlačítko do výchozí skupiny skupina1.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Odkaz

RibbonComponent Rozhraní

Microsoft.Office.Tools.Ribbon – obor názvů

Sdílet prostřednictvím