RibbonComponent.Tag Özellik

Tanım

Ad Alanı:

Microsoft.Office.Tools.Ribbon

Bütünleştirilmiş Kodlar:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Bu RibbonComponentile ilişkili uygulamaya özgü verileri alır veya ayarlar.

public:
 property System::Object ^ Tag { System::Object ^ get(); void set(System::Object ^ value); };

public object Tag { get; set; }

member this.Tag : obj with get, set

Public Property Tag As Object

Özellik Değeri

Object

Bu RibbonComponentile ilişkili uygulamaya özgü verileri temsil eden bir System.Object.

Örnekler

Aşağıdaki örnek, bir nesne dizisinin Employee bir grubun özelliğine Tag nasıl ayarlandığını ve özelliğin değerinin nasıl alınıp Tag alınyacağını gösterir. Bu örnek, özelliğini ID kullanıma String sunan adlı Employee bir sınıf tanımlamış olmanız ve bir nesne dizisi Employee döndüren bir GetEmployees yöntem tanımlamış olmanız gerekir.

Bu kod örneğini çalıştırmak için önce aşağıdaki adımları gerçekleştirmeniz gerekir:

1. Visual Studio'da Office geliştirme araçları kullanılarak oluşturulan bir projeye Şerit (Visual Tasarım Aracı) öğesi ekleyin.

2. Varsayılan gruba Group1bir düğme ekleyin.

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

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

Açıklamalar

sınıfından System.Object türetilen herhangi bir tür bu özelliğe atanabilir. Ancak, özelliği Visual Studio Özellikleri penceresinde ayarlarsanızTag, yalnızca metin atayabilirsiniz.

özelliği için Tag yaygın bir kullanım, denetimle yakından ilişkili verileri depolamaktır. Örneğin, müşteriyle ilgili bilgileri görüntüleyen bir düğmeniz varsa, verilere hızla erişilebilmesi için düğmenin Tag özelliğinde müşterinin sipariş geçmişini içeren bir System.Data.DataSet depolayabilirsiniz.