Bagikan melalui

Terapkan atribut

Gunakan proses berikut untuk menerapkan atribut ke elemen kode Anda.

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

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

    Setiap bahasa memiliki sintaks atributnya sendiri. Dalam C++ dan C#, atribut dikelilingi oleh tanda kurung siku dan dipisahkan dari elemen dengan spasi putih, yang dapat mencakup pemisah baris. Di Visual Basic, atribut dikelilingi oleh tanda kurung sudut dan harus berada di garis logis yang sama; karakter kelanjutan baris dapat digunakan jika hentian baris diinginkan.

  3. Tentukan parameter posisi dan parameter bernama untuk atribut .

    Parameter posisi diperlukan dan harus datang sebelum parameter bernama; mereka sesuai dengan parameter salah satu konstruktor atribut. Parameter bernama bersifat opsional dan sesuai dengan properti atribut yang dapat dibaca dan ditulis. Di C++, dan C#, tentukan name=value untuk setiap parameter opsional, di mana name adalah nama properti . Di Visual Basic, tentukan name:=value.

Atribut dipancarkan ke dalam metadata saat Anda mengkompilasi kode Anda dan tersedia untuk Common Language Runtime (CLR) dan alat atau aplikasi kustom apa pun melalui layanan refleksi pada runtime.

Menurut konvensi, semua nama atribut diakhir 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 Usang.

Menerapkan atribut ke metode

Contoh kode berikut menunjukkan cara menggunakan System.ObsoleteAttribute, yang menandai kode sebagai usang. String "Will be removed in next version" diteruskan ke atribut . Atribut ini mengakibatkan peringatan kompilator yang menunjukkan string yang diberikan saat kode yang dijelaskan oleh atribut tersebut dipanggil.

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 di tingkat perakitan

Jika Anda ingin menerapkan atribut di tingkat perakitan, gunakan assembly kata kunci (Assembly di Visual Basic). Kode berikut menunjukkan AssemblyTitleAttribute diterapkan pada level 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 perakitan dalam bagian metadata file. Anda dapat melihat atribut baik dengan menggunakan Il Disassembler (Ildasm.exe) atau dengan membuat program kustom untuk mengambil atribut.

Lihat juga

  • Last updated on