Yansıma Kullanarak Özniteliklere Erişme (C# ve Visual Basic)

Özel öznitelikleri tanımlamak ve kaynak kodunuzu yerleştirmeden gerçeği olmadan bu bilgileri alınıyor ve üzerinde çalışan herhangi bir şekilde çok az değer olacaktır.Yansıtma kullanarak özel özniteliklerle tanımlanan bilgi alabilirsiniz.Anahtar yöntemi GetCustomAttributes, kaynak kod öznitelikleri çalıştırma eşdeğerleri olan nesneleri içeren bir dizi döndürür.Bu yöntem birçok aşırı yüklü sürümlerini içerir.Daha fazla bilgi için bkz. Attribute.

Öznitelik belirtimi gibi:

<Author("P. Ackerman", Version:=1.1)> 
Class SampleClass
    ' P. Ackerman's code goes here... 
End Class

[Author("P. Ackerman", version = 1.1)]
class SampleClass

Bunun için kavramsal olarak eşdeğerdir:

Dim anonymousAuthorObject As Author = New Author("P. Ackerman")
anonymousAuthorObject.version = 1.1

Author anonymousAuthorObject = new Author("P. Ackerman");
anonymousAuthorObject.version = 1.1;

Bununla birlikte, kodu kadar yürütülmez SampleClass öznitelikleri için sorgulanır.Arayan GetCustomAttributes üzerinde SampleClass neden olan bir Author nesnesi oluşturulur ve üstü olarak başlatıldı.Sınıfın diğer öznitelikleri varsa, diğer öznitelik nesneleri aynı şekilde oluşturulur.GetCustomAttributesDaha sonra döndürür Author ve bir dizi diğer bir öznitelik nesneleri nesne.Bu dizi yineleme, hangi özniteliklerin her dizi öğesine göre uygulanan belirlemek ve öznitelik nesnelerinden bilgi ayıklamak.

Örnek

Tam bir örnek aşağıdadır.Özel öznitelik tanımlanmış, çeşitli varlıklara uygulanan ve yansıtma alınan.

' Multiuse attribute
<System.AttributeUsage(System.AttributeTargets.Class Or 
                       System.AttributeTargets.Struct, 
                       AllowMultiple:=True)> 
Public Class Author
    Inherits System.Attribute
    Private name As String 
    Public version As Double 
    Sub New(ByVal authorName As String)
        name = authorName

        ' Default value
        version = 1.0
    End Sub 

    Function GetName() As String 
        Return name
    End Function         
End Class 

' Class with the Author attribute
<Author("P. Ackerman")> 
Public Class FirstClass
End Class 

' Class without the Author attribute 
Public Class SecondClass
End Class 

' Class with multiple Author attributes.
<Author("P. Ackerman"), Author("R. Koch", Version:=2.0)> 
Public Class ThirdClass
End Class 

Class TestAuthorAttribute
    Sub Main()
        PrintAuthorInfo(GetType(FirstClass))
        PrintAuthorInfo(GetType(SecondClass))
        PrintAuthorInfo(GetType(ThirdClass))
    End Sub 

    Private Shared Sub PrintAuthorInfo(ByVal t As System.Type)
        System.Console.WriteLine("Author information for {0}", t)

        ' Using reflection 
        Dim attrs() As System.Attribute = System.Attribute.GetCustomAttributes(t)

        ' Displaying output 
        For Each attr In attrs
            Dim a As Author = CType(attr, Author)
            System.Console.WriteLine("   {0}, version {1:f}", a.GetName(), a.version)
        Next             
    End Sub 

    ' Output: 
    '   Author information for FirstClass 
    '     P. Ackerman, version 1.00 
    ' Author information for SecondClass 
    ' Author information for ThirdClass 
    '  R. Koch, version 2.00 
    '  P. Ackerman, version 1.00 

End Class

// Multiuse attribute.
[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct,
                       AllowMultiple = true)  // Multiuse attribute.
]
public class Author : System.Attribute
{
    string name;
    public double version;

    public Author(string name)
    {
        this.name = name;

        // Default value.
        version = 1.0;
    }

    public string GetName()
    {
        return name;
    }
}

// Class with the Author attribute.
[Author("P. Ackerman")]
public class FirstClass
{
    // ...
}

// Class without the Author attribute. 
public class SecondClass
{
    // ...
}

// Class with multiple Author attributes.
[Author("P. Ackerman"), Author("R. Koch", version = 2.0)]
public class ThirdClass
{
    // ...
}

class TestAuthorAttribute
{
    static void Test()
    {
        PrintAuthorInfo(typeof(FirstClass));
        PrintAuthorInfo(typeof(SecondClass));
        PrintAuthorInfo(typeof(ThirdClass));
    }

    private static void PrintAuthorInfo(System.Type t)
    {
        System.Console.WriteLine("Author information for {0}", t);

        // Using reflection.
        System.Attribute[] attrs = System.Attribute.GetCustomAttributes(t);  // Reflection. 

        // Displaying output. 
        foreach (System.Attribute attr in attrs)
        {
            if (attr is Author)
            {
                Author a = (Author)attr;
                System.Console.WriteLine("   {0}, version {1:f}", a.GetName(), a.version);
            }
        }
    }
}
/* Output:
    Author information for FirstClass
       P. Ackerman, version 1.00
    Author information for SecondClass
    Author information for ThirdClass
       R. Koch, version 2.00
       P. Ackerman, version 1.00
*/

Ayrıca bkz.

Başvuru

Yansıma (C# ve Visual Basic)

Öznitelikler (C# ve Visual Basic)

Özel Öznitelikler Oluşturma (C# ve Visual Basic)

System.Reflection

Attribute

Kavramlar

C# Programlama Kılavuzu

Özniteliklerde Depolanan Bilgileri Alma

Diğer Kaynaklar

Visual Basic Programlama Kılavuzu