C# derleyicisi tarafından yorumlanan derleme düzeyi öznitelikleri

Özniteliklerin çoğu sınıflar veya yöntemler gibi belirli dil öğelerine uygulanır. Ancak bazı öznitelikler geneldir. Bir bütünleştirilmiş kod veya modülün tamamına uygulanır. Örneğin, sürüm bilgilerini bir derlemeye eklemek için özniteliğini AssemblyVersionAttribute kullanın, örneğin:

[assembly: AssemblyVersion("1.0.0.0")]

Genel öznitelikler, herhangi bir üst düzey using yönergeden sonra ve herhangi bir tür, modül veya ad alanı bildiriminden önce kaynak kodunda görünür. Birden çok kaynak dosyaya genel öznitelikler ekleyebilirsiniz, ancak dosyaları tek bir derleme geçişinde derlemeniz gerekir. .NET Framework projelerinde Visual Studio, AssemblyInfo.cs dosyasına genel öznitelikler ekler. Bu öznitelikler .NET Core projelerine eklenmez.

C# dili başvuru belgesi, C# dilinin en son yayımlanan sürümünü gösterir. Ayrıca, yaklaşan dil sürümü için genel önizlemelerdeki özelliklere yönelik ilk belgeleri içerir.

Belgelerde ilk olarak dilin son üç sürümünde veya geçerli genel önizlemelerde sunulan tüm özellikler tanımlanır.

Tavsiye

Bir özelliğin C# dilinde ilk tanıtıldığı zamanları bulmak için C# dil sürümü geçmişi makalesine bakın.

Derleme öznitelikleri bir derleme hakkında bilgi sağlar. Bunlar aşağıdaki kategorilere ayrılır:

• Derleme kimliği öznitelikleri
• Bilgi öznitelikleri
• Derleme bildirimi öznitelikleri

Derleme kimliği öznitelikleri

Bir derlemenin kimliğini üç öznitelik (varsa tanımlayıcı bir adla) belirler: ad, sürüm ve kültür. Bu öznitelikler derlemenin tam adını oluşturur ve kodda başvururken gereklidir. Öznitelikleri kullanarak derlemenin sürümünü ve kültürünü ayarlayabilirsiniz. Ancak, derlemeyi oluştururken derleyici, Derleme Bilgileri İletişim Kutusu'ndaki Visual Studio IDE veya Derleme Bağlayıcısı (Al.exe) tarafından ad değerini ayarlarsınız. Derleme adı, derleme bildirimini temel alır. AssemblyFlagsAttribute özniteliği, derlemenin birden çok kopyasının birlikte bulunup bulunamayacağını belirtir.

Aşağıdaki tabloda kimlik öznitelikleri gösterilmektedir.

Öznitelik	Purpose
AssemblyVersionAttribute	Derlemenin sürümünü belirtir.
AssemblyCultureAttribute	Derlemenin hangi kültürü desteklediğini belirtir.
AssemblyFlagsAttribute	Tam zamanında (JIT) derleyici seçeneklerini, derlemenin yeniden güncelleştirilebilir olup olmadığını ve tam veya belirteçli bir ortak anahtara sahip olup olmadığını açıklayan bir derleme için bayrakların bit düzeyinde birleşimini belirtir.

Bilgi öznitelikleri

Bir derleme için daha fazla şirket veya ürün bilgisi sağlamak için bilgi özniteliklerini kullanın. Aşağıdaki tabloda ad alanında tanımlanan bilgi öznitelikleri gösterilmektedir System.Reflection .

Öznitelik	Purpose
AssemblyProductAttribute	Derleme bildirimi için bir ürün adı belirtir.
AssemblyTrademarkAttribute	Bir derleme bildiriminin ticari markasını belirtir.
AssemblyInformationalVersionAttribute	Derleme bildirimi için bilgilendirme sürümünü belirtir.
AssemblyCompanyAttribute	Derleme bildirimi için bir şirket adı belirtir.
AssemblyCopyrightAttribute	Derleme bildirimi için telif hakkı belirten özel bir öznitelik tanımlar.
AssemblyFileVersionAttribute	Win32 dosya sürümü kaynağı için belirli bir sürüm numarası ayarlar.
CLSCompliantAttribute	Derlemenin Ortak Dil Belirtimi (CLS) ile uyumlu olup olmadığını gösterir.

Derleme bildirimi öznitelikleri

Derleme bildiriminde bilgi sağlamak için derleme bildirimi özniteliklerini kullanın. Öznitelikler başlık, açıklama, varsayılan diğer ad ve yapılandırmayı içerir. Aşağıdaki tabloda ad alanında tanımlanan derleme bildirimi öznitelikleri gösterilmektedir System.Reflection .

Öznitelik	Purpose
AssemblyTitleAttribute	Derleme bildirimi için bir derleme başlığı belirtir.
AssemblyDescriptionAttribute	Derleme bildirimi için bir derleme açıklaması belirtir.
AssemblyConfigurationAttribute	Derleme bildirimi için bir derleme yapılandırmasını (perakende veya hata ayıklama gibi) belirtir.
AssemblyDefaultAliasAttribute	Derleme bildirimi için kolay bir varsayılan diğer ad tanımlar.