Csc görevi

csc.exe dosyasını sarmalar ve yürütülebilir dosyalar (.exe dosyaları), dinamik bağlantı kitaplıkları (.dll dosyaları) veya kod modülleri (.netmodule dosyaları) oluşturur. csc.exe hakkında daha fazla bilgi için bkz. C# derleyici seçenekleri.

Parametreler

Aşağıdaki tabloda görevin parametreleri Csc açıklanmaktadır.

Parametre	Tanım
AdditionalLibPaths	İsteğe bağlı String[] parametre. Başvuruları aramak için ek dizinler belirtir. Daha fazla bilgi için bkz . -lib (C# derleyici seçenekleri).
AddModules	İsteğe bağlı String parametre. Derlemenin parçası olacak bir veya daha fazla modülü belirtir. Daha fazla bilgi için bkz . -addmodule (C# derleyici seçenekleri).
AllowUnsafeBlocks	İsteğe bağlı Boolean parametre. isetrue, güvenli olmayan anahtar sözcüğünü kullanan kodu derler. Daha fazla bilgi için bkz . -unsafe (C# derleyici seçenekleri).
ApplicationConfiguration	İsteğe bağlı String parametre. Derleme bağlama ayarlarını içeren uygulama yapılandırma dosyasını belirtir.
BaseAddress	İsteğe bağlı String parametre. DLL'nin yüklendiği tercih edilen temel adresi belirtir. DLL için varsayılan temel adres .NET Framework ortak dil çalışma zamanı tarafından ayarlanır. Daha fazla bilgi için bkz . -baseaddress (C# derleyici seçenekleri).
CheckForOverflowUnderflow	İsteğe bağlı Boolean parametre. Veri türünün sınırlarını aşan tamsayı aritmetiğinin çalışma zamanında bir özel duruma neden olup olmadığını belirtir. Daha fazla bilgi için bkz . -checked (C# derleyici seçenekleri).
ChecksumAlgorithm	İsteğe bağlı String parametre. PDB dosyasında depolanan kaynak dosya sağlama toplamını hesaplama algoritmasını belirtir. Algoritma SHA1 (varsayılan) veya SHA256 olmalıdır. Bkz . ChecksumAlgorithm.
CodeAnalysisRuleset	İsteğe bağlı String parametre. Belirli tanılamaları devre dışı bırakabilen bir kural kümesi dosyası belirtir. Bkz. CodeAnalysisRuleset.
CodePage	İsteğe bağlı Int32 parametre. Derlemedeki tüm kaynak kod dosyaları için kullanılacak kod sayfasını belirtir. Daha fazla bilgi için bkz . -codepage (C# derleyici seçenekleri).
DebugType	İsteğe bağlı String parametre. Hata ayıklama türünü belirtir. DebugTypeveya pdbonlyolabilirfull. Hata ayıklayıcının çalışan bir programa eklenmesini sağlayan varsayılan değerdir full. Belirtilmesi pdbonly , program hata ayıklayıcıda başlatıldığında kaynak kodu hata ayıklamasını etkinleştirir, ancak yalnızca çalışan program hata ayıklayıcıya eklendiğinde derleyiciyi görüntüler. Bu parametre parametresini EmitDebugInformation geçersiz kılar. Daha fazla bilgi için bkz . -debug (C# derleyici seçenekleri).
DefineConstants	İsteğe bağlı String parametre. Ön işlemci simgelerini tanımlar. Daha fazla bilgi için bkz . -define (C# derleyici seçenekleri).
DelaySign	İsteğe bağlı Boolean parametre. ise true, yalnızca ortak anahtarı derlemeye yerleştirmek istediğinizi belirtir. ise false, tam imzalı bir derleme istediğinizi belirtir Veya KeyContainer parametresiyle kullanılmadığı sürece bu parametrenin KeyFile hiçbir etkisi yoktur. Daha fazla bilgi için bkz . -delaysign (C# derleyici seçenekleri).
Deterministic	İsteğe bağlı Boolean parametre. ise true, girişler özdeşse derlemeler arasında ikili içeriği aynı olan bir derlemenin derleyicinin çıkışını oluşturmasına neden olur. Daha fazla bilgi için bkz . -deterministic (C# Derleyici seçenekleri).
DisabledWarnings	İsteğe bağlı String parametre. Devre dışı bırakılacak uyarıların listesini belirtir. Daha fazla bilgi için bkz . -nowarn (C# derleyici seçenekleri).
DocumentationFile	İsteğe bağlı String parametre. Belge açıklamalarını bir XML dosyasına işler. Daha fazla bilgi için bkz . -doc (C# derleyici seçenekleri).
EmbedAllSources	İsteğe bağlı Boolean parametre. Tüm kaynak dosyaları PDB'ye ekleyin. Daha fazla bilgi için bkz. -embed (C# derleyici seçenekleri)
EmitDebugInformation	İsteğe bağlı Boolean parametre. ise true, görev hata ayıklama bilgileri oluşturur ve bunu bir program veritabanı (.pdb) dosyasına yerleştirir. ise false, görev hata ayıklama bilgisi yaymaz. Varsayılan false değeridir. Daha fazla bilgi için bkz . -debug (C# derleyici seçenekleri).
ErrorLog	İsteğe bağlı String parametre. Tüm derleyici ve çözümleyici tanılamalarını günlüğe kaydetmek için bir dosya belirtir. Bkz. ErrorLog.
ErrorReport	İsteğe bağlı String parametre. C# iç hatasını Microsoft'a bildirmek için kullanışlı bir yol sağlar. Bu parametrenin değeri prompt, sendveya noneolabilir. parametresi olarak ayarlanırsa prompt, bir iç derleyici hatası oluştuğunda bir istem alırsınız. İstem, microsoft'a elektronik olarak bir hata raporu göndermenizi sağlar. parametresi olarak ayarlanırsa send, otomatik olarak bir hata raporu gönderilir. parametresi olarak ayarlanırsa none, hata yalnızca derleyicinin metin çıkışında bildirilir. Varsayılan none değeridir. Daha fazla bilgi için bkz . -errorreport (C# derleyici seçenekleri).
FileAlignment	İsteğe bağlı Int32 parametre. Çıkış dosyasındaki bölümlerin boyutunu belirtir. Daha fazla bilgi için bkz . -filealign (C# derleyici seçenekleri).
GenerateFullPaths	İsteğe bağlı Boolean parametre. ise true, derleyici çıktısında dosyanın mutlak yolunu belirtir. ise false, dosyanın adını belirtir. Varsayılan false değeridir. Daha fazla bilgi için bkz . -fullpaths (C# derleyici seçenekleri).
HighEntropyVA	İsteğe bağlı Boolean parametre Yüksek entropi Adres Alanı Düzeni Rastgele Seçimini (ASLR) etkinleştirin. Bkz. HighEntropyVA.
KeyContainer	İsteğe bağlı String parametre. Şifreleme anahtarı kapsayıcısının adını belirtir. Daha fazla bilgi için bkz . -keycontainer (C# derleyici seçenekleri).
KeyFile	İsteğe bağlı String parametre. Şifreleme anahtarını içeren dosya adını belirtir. Daha fazla bilgi için bkz . -keyfile (C# derleyici seçenekleri).
LangVersion	İsteğe bağlı String parametre. Kullanılacak dilin sürümünü belirtir. Daha fazla bilgi için bkz . -langversion (C# derleyici seçenekleri).
LinkResources	İsteğe bağlı ITaskItem[] parametre. Çıkış dosyasında bir .NET Framework kaynağına bağlantı oluşturur; kaynak dosyası çıkış dosyasına yerleştirilmemiştir. Bu parametreye geçirilen öğeler ve Accessadlı LogicalName isteğe bağlı meta veri girişlerine sahip olabilir. LogicalName anahtarın parametresine identifier /linkresource karşılık gelir ve Access parametresine accessibility-modifier karşılık gelir. Daha fazla bilgi için bkz . -linkresource (C# derleyici seçenekleri).
MainEntryPoint	İsteğe bağlı String parametre. yönteminin Main konumunu belirtir. Daha fazla bilgi için bkz . -main (C# derleyici seçenekleri).
ModuleAssemblyName	İsteğe bağlı String parametre. Bu modülün parçası olacağı derlemenin adını belirtir.
NoConfig	İsteğe bağlı Boolean parametre. isetrue, derleyiciye csc.rsp dosyasıyla derlememelerini söyler. Daha fazla bilgi için bkz . -noconfig (C# derleyici seçenekleri).
NoLogo	İsteğe bağlı Boolean parametre. ise true, derleyici başlık bilgilerinin görüntülenmesini engeller. Daha fazla bilgi için bkz . -nologo (C# derleyici seçenekleri).
NoStandardLib	İsteğe bağlı Boolean parametre. isetrue, sistem ad alanının tamamını tanımlayan mscorlib.dll dosyasının içeri aktarılmasını engeller. Kendi Sistem ad alanınızı ve nesnelerinizi tanımlamak veya oluşturmak istiyorsanız bu parametreyi kullanın. Daha fazla bilgi için bkz . -nostdlib (C# derleyici seçenekleri).
NoWin32Manifest	İsteğe bağlı Boolean parametre. ise true, varsayılan Win32 bildirimini eklemeyin.
Nullable	İsteğe bağlı String parametre. Null atanabilir bağlamı belirtir. Bağımsız değişken , , disablewarningsveya annotations' lerden enablebiri olmalıdır. Bkz. Null atanabilir.
Optimize	İsteğe bağlı Boolean parametre. ise true, iyileştirmeleri etkinleştirir. ise false, iyileştirmeleri devre dışı bırakır. Daha fazla bilgi için bkz . -optimize (C# derleyici seçenekleri).
OutputAssembly	İsteğe bağlı String çıkış parametresi. Çıkış dosyasının adını belirtir. Daha fazla bilgi için bkz . -out (C# derleyici seçenekleri).
OutputRefAssembly	İsteğe bağlı String parametre. Çıkış başvurusu derleme dosyasının adını belirtir. Daha fazla bilgi için bkz . -refout (C# derleyici seçenekleri).
PathMap	İsteğe bağlı String parametre. Fiziksel yolların derleyici tarafından çıkış olarak kaynak yol adlarına nasıl eş yapılacağını belirtir. Bkz. PathMap.
PdbFile	İsteğe bağlı String parametre. Hata ayıklama bilgileri dosya adını belirtir. Varsayılan ad, .pdb uzantısına sahip çıktı dosyası adıdır.
Platform	İsteğe bağlı String parametre. Çıkış dosyası tarafından hedeflenecek işlemci platformunu belirtir. Bu parametrenin değeri x86, x64veya anycpuolabilir. Varsayılan anycpu değeridir. Daha fazla bilgi için bkz . -platform (C# derleyici seçenekleri).
PreferredUILang	İsteğe bağlı String parametre. C# derleyicisinin hata iletileri gibi çıktıyı görüntülediği dili belirtir. Bkz. PreferredUILang.
PublicSign	İsteğe bağlı Boolean parametre. Çıkış derlemesini genel olarak imzalayın. Bkz. PublicSign.
References	İsteğe bağlı ITaskItem[] parametre. Görevin belirtilen öğelerden geçerli projeye genel tür bilgilerini içeri aktarmasına neden olur. Daha fazla bilgi için bkz . -reference (C# derleyici seçenekleri). Meta verileri Aliases özgün "Başvuru" öğesine ekleyerek MSBuild dosyasında bir C# başvuru diğer adı belirtebilirsiniz. Örneğin, aşağıdaki Csc komut satırında "LS1" diğer adını ayarlamak için: CSC /r:LS1=MyCodeLibrary.dll /r:LS2=MyCodeLibrary2.dll *.cs şunu kullanırsınız: <Reference Include="MyCodeLibrary"> <Aliases>LS1</Aliases> </Reference>
RefOnly	İsteğe bağlı Boolean parametre. Birincil çıkış olarak tam derleme yerine bir başvuru derlemesi oluşturun. Bkz . ProduceOnlyReferenceAssembly.
ReportAnalyzer	İsteğe bağlı Boolean parametre. Yürütme süresi gibi ek çözümleyici bilgilerini bildirin. Bkz. ReportAnalyzer.
Resources	İsteğe bağlı ITaskItem[] parametre. Çıkış dosyasına bir .NET Framework kaynağı ekler. Bu parametreye geçirilen öğeler ve Accessadlı LogicalName isteğe bağlı meta veri girişlerine sahip olabilir. LogicalName anahtarın parametresine identifier /resource karşılık gelir ve Access parametresine accessibility-modifier karşılık gelir. Daha fazla bilgi için bkz . -resource (C# derleyici seçenekleri).
ResponseFiles	İsteğe bağlı String parametre. Bu görev için komutları içeren yanıt dosyasını belirtir. Daha fazla bilgi için bkz . @ (Yanıt dosyasını belirtme).
Sources	İsteğe bağlı ITaskItem[] parametre. Bir veya daha fazla C# kaynak dosyası belirtir.
TargetType	İsteğe bağlı String parametre. Çıkış dosyasının dosya biçimini belirtir. Bu parametre, bir librarykod kitaplığı oluşturan, exebir konsol uygulaması moduleoluşturan , bir modül oluşturan veya winexebir Windows programı oluşturan değeri olabilir. library varsayılan değerdir. Daha fazla bilgi için bkz . -target (C# derleyici seçenekleri).
TreatWarningsAsErrors	İsteğe bağlı Boolean parametre. ise true, tüm uyarıları hata olarak ele alır. Daha fazla bilgi için bkz . -warnaserror (C# derleyici seçenekleri).
UseHostCompilerIfAvailable	İsteğe bağlı Boolean parametre. Varsa, göreve işlem içi derleyici nesnesini kullanma talimatını verirseniz. Yalnızca Visual Studio tarafından kullanılır.
Utf8Output	İsteğe bağlı Boolean parametre. UTF-8 kodlaması kullanarak derleyici çıkışını günlüğe kaydeder. Daha fazla bilgi için bkz . -utf8output (C# derleyici seçenekleri).
WarningLevel	İsteğe bağlı Int32 parametre. Derleyicinin görüntüleneceği uyarı düzeyini belirtir. Daha fazla bilgi için bkz . -warn (C# derleyici seçenekleri).
WarningsAsErrors	İsteğe bağlı String parametre. Hata olarak ele alınacak uyarıların listesini belirtir. Daha fazla bilgi için bkz . -warnaserror (C# derleyici seçenekleri). Bu parametre parametresini TreatWarningsAsErrors geçersiz kılar.
WarningsNotAsErrors	İsteğe bağlı String parametre. Hata olarak değerlendirilmeyen uyarıların listesini belirtir. Daha fazla bilgi için bkz . -warnaserror (C# derleyici seçenekleri). Bu parametre yalnızca parametresi olarak trueayarlandıysa TreatWarningsAsErrors kullanışlıdır.
Win32Icon	İsteğe bağlı String parametre. Derlemeye bir .ico dosyası ekler ve bu da çıkış dosyasına Dosya Gezgini istenen görünümü verir. Daha fazla bilgi için bkz . -win32icon (C# derleyici seçenekleri).
Win32Manifest	İsteğe bağlı String parametre. Eklenecek Win32 bildirimini belirtir.
Win32Resource	İsteğe bağlı String parametre. Çıkış dosyasına bir Win32 kaynak (.res) dosyası ekler. Daha fazla bilgi için bkz . -win32res (C# derleyici seçenekleri).

ToolTaskExtension parametreleri

Bu görev, sınıfından ToolTaskExtension devralan sınıfından ToolTask devralır ve sınıfından Task devralır. Bu devralma zinciri, görevlerden türetilen görevlere birkaç parametre ekler.

Aşağıdaki tabloda temel sınıfların parametreleri açıklanmaktadır:

Parametre	Tanım
EchoOff	İsteğe bağlı bool parametre. olarak trueayarlandığında, bu görev komut satırının stdout'a kopyalanmaması için cmd.exe komut satırına /Q geçirir.
EnvironmentVariables	İsteğe bağlı String dizi parametresi. Ortam değişkeni tanımlarının noktalı virgülle ayrılmış dizisi. Her tanım, eşittir işaretiyle ayrılmış bir ortam değişkeni adı ve değeri belirtmelidir. Bu değişkenler, normal ortam bloğuna ek olarak veya seçmeli olarak geçersiz kılmaya ek olarak oluşturulan yürütülebilir dosyaya geçirilir. Örneğin, Variable1=Value1;Variable2=Value2.
ExitCode	İsteğe bağlı Int32 çıkış salt okunur parametresi. Yürütülen komut tarafından sağlanan çıkış kodunu belirtir. Görev herhangi bir hata günlüğe kaydetmişse ancak işlem 0 çıkış koduna (başarılı) sahipse, bu -1 olarak ayarlanır.
LogStandardErrorAsError	İsteğe bağlı bool parametre. ise true, standart hata akışında alınan tüm iletiler hata olarak günlüğe kaydedilir.
StandardErrorImportance	İsteğe bağlı String parametre. Standart hata akışındaki metnin günlüğe kaydedildiği önem.
StandardOutputImportance	İsteğe bağlı String parametre. Standart çıkış akışındaki metnin günlüğe kaydedildiği önem.
Timeout	İsteğe bağlı Int32 parametre. Görev yürütülebilir dosyasının sonlandırıldığı süreyi milisaniye cinsinden belirtir. Varsayılan değer, zaman aşımı süresi olmadığını belirten değeridir Int.MaxValue. Zaman aşımı milisaniye cinsindendir.
ToolExe	İsteğe bağlı string parametre. Projeler bir ToolName'i geçersiz kılmak için bunu uygulayabilir. Görevler ToolName'i korumak için bunu geçersiz kılabilir.
ToolPath	İsteğe bağlı string parametre. Görevin temel alınan yürütülebilir dosyayı yüklediği konumu belirtir. Bu parametre belirtilmezse, görev MSBuild çalıştıran çerçevenin sürümüne karşılık gelen SDK yükleme yolunu kullanır.
UseCommandProcessor	İsteğe bağlı bool parametre. olarak trueayarlandığında, bu görev komut satırı için bir toplu iş dosyası oluşturur ve komutu doğrudan yürütmek yerine komut işlemcisini kullanarak yürütür.
YieldDuringToolExecution	İsteğe bağlı bool parametre. olarak trueayarlandığında bu görev, görevi yürütülürken düğümü verir.

Örnek

Aşağıdaki örnek, öğe koleksiyonundaki Csc kaynak dosyalardan yürütülebilir dosyalardan bir yürütülebilir dosya derlemek Compile için görevini kullanır.

<CSC
    Sources="@(Compile)"
    OutputAssembly="$(AppName).exe"
    EmitDebugInformation="true" />

Ayrıca bkz.

• Görev başvurusu
• Görevler