Aracılığıyla paylaş


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.