Dil özelliği kuralları için C# Derleyici Seçenekleri

Aşağıdaki seçenekler, derleyicinin dil özelliklerini nasıl yorumlay olduğunu kontrol altına almaktadır. Yeni MSBuild söz dizimi Kalın olarak gösterilir. Daha eski csc.exe söz dizimi içinde code style gösterilir.

• CheckForOverflowUnderflow: / -checked Taşma denetimleri oluşturma.
• AllowUnsafeBlocks: / -unsafe 'güvenli olmayan' koda izin ver.
• DefineConstants: / -define Koşullu derleme sembollerini tanımlayın.
• LangVersion:(en son ana sürüm) veya (ikincil sürümler de dahil / -langversion olmak üzere en son default latest sürüm) gibi bir dil sürümü belirtin.
• Null değere / -nullable değiştirilebilir: Boş değere değiştirilebilir bağlamı veya null değere değiştirilebilir uyarıları etkinleştirin.

CheckForOverflowUnderflow

CheckForOverflowUnderflow seçeneği, veri türünün aralığının dışında bir değerle sonuçlanacak tamsayı aritmetik deyiminin çalışma zamanı özel durumuna neden olup olmadığını belirtir.

<CheckForOverflowUnderflow>true</CheckForOverflowUnderflow>

Bir veya anahtar sözcüğü kapsamındaki tamsayı aritmetik deyimi checked unchecked CheckForOverflowUnderflow seçeneğinin etkisine tabi değildir. bir veya anahtar sözcüğü kapsamında olmayan bir tamsayı aritmetik deyimi, veri türü aralığının dışında bir değerle sonuçlanacaksa ve checked unchecked CheckForOverflowUnderflow ise, bu deyim çalışma zamanında bir özel duruma neden true olur. CheckForOverflowUnderflow false ise, bu deyim çalışma zamanında özel durumlara neden değildir. Bu seçenek için varsayılan false değerdir; taşma denetimi devre dışıdır.

AllowUnsafeBlocks

AllowUnsafeBlocks derleyici seçeneği, derlemek için güvenli olmayan anahtar sözcüğünü kullanan koda izin verir. Bu seçeneğin varsayılan değeridir, false yani güvenli olmayan koda izin verilmez.

<AllowUnsafeBlocks>true</AllowUnsafeBlocks>

Güvenli olmayan kod hakkında daha fazla bilgi için bkz. Güvenli Olmayan Kod ve İşaretçiler.

DefineConstants

DefineConstants seçeneği, programladığınız tüm kaynak kod dosyalarındaki sembolleri tanımlar.

<DefineConstants>name;name2</DefineConstants>

Bu seçenek, tanımlamak istediğiniz bir veya daha fazla simgenin adlarını belirtir. DefineConstants seçeneği, #define önişlemci yönergesi ile aynı etkiye sahiptir ancak derleyici seçeneğinin proje üzerindeki tüm dosyalar için etkili olması gerekir. Kaynak dosyadaki bir #undef yönergesi tanımı kaldırana kadar kaynak dosyada bir simge tanımlanmış kalır. seçeneğini -define kullanırsanız, bir #undef dosyada yer alan yönergenin proje üzerindeki diğer kaynak kod dosyaları üzerinde hiçbir etkisi olmaz. Kaynak dosyalarını koşullu olarak derlemek için #if, #else, #elif ve #endifile bu seçenek tarafından oluşturulan sembolleri kullanabilirsiniz. C# derleyicisi, kaynak kodunda kullanabileceğiniz herhangi bir simge veya makro tanımsıyor; tüm sembol tanımları kullanıcı tanımlı olmalı.

LangVersion

Derleyicinin yalnızca seçilen C# dili belirtimlerine dahil edilen söz dizimlerini kabul etmesine neden olur.

<LangVersion>9.0</LangVersion>

Aşağıdaki değerler geçerlidir:

Varsayılan dil sürümü, uygulamanıza yönelik hedef çerçeveye ve SDK'nın veya Visual Studio bağlıdır. Bu kurallar C# dili sürümüyle tanımlanır.

C# uygulamanız tarafından başvurulan meta veriler LangVersion derleyici seçeneğine tabi değildir.

C# derleyicisi her sürümü dil belirtiminin uzantılarını içerdiği için LangVersion, derleyicinin önceki bir sürümünün eşdeğer işlevselliğini size vermemektedir.

Buna ek olarak, C# sürüm güncelleştirmeleri genellikle ana .NET Framework sürümlerle çakışsa da, yeni söz dizimi ve özellikler bu çerçeve sürümüne bağlı olmayabilir. Yeni özellikler kesinlikle C# düzeltmesi ile birlikte yayımlanan yeni bir derleyici güncelleştirmesi gerektirir, ancak her belirli özelliğin, NuGet paketleri veya diğer kitaplıkları dahil etmek üzere alt düzey çerçevelerde çalışmasına izin verebilen kendi en düşük .NET API'si veya ortak dil çalışma zamanı gereksinimleri vardır.

Hangi LangVersion ayarını kullanırsanız kullanın, çalışma zamanlarınızı oluşturmak için ortak dil çalışma zamanının geçerli .exe veya .dll. Bir özel durum, -langversion:ISO-1 altında çalışan arkadaş derlemeleri ve ModuleAssemblyName'tir.

C# dil sürümünü belirtmenin diğer yolları için bkz. C# dili sürümü.

Bu derleyici seçeneğini program aracılığıyla ayarlama hakkında bilgi için bkz. LanguageVersion .

C# dili belirtimi

Tüm dil özelliklerini desteklemek için gereken en düşük SDK sürümü

Aşağıdaki tabloda, SDK'nın ilgili dil sürümünü destekleyen C# derleyicisi ile en düşük sürümleri listeledik:

Null Atanabilir

Null yapılabilir seçeneği, null yapılabilir bağlamı belirtmenize olanak tanır. Bu seçenek için varsayılan değer disable .

<Nullable>enable</Nullable>

Bağımsız değişken,, veya ' den biri olmalıdır enable disable warnings annotations . enableBağımsız değişkeni null yapılabilir bağlamı mümkün. Belirtildiğinde disable null yapılabilir bağlam devre dışı bırakılır. warningsBağımsız değişkeni sağlanırken null yapılabilir uyarı bağlamı etkindir. annotationsBağımsız değişkenini belirtirken, null yapılabilir ek açıklama bağlamı etkindir.

Flow analiz, çalıştırılabilir koddaki değişkenlerin null değer düzeyini çıkarsmak için kullanılır. Bir değişkenin Çıkarsanan null olabilme, değişkenin belirtilen null değer alabilme durumu değerinden bağımsızdır. Yöntem çağrıları, koşullu olarak atlanırsa bile çözümlenir. Örneğin, Debug.Assert yayın modunda.

Aşağıdaki özniteliklerle açıklama eklenmiş yöntemlerin çağrılması, akış analizini de etkiler:

• Basit ön koşullar: AllowNullAttribute ve DisallowNullAttribute
• Basit son koşullar: MaybeNullAttribute ve NotNullAttribute
• Koşullu koşul sonrası: MaybeNullWhenAttribute ve NotNullWhenAttribute
• DoesNotReturnIfAttribute (örneğin, DoesNotReturnIf(false) için Debug.Assert ) ve DoesNotReturnAttribute
• NotNullIfNotNullAttribute
• Üye son koşullar: MemberNotNullAttribute(String) ve MemberNotNullAttribute(String[])