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; bütün bir derleme veya modül için geçerlidir. Örneğin, AssemblyVersionAttribute özniteliği sürüm bilgilerini bir derlemeye eklemek için kullanılabilir, ö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. Genel öznitelikler birden çok kaynak dosyada görünebilir, ancak dosyaların tek bir derleme geçişinde derlenmesi gerekir. Visual Studio, .NET Framework projelerindeki AssemblyInfo.cs dosyasına genel öznitelikler ekler. Bu öznitelikler .NET Core projelerine eklenmez.

Derleme öznitelikleri, bir derleme hakkında bilgi sağlayan değerlerdir. 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, ad değeri derleyici, Derleme Bilgileri İletişim Kutusu'ndaki Visual Studio IDE veya derleme oluşturulduğunda Derleme Bağlayıcısı (Al.exe) tarafından ayarlanır. 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 Derlemenin aynı bilgisayarda, aynı işlemde veya aynı uygulama etki alanında yan yana yürütmeyi destekleyip desteklemediğini belirtir.

Bilgi öznitelikleri

Bir derleme için ek şirket veya ürün bilgileri sağlamak için bilgi özniteliklerini kullanırsınız. 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 kullanabilirsiniz. Ö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