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

Aşağıdaki seçenekler, derleyicinin dil özelliklerini nasıl yorumlayacını denetler. Yeni MSBuild söz dizimi Kalın olarak gösterilir. Eski csc.exe söz dizimi içinde code stylegösterilir.

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

CheckForOverflowUnderflow

CheckForOverflowUnderflow seçeneği, tamsayı aritmetik taşması durumunda program davranışını tanımlayan varsayılan taşma denetimi bağlamını denetler.

<CheckForOverflowUnderflow>true</CheckForOverflowUnderflow>

CheckForOverflowUnderflow olduğundatrue, varsayılan bağlam denetlenen bir bağlamdır ve taşma denetimi etkinleştirilir; aksi takdirde, varsayılan bağlam denetlenmeyen bir bağlamdır. Bu seçeneğin varsayılan değeri, falseyani taşma denetiminin devre dışı bırakıldığını gösterir.

Ayrıca ve unchecked deyimlerini kullanarak kodunuzun bölümleri için taşma denetimi bağlamını checked açıkça denetleyebilirsiniz.

Taşma denetimi bağlamı işlemleri nasıl etkiler ve hangi işlemlerin etkilendiği hakkında bilgi için ve unchecked deyimleri hakkındaki checked makaleye bakın.

AllowUnsafeBlocks

AllowUnsafeBlocks derleyici seçeneği, derlemek için güvenli olmayan anahtar sözcüğü kullanan koda izin verir. Bu seçeneğin varsayılan değeri olan false, güvenli olmayan koda izin verilmediğinden.

<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, programınızın tüm kaynak kodu dosyalarındaki simgeleri tanımlar.

<DefineConstants>name;name2</DefineConstants>

Bu seçenek, tanımlamak istediğiniz bir veya daha fazla simgenin adını belirtir. DefineConstants seçeneği, derleyici seçeneğinin projedeki tüm dosyalar için geçerli olması dışında #define önişlemci yönergesi ile aynı etkiye sahiptir. Kaynak dosyadaki bir #undef yönergesi tanımı kaldırana kadar kaynak dosyada bir simge tanımlanır. seçeneğini kullandığınızda -define , bir dosyadaki yönergenin #undef projedeki diğer kaynak kodu dosyaları üzerinde hiçbir etkisi olmaz. Kaynak dosyaları koşullu olarak derlemek için bu seçenek tarafından oluşturulan simgeleri #if, #else, #elif ve #endif kullanabilirsiniz. C# derleyicisinin kendisi, kaynak kodunuzda kullanabileceğiniz hiçbir simge veya makro tanımlamaz; tüm sembol tanımları kullanıcı tanımlı olmalıdır.

LangVersion

C# derleyicisinin varsayılan dil sürümü, uygulamanızın hedef çerçevesine ve yüklü SDK veya Visual Studio sürümüne bağlıdır. Bu kurallar C# dil sürümü oluşturmada tanımlanır.

LangVersion seçeneği, derleyicinin yalnızca belirtilen C# dil belirtimine dahil edilen söz dizimini kabul etmesine neden olur, örneğin:

<LangVersion>9.0</LangVersion>

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

Dikkat edilmesi gereken noktalar

• Projenizin hedef çerçeveniz için önerilen varsayılan derleyici sürümünü kullandığından emin olmak için LangVersion seçeneğini kullanmayın. Daha yeni dil özelliklerine erişmek için hedef çerçeveyi güncelleştirebilirsiniz.

• Değerle LangVersion belirtilmesi default , LangVersion seçeneğinin atlanmasından farklıdır. Belirtme, default hedef çerçeveyi hesaba katmadan derleyicinin desteklediği dilin en son sürümünü kullanır. Örneğin, Visual Studio sürüm 17.6'dan .NET 6'yı hedefleyen bir proje oluştururken, LangVersion belirtilmezse C# 10 kullanılır ancak LangVersion olarak ayarlanırsa defaultC# 11 kullanılır.

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

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

• C# sürüm güncelleştirmeleri genel olarak büyük .NET sürümleriyle aynı olsa da, yeni söz dizimi ve özelliklerin bu belirli çerçeve sürümüne bağlı olması şart değildir. Belirli her özelliğin, NuGet paketlerini veya diğer kitaplıkları dahil ederek 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ı kullandığınızdan bağımsız olarak, .exe veya .dll oluşturmak için ortak dil çalışma zamanının geçerli sürümünü kullanın. Bir özel durum, -langversion:ISO-1 altında çalışan arkadaş derlemeleri ve ModuleAssemblyName'dir.

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

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, ilgili dil sürümünü destekleyen C# derleyicisi ile SDK'nın en düşük sürümleri listelenmektedir:

Null Atanabilir

Null atanabilir seçeneği, null atanabilir bağlamı belirtmenize olanak tanır. Aşağıdaki etiket kullanılarak projenin yapılandırmasında <Nullable> ayarlanabilir:

<Nullable>enable</Nullable>

Bağımsız değişken , , disablewarningsveya annotations' lerden enablebiri olmalıdır. enable bağımsız değişkeni null atanabilir bağlamı etkinleştirir. Belirtilmesi disable , null atanabilir bağlamı devre dışı bırakır. Bağımsız değişkenini belirttiğinizde warnings , null atanabilir uyarı bağlamı etkinleştirilir. Bağımsız değişkeni belirttiğinizde annotations , boş değer atanabilir ek açıklama bağlamı etkinleştirilir. Değerler Null atanabilir bağlamlar makalesinde açıklanmıştır ve açıklanmıştır. Boş değer atanabilir geçiş stratejileri makalemizde mevcut bir kod tabanında null atanabilir başvuru türlerini etkinleştirmeyle ilgili görevler hakkında daha fazla bilgi edinebilirsiniz.

Akış analizi yürütülebilir kod içindeki değişkenlerin null atanabilirliğini çıkarsamak için kullanılır. Bir değişkenin çıkarsanan null atanabilirliği, değişkenin bildirilen null atanabilirlik özelliğinden bağımsızdır. Yöntem çağrıları koşullu olarak atlandığında bile analiz edilir. Örneğin, Debug.Assert yayın modunda.

Aşağıdaki özniteliklerle ek açıklamalı 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 son koşullar: MaybeNullWhenAttribute ve NotNullWhenAttribute
• DoesNotReturnIfAttribute (örneğin, DoesNotReturnIf(false) için Debug.Assert) ve DoesNotReturnAttribute
• NotNullIfNotNullAttribute
• Üye son koşulları: MemberNotNullAttribute(String) ve MemberNotNullAttribute(String[])