RibbonComponent.Tag Özellik

Makale
08/01/2011

Alır veya ayarlar bu ile ilişkili olan uygulamaya özgü veri RibbonComponent.

Ad alanı: Microsoft.Office.Tools.Ribbon
Derleme: Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll içinde)

Sözdizimi

'Bildirim
Property Tag As Object
    Get
    Set

Object Tag { get; set; }

Özellik Değeri

Tür: System.Object
Bir System.Object ilişkili bu uygulamaya özgü verileri temsil eden RibbonComponent.

Açıklamalar

Türetilen herhangi bir tür System.Object sınıfı atanmasını istiyorsanız bu özelliği. Ancak, yaparsanız Tag özelliği Visual Studio Özellikler penceresinde, metin yalnızca atayabilirsiniz.

Yaygın kullanım Tag özelliği olan ile yakından ilişkili verileri depolamak içindenetim. Bir müşteriyle ilgili bilgileri görüntüleyen bir düğme varsa, örneğin, saklamalıdır bir System.Data.DataSet müşterinin siparişi geçmiş düğme içeren Tag verilere kolayca erişilebilir şekilde özellik.

Örnekler

Aşağıdaki örnek, bir dizi nasıl gösterir çalışan nesne Tag bir grubun özelliğini ve değerini almak nasıl Tag özelliği. Bu örnek tanımladığınız adlı bir sınıf gerektirir çalışan , sergiler String özelliği ID ve tanımladığınız bir GetEmployees dizisi döndürür yöntemi çalışan nesneler.

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

Ekleme bir şerit (Visual Designer) Visual Studio'da Office geliştirme araçları kullanılarak oluşturulan bir proje için madde.
Bir düğme varsayılan gruba eklemek grup1.

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 Güvenliği

Anında arayanlar için tam güven. Bu üye kısmen güvenilen kodla kullanılamaz. Daha fazla bilgi için bkz. kısmen güvenilir kod tarafından Kitaplıklar kullanma.

Ayrıca bkz.

Başvuru

RibbonComponent Arabirim

Microsoft.Office.Tools.Ribbon Ad Alanı

Aracılığıyla paylaş