RibbonComponent.Tag Özellik

Makale
10/29/2012

Alır veya ayarlar bu ile ilişkili uygulamaya özgü verileri 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

Object Tag { get; set; }

Özellik Değeri

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

Notlar

Türetilen herhangi bir tür System.Object sınıfı, bu özellik atanabilir.Ancak, ayarlarsanız, Tag özelliği Visual Studio özelliklerini penceresinde, metin yalnızca atama.

Ortak kullanım için Tag özelliği olan denetimi ile yakından ilişkili verileri saklamak için.Bir müşteriyle ilgili bilgileri görüntüleyen bir düğme varsa, örneğin, depolayabilir bir System.Data.DataSet müşterinin sipariş geçmişi düğmenin içeren Tag verileri hızlı erişilebilecek şekilde özelliği.

Ö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 adında bir sınıf tanımlı gerektirir çalışan , sergiler String özelliği ID ve tanımladığınız bir GetEmployees dizisi yöntemi çalışan nesneleri.

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

Add bir şerit (Visual Designer) Visual Studio Office geliştirme araçları kullanılarak oluşturulan bir proje için madde.
Düğme varsayılan gruba ekleme 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üvenilen kod kitaplıklarını kullanma.

Ayrıca bkz.

Başvuru

RibbonComponent Arabirim

Microsoft.Office.Tools.Ribbon Ad Alanı

Aracılığıyla paylaş