C# ön işlemci yönergeleri

Makale
2025-01-18

Derleyicinin ayrı bir ön işlemcisi olmasa da, bu bölümde açıklanan yönergeler bir tane varmış gibi işlenir. Bunları koşullu derlemede yardımcı olması için kullanırsınız. C ve C++ yönergelerinin aksine, makro oluşturmak için bu yönergeleri kullanamazsınız. Bir satırdaki tek yönerge önişlemci yönergesi olmalıdır.

Boş değer atanabilir bağlam

#nullable önişlemci yönergesi ek açıklamalarını ve uyarınull atanabilir bağlamolarak ayarlar. Bu yönerge, null atanabilir ek açıklamaların etkili olup olmadığını ve null atanabilirlik uyarılarının verilip verilmeyeceğini denetler. Her bir bayrak ya devre dışı ya da etkin.

Her iki bağlam da öğeye öğe Nullable eklenerek proje düzeyinde (C# kaynak kodunun PropertyGroup dışında) belirtilebilir. #nullable yönergesi, ek açıklama ve uyarı bayraklarını denetler ve proje düzeyindeki ayarların önüne geçer. Yönerge, başka bir yönerge onu geçersiz kılana kadar veya kaynak dosyanın sonuna kadar denetimindeki bayrağı ayarlar.

Yönergelerin etkisi aşağıdaki gibidir:

:devre dışı bırakılabilir bağlamı ayarlar.
: Null atanabilir bağlamı etkinleştirilmiş olarakayarlar.
#nullable restore: İptal edilebilir bağlamı proje ayarlarına eski haline getirir.
: Null atanabilir bağlamdaki ek açıklamalar bayrağınıdevre dışı olarak ayarlar.
#nullable enable annotations: Null atanabilir bağlamdaki ek açıklamalar bayrağını etkinleştirilmişolarak ayarlar.
#nullable restore annotations: Null edilebilir bağlamdaki açıklama bayrağını proje ayarlarına geri yükler.
: Null değer atanabilir bağlamdaki uyarı bayrağını devre dışı olarakayarlar.
#nullable enable warnings: Null atanabilir bağlamdaki uyarı bayrağını etkinleştirilmişolarak ayarlar.
#nullable restore warnings: Null edilebilir bağlamdaki uyarı bayrağını proje ayarlarına geri yükler.

Koşullu derleme

Koşullu derlemeyi denetlemek için dört önişlemci yönergesi kullanırsınız:

#if: Kodun yalnızca belirtilen simge tanımlandığında derlendiği koşullu derlemeyi açar.
#elif: Önceki koşullu derlemeyi kapatır ve belirtilen simgenin tanımlanıp tanımlanmadığını temel alan yeni bir koşullu derleme açar.
#else: Önceki koşullu derlemeyi kapatır ve önceki belirtilen simge tanımlanmamışsa yeni bir koşullu derleme açar.
#endif: Önceki koşullu derlemeyi kapatır.

Derleme sistemi, SDK stilindeki projelerde farklı hedef çerçeveleri temsil eden önceden tanımlanmış ön işlemci sembollerinin de farkındadır. Birden fazla .NET sürümünü hedefleyebilecek uygulamalar oluştururken kullanışlıdır.

Hedef Çerçeveler	Simgeler	Ek simgeler (.NET 5+ SDK'larda kullanılabilir)	Platform simgeleri (yalnızca kullanılabilir) işletim sistemine özgü bir TFM belirttiğinizde)
.NET Framework	`NETFRAMEWORK`, `NET481`, `NET48`, , `NET472`, `NET471`, `NET47`, , `NET462`, `NET461`, `NET46`, `NET452`, `NET451`, `NET45NET40NET35`,`NET20`	`NET48_OR_GREATER`, , `NET472_OR_GREATER`, , `NET471_OR_GREATER`, `NET47_OR_GREATER`, `NET462_OR_GREATER`, , `NET461_OR_GREATER`, `NET46_OR_GREATER`, `NET452_OR_GREATERNET451_OR_GREATER`, `NET45_OR_GREATERNET40_OR_GREATER`, `NET35_OR_GREATERNET20_OR_GREATER`
.NET Standard	`NETSTANDARD`, , `NETSTANDARD2_1NETSTANDARD2_0`, , `NETSTANDARD1_6`, `NETSTANDARD1_5`, `NETSTANDARD1_4`, `NETSTANDARD1_3`, `NETSTANDARD1_2`, `NETSTANDARD1_1`,`NETSTANDARD1_0`	`NETSTANDARD2_1_OR_GREATER`, `NETSTANDARD2_0_OR_GREATER`, `NETSTANDARD1_6_OR_GREATER`, , `NETSTANDARD1_5_OR_GREATER`, `NETSTANDARD1_4_OR_GREATER`, `NETSTANDARD1_3_OR_GREATER`, `NETSTANDARD1_2_OR_GREATER`, `NETSTANDARD1_1_OR_GREATER`, `NETSTANDARD1_0_OR_GREATER`
.NET 5+ (ve .NET Core)	`NET`, `NET9_0`, `NET8_0`, , `NET7_0`, `NET6_0`, `NET5_0`, , `NETCOREAPP`, `NETCOREAPP3_1`, `NETCOREAPP3_0NETCOREAPP2_2`, `NETCOREAPP2_1NETCOREAPP2_0`, `NETCOREAPP1_1`,`NETCOREAPP1_0`	`NET8_0_OR_GREATER`, `NET7_0_OR_GREATER`, , `NET6_0_OR_GREATER`, `NET5_0_OR_GREATER`, `NETCOREAPP3_1_OR_GREATER`, `NETCOREAPP3_0_OR_GREATER`, , `NETCOREAPP2_2_OR_GREATERNETCOREAPP2_1_OR_GREATER`, `NETCOREAPP2_0_OR_GREATER`, `NETCOREAPP1_1_OR_GREATER`,`NETCOREAPP1_0_OR_GREATER`	`ANDROID`, `BROWSER`, `IOS`, , `MACCATALYST`, `MACOS`, `TVOS`, `WINDOWS`, `[OS][version]` (örneğin `IOS15_1`), `[OS][version]_OR_GREATER` (örneğin `IOS15_1_OR_GREATER`)

Not

Sürümsüz simgeler, hedeflediğiniz sürümden bağımsız olarak tanımlanır.
Sürüme özgü simgeler yalnızca hedeflediğiniz sürüm için tanımlanır.
Simgeler <framework>_OR_GREATER , hedeflediğiniz sürüm ve önceki tüm sürümler için tanımlanır. Örneğin, .NET Framework 2.0'ı hedef alıyorsanız, şu simgeler tanımlanır: NET20, NET20_OR_GREATER, NET11_OR_GREATERve NET10_OR_GREATER.
Simgeler NETSTANDARD<x>_<y>_OR_GREATER yalnızca .NET Standard hedefleri için tanımlanır, .NET Core ve .NET Framework gibi .NET Standard uygulayan hedefler için tanımlanmaz.
Bunlar MSBuild TargetFramework özelliği ve NuGet tarafından kullanılan hedef çerçeve adlarından (TFM' ler) farklıdır.

Not

Geleneksel, SDK stili olmayan projelerde, visual studio'daki farklı hedef çerçeveler için koşullu derleme simgelerini projenin özellikler sayfaları aracılığıyla el ile yapılandırmanız gerekir.

Önceden tanımlanmış diğer simgeler ve DEBUG sabitlerini içerirTRACE. kullanarak #defineproje için ayarlanan değerleri geçersiz kılabilirsiniz. Örneğin DEBUG simgesi, derleme yapılandırma özelliklerinize ("Hata Ayıklama" veya "Yayın" modu) bağlı olarak otomatik olarak ayarlanır.

C# derleyicisi, yönergesi ile #if yönergesi #endif arasındaki kodu yalnızca belirtilen simge tanımlandığında veya not işleci kullanıldığında tanımlanmadığında ! derler. C ve C++'ın aksine, bir simgeye sayısal değer atanamaz. C# dilindeki #if deyimi Boole değeridir ve yalnızca sembolün tanımlanıp tanımlanmadığını sınar. Örneğin, tanımlandığında DEBUG aşağıdaki kod derlenmiş:

#if DEBUG
    Console.WriteLine("Debug version");
#endif

Aşağıdaki kod tanımlanmadığında MYTEST derlenmiş:

#if !MYTEST
    Console.WriteLine("MYTEST is not defined");
#endif

veya ==değerlerini test etmek için işleçleri!=bool ve true kullanabilirsiniz. true simgenin tanımlandığı anlamına gelir. deyimi #if DEBUG ile aynı anlama sahiptir #if (DEBUG == true). birden çok simgenin tanımlanıp tanımlanmadığını değerlendirmek için && (ve), || (veya)ve ! (değil) işleçlerini kullanabilirsiniz. Simgeleri ve işleçleri ayraçlarla da gruplandırabilirsiniz.

Aşağıdaki örnekte kodunuzun geriye dönük uyumlu kalırken daha yeni .NET özelliklerinden yararlanmasını sağlayan karmaşık bir yönerge gösterilmektedir. Örneğin, kodunuzda bir NuGet paketi kullandığınızı, ancak paketin yalnızca .NET 6 ve yukarısını desteklediğini ve .NET Standard 2.0 ve daha yüksek bir sürümü desteklediğini düşünün:

#if (NET6_0_OR_GREATER || NETSTANDARD2_0_OR_GREATER)
    Console.WriteLine("Using .NET 6+ or .NET Standard 2+ code.");
#else
    Console.WriteLine("Using older code that doesn't support the above .NET versions.");
#endif

#if, , , #else, #elif, #endifve #define yönergeleriyle #undefbirlikte, bir veya daha fazla simgenin varlığına bağlı olarak kod eklemenize veya hariç tutmanıza olanak tanır. Koşullu derleme, hata ayıklama derlemesi için kod derlerken veya belirli bir yapılandırma için derleme yaparken yararlı olabilir.

#elif bileşik bir koşullu yönerge oluşturmanıza olanak tanır. Önceki #if ya da önceki, isteğe bağlı, #elif yönerge ifadelerinin hiçbiri trueolarak değerlendirilmezse, #elif ifadesi değerlendirilir. bir #elif ifade olarak değerlendirilirse true, derleyici ile sonraki koşullu yönerge arasındaki #elif tüm kodu değerlendirir. Örneğin:

#define VC7
//...
#if DEBUG
    Console.WriteLine("Debug build");
#elif VC7
    Console.WriteLine("Visual Studio 7");
#endif

#else bileşik bir koşullu yönerge oluşturmanıza olanak tanır; böylece, yukarıdaki #if veya (isteğe bağlı) #elif yönergelerdeki ifadelerden hiçbiri değerini değerlendirmezse true, derleyici ile arasında #else#endiftüm kodu değerlendirir. #endif(#endif) sonrasındaki #elsesonraki önişlemci yönergesi olmalıdır.

#endif , yönergesiyle başlayan bir koşullu yönergenin #if sonunu belirtir.

Aşağıdaki örnekte, bir dosyada simge tanımlama MYTEST ve ardından ve MYTEST simgelerinin DEBUG değerlerini test etme adımları gösterilmektedir. Bu örneğin çıktısı, projeyi Hata Ayıklama veya Sürüm yapılandırma modunda oluşturup oluşturmadığınıza bağlıdır.

#define MYTEST
using System;
public class MyClass
{
    static void Main()
    {
#if (DEBUG && !MYTEST)
        Console.WriteLine("DEBUG is defined");
#elif (!DEBUG && MYTEST)
        Console.WriteLine("MYTEST is defined");
#elif (DEBUG && MYTEST)
        Console.WriteLine("DEBUG and MYTEST are defined");
#else
        Console.WriteLine("DEBUG and MYTEST are not defined");
#endif
    }
}

Aşağıdaki örnekte, mümkün olduğunda daha yeni API'leri kullanabilmek için farklı hedef çerçeveleri test etme adımları gösterilmektedir:

public class MyClass
{
    static void Main()
    {
#if NET40
        WebClient _client = new WebClient();
#else
        HttpClient _client = new HttpClient();
#endif
    }
    //...
}

Sembolleri tanımlama

Koşullu derleme sembollerini tanımlamak veya tanımlamak için aşağıdaki iki önişlemci yönergesini kullanırsınız:

#define: Bir simge tanımlayın.
#undef: Bir simgenin tanımlarını kaldırın.

Bir simge tanımlamak için kullanırsınız #define . #if yönergesine geçirilen ifade olarak sembolünü kullandığınızda, ifade aşağıdaki örnekte gösterildiği gibi trueolarak değerlendirilir:

#define VERBOSE

#if VERBOSE
   Console.WriteLine("Verbose output version");
#endif

Not

C# dilinde temel sabitler anahtar sözcüğü kullanılarak const tanımlanmalıdır. Bildirim const , çalışma zamanında değiştirilmeyecek bir static üye oluşturur. yönergesi #define , genellikle C ve C++'da yapılan sabit değerleri bildirmek için kullanılamaz. Bu tür sabitleriniz varsa, bunları tutmak için ayrı bir "Sabitler" sınıfı oluşturmayı göz önünde bulundurun.

Semboller, derleme koşullarını belirtmek için kullanılabilir. simgesi için veya #ifile #elif test edebilirsiniz. Koşullu derleme gerçekleştirmek için de ConditionalAttribute kullanabilirsiniz. Simge tanımlayabilirsiniz, ancak simgeye değer atayamazsınız. Önişlemci #define yönergeleri olmayan yönergeleri kullanmadan önce yönergenin dosyada görünmesi gerekir. DefineConstants derleyici seçeneğiyle bir simge de tanımlayabilirsiniz. ile #undefbir simgenin tanımlarını kaldırabilirsiniz.

Bölgeleri tanımlama

Aşağıdaki iki önişlemci yönergesini kullanarak bir ana hat içinde daraltılabilir kod bölgeleri tanımlayabilirsiniz:

#region: Bir bölge başlatın.
#endregion: Bir bölgeyi sonlandırma.

#region, kod düzenleyicisinin ana hat özelliğini kullanırken genişletebileceğiniz veya daraltabileceğiniz bir kod bloğu belirtmenize olanak tanır. Daha uzun kod dosyalarında, dosyanın üzerinde çalışmakta olduğunuz bölümüne odaklanabilmeniz için bir veya daha fazla bölgeyi daraltmak veya gizlemek kullanışlıdır. Aşağıdaki örnekte bir bölgenin nasıl tanımlanacağı gösterilmektedir:

#region MyClass definition
public class MyClass
{
    static void Main()
    {
    }
}
#endregion

Bir #region bloğun bir #endregion yönergeyle sonlandırılması gerekir. Blok #region , bir #if blokla örtüşemez. Bununla birlikte, bir #region blok bir #if bloğun içine yerleştirilebilir ve bir #if blok da bir #region bloğun içine iç içe yerleştirilebilir.

Hata ve uyarı bilgileri

Derleyiciye kullanıcı tanımlı derleyici hataları ve uyarıları oluşturmasını ve aşağıdaki yönergeleri kullanarak satır bilgilerini denetlemesini bildirirsiniz:

#error: Belirtilen iletiyle bir derleyici hatası oluşturun.
#warning: Belirli bir iletiyle bir derleyici uyarısı oluşturun.
#line: Derleyici iletileriyle yazdırılan satır numarasını değiştirin.

#error kodunuzda belirli bir konumdan CS1029 kullanıcı tanımlı bir hata oluşturmanıza olanak tanır. Örneğin:

#error Deprecated code in this method.

Not

Derleyici özel bir şekilde davranır #error version ve kullanılan derleyici ve dil sürümlerini içeren bir iletiyle cs8304 derleyici hatasını bildirir.

#warning , kodunuzda belirli bir konumdan CS1030 düzeyinde bir derleyici uyarısı oluşturmanıza olanak tanır. Örneğin:

#warning Deprecated code in this method.

#line derleyicinin satır numaralandırmasını ve (isteğe bağlı olarak) hata ve uyarılar için dosya adı çıkışını değiştirmenize olanak tanır.

Aşağıdaki örnek, satır numaralarıyla ilişkili iki uyarının nasıl rapor yapılacağını gösterir. #line 200 yönergesi, sonraki satırın numarasını 200 (varsayılan değer #6 olmasına rağmen) olarak zorlar ve sonraki #line yönergesine kadar dosya adı "Özel" olarak bildirilir. #line default yönergesi, satır numaralandırmasını varsayılan numaralandırmasına döndürür ve bu da önceki yönergeye göre yeniden numaralandırılmış satırları sayar.

class MainClass
{
    static void Main()
    {
#line 200 "Special"
        int i;
        int j;
#line default
        char c;
        float f;
#line hidden // numbering not affected
        string s;
        double d;
    }
}

Derleme aşağıdaki çıkışı oluşturur:

Special(200,13): warning CS0168: The variable 'i' is declared but never used
Special(201,13): warning CS0168: The variable 'j' is declared but never used
MainClass.cs(9,14): warning CS0168: The variable 'c' is declared but never used
MainClass.cs(10,15): warning CS0168: The variable 'f' is declared but never used
MainClass.cs(12,16): warning CS0168: The variable 's' is declared but never used
MainClass.cs(13,16): warning CS0168: The variable 'd' is declared but never used

yönergesi #line , derleme işleminde otomatik, ara bir adımda kullanılabilir. Örneğin, satırlar özgün kaynak kod dosyasından kaldırıldıysa ancak yine de derleyicinin dosyasındaki özgün satır numaralandırmasına göre çıkış oluşturmasını istiyorsanız, satırları kaldırabilir ve ardından ile #lineözgün satır numaralandırmasının benzetimini yapabilirdiniz.

yönergesi #line hidden , hata ayıklayıcıdan ardışık satırları gizler; böylece geliştirici kodda adım attığında, a #line hidden ile sonraki #line yönerge arasındaki tüm satırlar (başka bir #line hidden yönerge olmadığı varsayılarak) üzerine basılır. Bu seçenek, ASP.NET kullanıcı tanımlı ve makine tarafından oluşturulan kod arasında ayrım yapmak için de kullanılabilir. bu özelliğin birincil tüketicisi ASP.NET olsa da, büyük olasılıkla daha fazla kaynak oluşturucu bu özelliği kullanmaktadır.

Yönerge #line hidden , hata raporlamadaki dosya adlarını veya satır numaralarını etkilemez. Başka bir ifadeyle, derleyici gizli bir blokta hata bulursa, derleyici hatanın geçerli dosya adını ve satır numarasını bildirir.

yönergesi #line filename , derleyici çıkışında görünmesini istediğiniz dosya adını belirtir. Varsayılan olarak, kaynak kod dosyasının gerçek adı kullanılır. Dosya adı çift tırnak işareti ("") içinde olmalı ve bir satır numarasını izlemelidir.

#line yönergesinin yeni bir biçimini kullanabilirsiniz:

#line (1, 1) - (5, 60) 10 "partial-class.cs"
/*34567*/int b = 0;

Bu formun bileşenleri şunlardır:

(1, 1): Yönergeyi izleyen satırdaki ilk karakterin başlangıç satırı ve sütunu. Bu örnekte, sonraki satır 1. satır, sütun 1 olarak bildirilir.
(5, 60): İşaretli bölgenin bitiş satırı ve sütunu.
10: Yönergenin #line etkili olması için sütun uzaklığı. Bu örnekte, 10. sütun birinci sütun olarak bildirilir. Bildirim int b = 0; bu sütunda başlar. Bu alan isteğe bağlıdır. Belirtilmezse, yönerge ilk sütunda geçerlilik kazanır.
"partial-class.cs": Çıkış dosyasının adı.

Yukarıdaki örnek aşağıdaki uyarıyı oluşturur:

partial-class.cs(1,5,1,6): warning CS0219: The variable 'b' is assigned but its value is never used

Yeniden eşledikten sonra değişkeni, bdosyasının partial-class.csilk satırında, altıncı karakterdedir.

Etki alanına özgü diller (DLL'ler) genellikle kaynak dosyadan oluşturulan C# çıkışına daha iyi bir eşleme sağlamak için bu biçimi kullanır. Bu genişletilmiş #line yönergesinin en yaygın kullanımı, oluşturulan bir dosyada görünen uyarıları veya hataları özgün kaynakla yeniden eşlemektir. Örneğin, şu razor sayfasını göz önünde bulundurun:

@page "/"
Time: @DateTime.NowAndThen

özelliği DateTime.Now olarak DateTime.NowAndThenyanlış yazıldı. Bu razor kod parçacığı için oluşturulan C# öğesinde page.g.csaşağıdaki gibi görünür:

  _builder.Add("Time: ");
#line (2, 6) - (2, 27) 15 "page.razor"
  _builder.Add(DateTime.NowAndThen);

Yukarıdaki kod parçacığı için derleyici çıkışı:

page.razor(2, 2, 2, 27)error CS0117: 'DateTime' does not contain a definition for 'NowAndThen'

page.razor'daki 2. satır, 6. sütun, metin @DateTime.NowAndThen'in (2, 6) tarafından yönergede belirtildiği yerde başladığı yerdir. @DateTime.NowAndThen alanı, yönergedeki (2, 27) tarafından belirtildiği gibi 2. satır, 27. sütunda sona erer. DateTime.NowAndThen metni, yönergede 15 tarafından işaretlendiği gibi page.g.cs'in 15. sütununda başlar. Derleyici, hatanın page.razorkonumunda olduğunu bildirir. Geliştirici, oluşturulan kaynakta değil doğrudan kaynak kodundaki hataya gidebilir.

Bu biçimin diğer örneklerini görmek için örnekler bölümündeki özellik belirtimine bakın.

Pragmalar

#pragma derleyiciye, göründüğü dosyanın derlenmesi için özel yönergeler verir. Derleyici, kullandığınız pragmaları desteklemelidir. Başka bir deyişle, özel ön işleme yönergeleri oluşturmak için kullanamazsınız #pragma .

#pragma warning: Uyarıları etkinleştirin veya devre dışı bırakın.
#pragma checksum: Sağlama toplamı oluşturun.

#pragma pragma-name pragma-arguments

Burada pragma-name tanınan bir pragmanın adı ve pragma-arguments pragma özgü bağımsız değişkenlerdir.

#pragma uyarısı

#pragma warning bazı uyarıları etkinleştirebilir veya devre dışı bırakabilir. #pragma warning disable format ve #pragma warning enable format, Visual Studio'nun kod bloklarını nasıl biçimlendirdiğini denetler.

#pragma warning disable warning-list
#pragma warning restore warning-list

burada warning-list, 414, CS3021gibi uyarı numaralarının virgülle ayrılmış bir listesidir. "CS" ön eki isteğe bağlıdır. Hiçbir uyarı numarası belirtilmediğinde, disable tüm uyarıları devre dışı bırakır ve restore tüm uyarıları etkinleştirir.

Not

Visual Studio'da uyarı numaralarını bulmak için projenizi derleyin ve çıkış penceresinde uyarı numaralarını arayın.

, disable kaynak dosyanın bir sonraki satırından başlayarak geçerlilik kazanır. Uyarı, öğesini izleyen satıra restoregeri yüklenir. Dosyada yoksa restore , uyarılar aynı derlemedeki sonraki dosyaların ilk satırında varsayılan durumlarına geri yüklenir.

// pragma_warning.cs
using System;

#pragma warning disable 414, CS3021
[CLSCompliant(false)]
public class C
{
    int i = 1;
    static void Main()
    {
    }
}
#pragma warning restore CS3021
[CLSCompliant(false)]  // CS3021
public class D
{
    int i = 1;
    public static void F()
    {
    }
}

warning pragması'nın başka bir biçimi, kod bloklarında Visual Studio biçimlendirme komutlarını devre dışı bırakır veya geri yükler:

#pragma warning disable format
#pragma warning restore format

Visual Studio biçim komutları, disable format etkin olduğu kod bloklarındaki metinleri değiştirmez. Ctrl+K, Ctrl+Dgibi biçim komutları bu kod bölgelerini değiştirmez. Bu pragma, kodunuzun görsel sunumu üzerinde ayrıntılı denetim sağlar.

#pragma sağlama toplamı

ASP.NET sayfalarında hata ayıklamaya yardımcı olması için kaynak dosyalar için sağlama toplamları oluşturur.

#pragma checksum "filename" "{guid}" "checksum bytes"

Burada "filename" , değişikliklerin veya güncelleştirmelerin izlenmesini gerektiren dosyanın adı, "{guid}" karma algoritmasının Genel Benzersiz Tanımlayıcısı (GUID) ve "checksum_bytes" sağlama toplamının baytlarını temsil eden onaltılık basamak dizesidir. Çift sayıda onaltılık basamak olmalıdır. Tek sayıda basamak derleme zamanı uyarısına neden olur ve yönergesi yoksayılır.

Visual Studio hata ayıklayıcısı, her zaman doğru kaynağı bulduğundan emin olmak için bir sağlama toplamı kullanır. Derleyici bir kaynak dosyanın sağlama toplamını hesaplar ve ardından çıkışı program veritabanı (PDB) dosyasına yayar. Hata ayıklayıcısı daha sonra PDB'yi kullanarak kaynak dosya için hesaplayan sağlama toplamıyla karşılaştırır.

Hesaplanan sağlama toplamı .aspx dosyası yerine oluşturulan kaynak dosyaya yönelik olduğundan bu çözüm ASP.NET projelerde çalışmaz. Bu sorunu gidermek için ASP.NET #pragma checksum sayfaları için sağlama toplamı desteği sağlar.

Visual C# içinde bir ASP.NET projesi oluşturduğunuzda, oluşturulan kaynak dosya kaynağın oluşturulduğu .aspx dosyası için bir sağlama toplamı içerir. Derleyici daha sonra bu bilgileri PDB dosyasına yazar.

Derleyici dosyada bir #pragma checksum yönerge bulamazsa sağlama toplamını hesaplar ve değeri PDB dosyasına yazar.

class TestClass
{
    static int Main()
    {
        #pragma checksum "file.cs" "{406EA660-64CF-4C82-B6F0-42D48172A799}" "ab007f1d23d9" // New checksum
    }
}

Aracılığıyla paylaş