Terapkan atribut

  • Artikel

Gunakan proses berikut untuk menerapkan atribut ke elemen kode Anda.

  1. Tentukan atribut baru atau gunakan atribut .NET yang sudah ada.

  2. Terapkan atribut ke elemen kode dengan menempatkannya segera sebelum ke elemen.

    Setiap bahasa mempunyai atribut syntaxnya masing-masing. Dalam C++ dan C#, atribut dikelilingi oleh tanda kurung siku dan dipisahkan dari elemen dengan ruang kosong, yang dapat mencakup baris pemisah. Dalam Visual Basic, atribut dikelilingi oleh tanda kurung sudut dan harus berada di garis logis yang sama; kelanjutan baris karakter dapat digunakan pembatas garis jika menginginkannya.

  3. Menentukan posisi parameter dan parameter bernama untuk sebuah atribut.

    Parameter Posisi diperlukan dan harus datang sebelum parameter bernama; mereka berhubungan dengan parameter dari salah satu konstruktor atribut. Parameter Bernama bersifat opsional dan sesuai dengan properti baca/tulis atribut. Dalam C++, dan C#, tentukan name=value untuk setiap parameter opsional, dengan name nama dari sebuah properti. Dalam Visual Basic, tentukan name:=value.

Atribut ini dipancarkan ke dalam metadata saat Anda mengkompilasi kode Anda dan tersedia untuk runtime bahasa umum dan alat atau aplikasi kustom apa pun melalui layanan pantulan runtime.

Menurut konvensi, semua nama atribut berakhir dengan "Atribut". Namun, beberapa bahasa yang menargetkan runtime, seperti Visual Basic dan C#, tidak mengharuskan Anda menentukan nama lengkap atribut. Misalnya, jika Anda ingin menginisialisasi System.ObsoleteAttribute, Anda hanya perlu mereferensikannya sebagai Obsolete.

Menerapkan atribut ke dalam metode

Contoh kode berikut menunjukkan cara menggunakan System.ObsoleteAttribute, yang menandai kode sebagai kedaluwarsa. String "Will be removed in next version" diteruskan ke atribut. Atribut ini menyebabkan peringatan kompilator yang menampilkan string yang diteruskan ketika kode yang dijelaskan atribut dipanggil.

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

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

int main()
{
    Test::Main();
}

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

Menerapkan atribut pada tingkat rakitan

Jika Anda ingin menerapkan atribut pada tingkat rakitan, gunakan kata kunci assembly (Assembly dalam Visual Basic). Kode berikut menunjukkan AssemblyTitleAttribute yang diterapkan pada tingkat rakitan.

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

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

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

Ketika atribut ini diterapkan, string "My Assembly" ditempatkan dalam manifes rakitan di bagian metadata file. Anda dapat melihat atribut baik dengan menggunakan Il Disassembler (Ildasm.exe) atau dengan membuat program kustom untuk mengambil atribut.

Lihat juga