Vbc görevi
Yürütülebilir dosyalar (.exe), dinamik bağlantı kitaplıkları (.dll) veya kod modülleri (.netmodule) üreten vbc.exe sarmalar. vbc.exe hakkında daha fazla bilgi için bkz. Visual Basic komut satırı derleyicisi.
Parametreler
Aşağıdaki tabloda görevin parametreleri Vbc
açıklanmaktadır.
Parametre | Açıklama |
---|---|
AdditionalLibPaths |
İsteğe bağlı String[] parametre.References özniteliğinde belirtilen derlemelerin arandığı ek klasörleri belirtir. |
AddModules |
İsteğe bağlı String[] parametre.Derleyicinin, belirtilen dosyalardan gelen tüm tür bilgilerini derlediğiniz projede kullanılabilir hale getirmesine neden olur. Bu parametre, vbc.exe derleyicisinin -addmodule anahtarına karşılık gelir. |
BaseAddress |
İsteğe bağlı String parametre.DLL'nin temel adresini belirtir. Bu parametre, vbc.exe derleyicisinin -baseaddress anahtarına karşılık gelir. |
CodePage |
İsteğe bağlı Int32 parametre.Derlemedeki tüm kaynak kod dosyaları için kullanılacak kod sayfasını belirtir. Bu parametre, vbc.exe derleyicisinin -codepage anahtarına karşılık gelir. |
DebugType |
İsteğe bağlı String[] parametre.Derleyicinin hata ayıklama bilgileri oluşturmasına neden olur. Bu parametre aşağıdaki değerlere sahip olabilir: - full - pdbonly Varsayılan değer, çalışan programa bir hata ayıklayıcısı eklemeyi sağlayan değeridir full . değeri pdbonly , program hata ayıklayıcıda başlatıldığında kaynak kodu hata ayıklamasına izin verir, ancak derleme dili kodunu yalnızca çalışan program hata ayıklayıcıya eklendiğinde görüntüler. Daha fazla bilgi için bkz . -debug (Visual Basic). |
DefineConstants |
İsteğe bağlı String[] parametre.Koşullu derleyici sabitlerini tanımlar. Sembol/değer çiftleri noktalı virgülle ayrılır ve aşağıdaki söz dizimi ile belirtilir: sembol1 = değer1 ; sembol2 = değer2Bu parametre, vbc.exe derleyicisinin -define anahtarına karşılık gelir. |
DelaySign |
İsteğe bağlı Boolean parametre.ise true , görev ortak anahtarı derlemeye yerleştirir. ise false , görev derlemeyi tamamen imzalar. Varsayılan değerdir false . Parametresi veya parametresi ile kullanılmadığı sürece bu parametrenin KeyFile KeyContainer hiçbir etkisi yoktur. Bu parametre, vbc.exe derleyicisinin -delaysign anahtarına karşılık gelir. |
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. |
DisabledWarnings |
İsteğe bağlı String parametre.Belirtilen uyarıları gizler. Uyarı tanımlayıcısının yalnızca sayısal bölümünü belirtmeniz gerekir. Birden çok uyarı noktalı virgülle ayrılır. Bu parametre, vbc.exe derleyicisinin -nowarn anahtarına karşılık gelir. |
DocumentationFile |
İsteğe bağlı String parametre.Belge açıklamalarını belirtilen XML dosyasına işler. Bu parametre özniteliğini GenerateDocumentation geçersiz kılar. Daha fazla bilgi için bkz . -doc. |
EmitDebugInformation |
İsteğe bağlı Boolean parametre.ise true , görev hata ayıklama bilgileri oluşturur ve bunu bir .pdb dosyasına yerleştirir. Daha fazla bilgi için bkz . -debug (Visual Basic). |
ErrorReport |
İsteğe bağlı String parametre.Görevin iç derleyici hatalarını nasıl rapor etmesi gerektiğini belirtir. Bu parametre aşağıdaki değerlere sahip olabilir: - prompt - send - none belirtilirse ve bir iç derleyici hatası oluşursa prompt , kullanıcıdan hata verilerinin Microsoft'a gönderilip gönderilmeydiği sorulur.belirtilirse ve bir iç derleyici hatası oluşursa send , görev hata verilerini Microsoft'a gönderir.Varsayılan değer, yalnızca metin çıkışındaki hataları bildiren değeridir none .Bu parametre, vbc.exe derleyicisinin -errorreport anahtarına karşılık gelir. |
FileAlignment |
İsteğe bağlı Int32 parametre.Çıkış dosyasının bölümlerinin hizalandığı yeri bayt cinsinden belirtir. Bu parametre aşağıdaki değerlere sahip olabilir: - 512 - 1024 - 2048 - 4096 - 8192 Bu parametre, vbc.exe derleyicisinin -filealign anahtarına karşılık gelir. |
GenerateDocumentation |
İsteğe bağlı Boolean parametre.ise true , belge bilgilerini oluşturur ve görevin oluşturduğu yürütülebilir dosya veya kitaplığın adıyla bir XML dosyasına yerleştirir. Daha fazla bilgi için bkz . -doc. |
Imports |
İsteğe bağlı ITaskItem[] parametre.Belirtilen öğe koleksiyonlarından ad alanlarını içeri aktarır. Bu parametre, vbc.exe derleyicisinin -imports anahtarına karşılık gelir. |
KeyContainer |
İsteğe bağlı String parametre.Şifreleme anahtarı kapsayıcısının adını belirtir. Bu parametre, vbc.exe derleyicisinin -keycontainer anahtarına karşılık gelir. |
KeyFile |
İsteğe bağlı String parametre.Şifreleme anahtarını içeren dosya adını belirtir. Daha fazla bilgi için bkz . -keyfile. |
LangVersion |
İsteğe bağlı System.String parametre. "15.5" gibi dil sürümünü belirtir. |
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 parametre, vbc.exe derleyicisinin -linkresource anahtarına karşılık gelir. |
MainEntryPoint |
İsteğe bağlı String parametre.Yordamı içeren Sub Main sınıfı veya modülü belirtir. Bu parametre, vbc.exe derleyicisinin -main anahtarına karşılık gelir. |
ModuleAssemblyName |
İsteğe bağlı String parametre.Bu modülün parçası olduğu derlemeyi belirtir. |
NoConfig |
İsteğe bağlı Boolean parametre.Derleyicinin vbc.rsp dosyasını kullanmaması gerektiğini belirtir. Bu parametre, vbc.exe derleyicisinin -noconfig parametresine karşılık gelir. |
NoLogo |
İsteğe bağlı Boolean parametre.ise true , derleyici başlık bilgilerinin görüntülenmesini engeller. Bu parametre, vbc.exe derleyicisinin -nologo anahtarına karşılık gelir. |
NoStandardLib |
İsteğe bağlı Boolean parametre.Derleyicinin standart kitaplıklara başvurmasına neden olur. Bu parametre, vbc.exe derleyicisinin -nostdlib anahtarına karşılık gelir. |
NoVBRuntimeReference |
İsteğe bağlı Boolean parametre.Yalnızca iç kullanım. True ise, Microsoft.VisualBasic.dll otomatik başvuruyu engeller. |
NoWarnings |
İsteğe bağlı Boolean parametre.ise true , görev tüm uyarıları gizler. Daha fazla bilgi için bkz . -nowarn. |
Optimize |
İsteğe bağlı Boolean parametre.ise true , derleyici iyileştirmelerini etkinleştirir. Bu parametre, vbc.exe derleyicisinin -optimize anahtarına karşılık gelir. |
OptionCompare |
İsteğe bağlı String parametre.Dize karşılaştırmalarının nasıl yapıldığını belirtir. Bu parametre aşağıdaki değerlere sahip olabilir: - binary - text değeri binary , görevin ikili dize karşılaştırmaları kullandığını belirtir. değeri text , görevin metin dizesi karşılaştırmaları kullandığını belirtir. Bu parametrenin varsayılan değeridir binary . Bu parametre, vbc.exe derleyicisinin -optioncompare anahtarına karşılık gelir. |
OptionExplicit |
İsteğe bağlı Boolean parametre.ise true , değişkenlerin açık bildirimi gereklidir. Bu parametre, vbc.exe derleyicisinin -optionexplicit anahtarına karşılık gelir. |
OptionInfer |
İsteğe bağlı Boolean parametre.ise true , değişkenlerin tür çıkarımına izin verir. |
OptionStrict |
İsteğe bağlı Boolean parametre.ise true , görev örtük tür dönüştürmelerini kısıtlamak için katı tür semantiği uygular. Bu parametre, vbc.exe derleyicisinin -optionstrict anahtarına karşılık gelir. |
OptionStrictType |
İsteğe bağlı String parametre.Hangi katı tür semantiğinin uyarı oluşturacağı belirtir. Şu anda yalnızca "özel" desteklenir. Bu parametre, vbc.exe derleyicisinin -optionstrict anahtarına karşılık gelir. |
OutputAssembly |
İsteğe bağlı String çıkış parametresi.Çıkış dosyasının adını belirtir. Bu parametre, vbc.exe derleyicisinin -out anahtarına karşılık gelir. |
Platform |
İsteğe bağlı String parametre.Çıkış dosyası tarafından hedeflenecek işlemci platformunu belirtir. Bu parametrenin değeri x86 , x64 , Itanium veya anycpu olabilir. Varsayılan anycpu değeridir. Bu parametre, vbc.exe derleyicisinin -platform anahtarına karşılık gelir. |
References |
İsteğe bağlı ITaskItem[] parametre.Görevin belirtilen öğelerden geçerli projeye genel tür bilgilerini içeri aktarmasına neden olur. Bu parametre, vbc.exe derleyicisinin -reference anahtarına karşılık gelir. |
RemoveIntegerChecks |
İsteğe bağlı Boolean parametre.ise true , tamsayı taşması hata denetimlerini devre dışı bırakır. Varsayılan değer şudur: false . Bu parametre, vbc.exe derleyicisinin -removeintchecks anahtarına karşılık gelir. |
Resources |
İsteğe bağlı ITaskItem[] parametre.Çıkış dosyasına bir .NET Framework kaynağı ekler. Bu parametre, vbc.exe derleyicisinin -resource anahtarına karşılık gelir. |
ResponseFiles |
İsteğe bağlı ITaskItem[] parametre.Bu görev için komutları içeren yanıt dosyasını belirtir. Bu parametre, vbc.exe derleyicisinin @ (Yanıt Dosyasını Belirt) seçeneğine karşılık gelir. |
RootNamespace |
İsteğe bağlı String parametre.Tüm tür bildirimleri için kök ad alanını belirtir. Bu parametre, vbc.exe derleyicisinin -rootnamespace anahtarına karşılık gelir. |
SdkPath |
İsteğe bağlı String parametre.mscorlib.dll ve microsoft.visualbasic.dll konumunu belirtir. Bu parametre, vbc.exe derleyicisinin -sdkpath anahtarına karşılık gelir. |
Sources |
İsteğe bağlı ITaskItem[] parametre.Bir veya daha fazla Visual Basic kaynak dosyası belirtir. |
TargetCompactFramework |
İsteğe bağlı Boolean parametre.ise true , görev .NET Compact Framework'leri hedefler. Bu anahtar, vbc.exe derleyicisinin -netcf anahtarına karşılık gelir. |
TargetType |
İsteğe bağlı String parametre.Çıkış dosyasının dosya biçimini belirtir. Bu parametre, bir library kod kitaplığı oluşturan, exe bir konsol uygulaması module oluşturan , bir modül oluşturan veya winexe bir Windows programı oluşturan değeri olabilir. Varsayılan library değeridir. Bu parametre, vbc.exe derleyicisinin -target anahtarına karşılık gelir. |
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 . |
ToolPath |
İsteğe bağlı String parametre.Görevin temel alınan yürütülebilir dosyayı (vbc.exe) yükleyeceğ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. |
TreatWarningsAsErrors |
İsteğe bağlı Boolean parametre.ise true , tüm uyarılar hata olarak değerlendirilir. Daha fazla bilgi için bkz . -warnaserror (Visual Basic). |
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. Bu parametre, vbc.exe derleyicisinin -utf8output anahtarına karşılık gelir. |
Verbosity |
İsteğe bağlı String parametre.Derleyici çıktısının ayrıntı düzeyini belirtir. Ayrıntı düzeyi , Normal (varsayılan) veya Verbose olabilirQuiet . |
WarningsAsErrors |
İsteğe bağlı String parametre.Hata olarak ele alınacak uyarıların listesini belirtir. Daha fazla bilgi için bkz . -warnaserror (Visual Basic). 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 (Visual Basic). Bu parametre yalnızca parametresi olarak true ayarlandı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. Bu parametre, vbc.exe derleyicisinin -win32icon anahtarına karşılık gelir. |
Win32Resources |
İsteğe bağlı String parametre.Çıkış dosyasına bir Win32 kaynak (.res) dosyası ekler. Bu parametre, vbc.exe derleyicisinin -win32resource anahtarına karşılık gelir. |
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 | Açıklama |
---|---|
EchoOff | İsteğe bağlı bool parametre.olarak true ayarlandığında, bu görev komut satırının stdout'a kopyalanmaması için /Q cmd.exe komut satırına 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 true ayarlandığı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 true ayarlandığında bu görev, görevi yürütülürken düğümü verir. |
Örnek
Aşağıdaki örnek bir Visual Basic projesi derlemektedir.
<VBC
Sources="@(sources)"
Resources="strings.resources"
Optimize="true"
OutputAssembly="out.exe"/>