Aracılığıyla paylaş

Öznitelikleri uygulama

Kodunuzun bir öğesine öznitelik uygulamak için aşağıdaki işlemi kullanın.

  1. Yeni bir öznitelik tanımlayın veya mevcut bir .NET özniteliğini kullanın.

  2. Kod öğesine özniteliği uygulamak için özniteliği öğesinin hemen önüne yerleştirin.

    Her dilin kendi öznitelik söz dizimi vardır. C++ ve C# dilinde, öznitelik köşeli parantezlerle çevrelenir ve öğeden, satır sonu da içerebilen boşlukla ayrılır. Visual Basic'te öznitelik köşeli ayraçlarla çevrelenmiştir ve aynı mantıksal çizgide olmalıdır; satır sonu istenirse satır devamı karakteri kullanılabilir.

  3. Özniteliği için konumsal parametreleri ve adlandırılmış parametreleri belirtin.

    Konumsal parametreler gereklidir ve adlandırılmış parametrelerden önce gelmelidir; öznitelik oluşturucularından birinin parametrelerine karşılık gelir. Adlandırılmış parametreler isteğe bağlıdır ve özniteliğin okuma/yazma özelliklerine karşılık gelir. C++ve C# dilinde, isteğe bağlı her parametre için belirtin name=value ; burada name özelliğin adıdır. Visual Basic'te belirtin name:=value.

Kodunuzu derlediğinizde özniteliği meta veriler halinde yayılır ve çalışma zamanı yansıma hizmetleri aracılığıyla ortak dil çalışma zamanı ve herhangi bir özel araç veya uygulama tarafından kullanılabilir.

Kural gereği, tüm öznitelik adları "Öznitelik" ile biter. Ancak, Visual Basic ve C# gibi çalışma zamanını hedefleyen birkaç dil, özniteliğin tam adını belirtmenizi gerektirmez. Örneğin, başlatmak System.ObsoleteAttributeistiyorsanız, yalnızca Eski olarak başvurmanız gerekir.

Bir yönteme öznitelik uygula

Aşağıdaki kod örneği, kodu eski olarak işaretleyen öğesinin nasıl kullanılacağını System.ObsoleteAttributegösterir. Dize "Will be removed in next version" özniteliğine geçirilir. Bu öznitelik, özniteliğin tanımladığı kod çağrıldığında geçirilen dizeyi görüntüleyen bir derleyici uyarısına neden olur.

public class Example
{
    // Specify attributes between square brackets in C#.
    // This attribute is applied only to the Add method.
    [Obsolete("Will be removed in next version.")]
    public static int Add(int a, int b)
    {
        return (a + b);
    }
}

class Test
{
    public static void Main()
    {
        // This generates a compile-time warning.
        int i = Example.Add(2, 2);
    }
}

Public Class Example
    ' Specify attributes between square brackets in C#.
    ' This attribute is applied only to the Add method.
    <Obsolete("Will be removed in next version.")>
    Public Shared Function Add(a As Integer, b As Integer) As Integer
        Return a + b
    End Function
End Class

Class Test
    Public Shared Sub Main()
        ' This generates a compile-time warning.
        Dim i As Integer = Example.Add(2, 2)
    End Sub
End Class

Öznitelikleri derleme düzeyinde uygulama

Derleme düzeyinde bir öznitelik uygulamak istiyorsanız (assembly Visual Basic'te) anahtar sözcüğünü Assembly kullanın. Aşağıdaki kod, AssemblyTitleAttribute derleme düzeyinde uygulanan öğesini gösterir.

using System.Reflection;
[assembly:AssemblyTitle("My Assembly")]

Imports System.Reflection
<Assembly: AssemblyTitle("My Assembly")>

Bu öznitelik uygulandığında, dize "My Assembly" dosyanın meta veri bölümündeki derleme bildirimine yerleştirilir. Özniteliği, IL Disassembler (Ildasm.exe) kullanarak veya özniteliği almak için özel bir program oluşturarak görüntüleyebilirsiniz.

Ayrıca bakınız

  • Last updated on