Vbc görevi

Yürütülebilir dosyalar (.exe), dinamik bağlantı kitaplıkları (.dll) veya kod modülleri (.netmodule) üreten vbc.exe dosyasını 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 Tanım
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ğer2

Bu 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 KeyFileKeyContainer 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'ye 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, Itaniumveya anycpuolabilir. 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. false varsayılan değerdir. 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 dosyasının 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 librarykod kitaplığı oluşturan, exebir konsol uygulaması moduleoluşturan , bir modül oluşturan veya winexebir 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 VerboseolabilirQuiet.
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 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. 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 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 bir Visual Basic projesi derlemektedir.

<VBC
   Sources="@(sources)"
   Resources="strings.resources"
   Optimize="true"
   OutputAssembly="out.exe"/>

Ayrıca bkz.