Vbc — Zadanie

Zawija vbc.exe, który tworzy pliki wykonywalne (.exe), biblioteki linku dynamicznego (.dll) lub moduły kodu (.netmodule). Aby uzyskać więcej informacji na temat vbc.exe, zobacz Kompilator wiersza polecenia języka Visual Basic.

Parametry

W poniższej tabeli opisano parametry Vbc zadania.

Parametr	Opis
AdditionalLibPaths	Opcjonalny String[] parametr. Określa dodatkowe foldery, w których należy wyszukać zestawy określone w atrybucie Odwołania.
AddModules	Opcjonalny String[] parametr. Powoduje, że kompilator udostępnia wszystkie informacje o typie z określonych plików do aktualnie kompilowanego projektu. Ten parametr odpowiada przełącznikowi -addmodule kompilatora vbc.exe .
BaseAddress	Opcjonalny String parametr. Określa podstawowy adres biblioteki DLL. Ten parametr odpowiada przełącznikowi -baseaddress kompilatora vbc.exe .
CodePage	Opcjonalny Int32 parametr. Określa stronę kodów, która ma być używana dla wszystkich plików kodu źródłowego w kompilacji. Ten parametr odpowiada przełącznikowi -codepage kompilatora vbc.exe .
DebugType	Opcjonalny String[] parametr. Powoduje wygenerowanie informacji debugowania przez kompilator. Ten parametr może mieć następujące wartości: - full - pdbonly Wartość domyślna to full, która umożliwia dołączanie debugera do uruchomionego programu. Wartość pdbonly umożliwia debugowanie kodu źródłowego podczas uruchamiania programu w debugerze, ale wyświetla kod języka zestawu tylko wtedy, gdy uruchomiony program jest dołączony do debugera. Aby uzyskać więcej informacji, zobacz -debug (Visual Basic).
DefineConstants	Opcjonalny String[] parametr. Definiuje stałe kompilatora warunkowego. Pary symboli/wartości są oddzielone średnikami i są określane przy użyciu następującej składni: symbol1 wartość1 ; = symbol2 = Ten parametr odpowiada przełącznikowi -define kompilatora vbc.exe .
DelaySign	Opcjonalny Boolean parametr. Jeśli truezadanie umieszcza klucz publiczny w zestawie. Jeśli falsezadanie w pełni podpisuje zestaw. Wartość domyślna to false. Ten parametr nie ma efektu, chyba że jest używany z parametrem KeyFile lub parametrem KeyContainer . Ten parametr odpowiada przełącznikowi -delaysign kompilatora vbc.exe .
Deterministic	Opcjonalny Boolean parametr. Jeśli truepolecenie , powoduje, że kompilator wyprowadza zestaw, którego zawartość binarna jest identyczna w kompilacjach, jeśli dane wejściowe są identyczne. Aby uzyskać więcej informacji, zobacz -deterministyczne.
DisabledWarnings	Opcjonalny String parametr. Pomija określone ostrzeżenia. Wystarczy określić część liczbową identyfikatora ostrzeżenia. Wiele ostrzeżeń jest rozdzielonych średnikami. Ten parametr odpowiada przełącznikowi -nowarn kompilatora vbc.exe .
DocumentationFile	Opcjonalny String parametr. Przetwarza komentarze dokumentacji do określonego pliku XML. Ten parametr zastępuje GenerateDocumentation atrybut . Aby uzyskać więcej informacji, zobacz -doc.
EmitDebugInformation	Opcjonalny Boolean parametr. Jeśli truezadanie generuje informacje debugowania i umieszcza je w pliku .pdb . Aby uzyskać więcej informacji, zobacz -debug (Visual Basic).
ErrorReport	Opcjonalny String parametr. Określa, jak zadanie powinno zgłaszać wewnętrzne błędy kompilatora. Ten parametr może mieć następujące wartości: - prompt - send - none Jeśli prompt zostanie określony i wystąpi wewnętrzny błąd kompilatora, użytkownik jest monitowany o możliwość wysłania danych o błędzie do firmy Microsoft. Jeśli send zostanie określony i wystąpi wewnętrzny błąd kompilatora, zadanie wysyła dane o błędzie do firmy Microsoft. Wartość domyślna to none, która zgłasza błędy tylko w danych wyjściowych tekstu. Ten parametr odpowiada przełącznikowi -errorreport kompilatora vbc.exe .
FileAlignment	Opcjonalny Int32 parametr. Określa w bajtach, gdzie wyrównywać sekcje pliku wyjściowego. Ten parametr może mieć następujące wartości: - 512 - 1024 - 2048 - 4096 - 8192 Ten parametr odpowiada przełącznikowi -filealign kompilatora vbc.exe .
GenerateDocumentation	Opcjonalny Boolean parametr. Jeśli trueprogram generuje informacje o dokumentacji i umieszcza je w pliku XML o nazwie pliku wykonywalnego lub biblioteki tworzonej przez zadanie. Aby uzyskać więcej informacji, zobacz -doc.
Imports	Opcjonalny ITaskItem[] parametr. Importuje przestrzenie nazw z określonych kolekcji elementów. Ten parametr odpowiada przełącznikowi -import kompilatora vbc.exe .
KeyContainer	Opcjonalny String parametr. Określa nazwę kontenera kluczy kryptograficznych. Ten parametr odpowiada przełącznikowi -keycontainer kompilatora vbc.exe .
KeyFile	Opcjonalny String parametr. Określa nazwę pliku zawierającą klucz kryptograficzny. Aby uzyskać więcej informacji, zobacz -keyfile.
LangVersion	Opcjonalny System.String parametr. Określa wersję języka, taką jak "15.5".
LinkResources	Opcjonalny ITaskItem[] parametr. Tworzy link do zasobu programu .NET Framework w pliku wyjściowym; plik zasobu nie jest umieszczany w pliku wyjściowym. Ten parametr odpowiada przełącznikowi -linkresource kompilatora vbc.exe .
MainEntryPoint	Opcjonalny String parametr. Określa klasę lub moduł, który zawiera procedurę Sub Main . Ten parametr odpowiada przełącznikowi -main kompilatora vbc.exe .
ModuleAssemblyName	Opcjonalny String parametr. Określa zestaw, który jest częścią tego modułu.
NoConfig	Opcjonalny Boolean parametr. Określa, że kompilator nie powinien używać pliku vbc.rsp . Ten parametr odpowiada parametrowi -noconfig kompilatora vbc.exe .
NoLogo	Opcjonalny Boolean parametr. Jeśli truewartość , pomija wyświetlanie informacji baneru kompilatora. Ten parametr odpowiada przełącznikowi -nologo kompilatora vbc.exe .
NoStandardLib	Opcjonalny Boolean parametr. Powoduje, że kompilator nie odwołuje się do bibliotek standardowych. Ten parametr odpowiada przełącznikowi -nostdlib kompilatora vbc.exe .
NoVBRuntimeReference	Opcjonalny Boolean parametr. Tylko do użytku wewnętrznego. Jeśli wartość true, uniemożliwia automatyczne odwołanie do Microsoft.VisualBasic.dll.
NoWarnings	Opcjonalny Boolean parametr. Jeśli truezadanie pomija wszystkie ostrzeżenia. Aby uzyskać więcej informacji, zobacz -nowarn.
Optimize	Opcjonalny Boolean parametr. Jeśli trueprogram włącza optymalizacje kompilatora. Ten parametr odpowiada przełącznikowi -optimize kompilatora vbc.exe .
OptionCompare	Opcjonalny String parametr. Określa sposób wykonywania porównań ciągów. Ten parametr może mieć następujące wartości: - binary - text binary Wartość określa, że zadanie używa porównań ciągów binarnych. Wartość text określa, że zadanie używa porównań ciągów tekstowych. Wartość domyślna tego parametru to binary. Ten parametr odpowiada przełącznikowi -optioncompare kompilatora vbc.exe .
OptionExplicit	Opcjonalny Boolean parametr. Jeśli truewymagana jest jawna deklaracja zmiennych. Ten parametr odpowiada przełącznikowi -optionexplicit kompilatora vbc.exe .
OptionInfer	Opcjonalny Boolean parametr. Jeśli trueparametr zezwala na wnioskowanie typów zmiennych.
OptionStrict	Opcjonalny Boolean parametr. Jeśli truezadanie wymusza semantykę typu ścisłego w celu ograniczenia niejawnych konwersji typów. Ten parametr odpowiada przełącznikowi -optionstrict kompilatora vbc.exe .
OptionStrictType	Opcjonalny String parametr. Określa, która semantyka typu ścisłego generuje ostrzeżenie. Obecnie obsługiwana jest tylko opcja "niestandardowa". Ten parametr odpowiada przełącznikowi -optionstrict kompilatora vbc.exe .
OutputAssembly	Opcjonalny String parametr wyjściowy. Określa nazwę pliku wyjściowego. Ten parametr odpowiada przełącznikowi -out kompilatora vbc.exe .
Platform	Opcjonalny String parametr. Określa platformę procesora, która ma być objęta plikiem wyjściowym. Ten parametr może mieć wartość x86, , x64Itaniumlub anycpu. Wartość domyślna to anycpu. Ten parametr odpowiada przełącznikowi -platformy kompilatora vbc.exe .
References	Opcjonalny ITaskItem[] parametr. Powoduje, że zadanie importuje informacje o typie publicznym z określonych elementów do bieżącego projektu. Ten parametr odpowiada przełącznikowi -reference kompilatora vbc.exe .
RemoveIntegerChecks	Opcjonalny Boolean parametr. Jeśli truewartość , wyłącza sprawdzanie błędów przepełnienia liczby całkowitej. Domyślna wartość to false. Ten parametr odpowiada przełącznikowi -removeintchecks kompilatora vbc.exe .
Resources	Opcjonalny ITaskItem[] parametr. Osadza zasób .NET Framework w pliku wyjściowym. Ten parametr odpowiada przełącznikowi -resource kompilatora vbc.exe .
ResponseFiles	Opcjonalny ITaskItem[] parametr. Określa plik odpowiedzi zawierający polecenia dla tego zadania. Ten parametr odpowiada opcji @ (Określ plik odpowiedzi) kompilatora vbc.exe .
RootNamespace	Opcjonalny String parametr. Określa przestrzeń nazw katalogu głównego dla wszystkich deklaracji typów. Ten parametr odpowiada przełącznikowi -rootnamespace kompilatora vbc.exe .
SdkPath	Opcjonalny String parametr. Określa lokalizację mscorlib.dll i microsoft.visualbasic.dll. Ten parametr odpowiada przełącznikowi -sdkpath kompilatora vbc.exe .
Sources	Opcjonalny ITaskItem[] parametr. Określa co najmniej jeden plik źródłowy języka Visual Basic.
TargetCompactFramework	Opcjonalny Boolean parametr. Jeśli truezadanie jest przeznaczone dla platformy .NET Compact Framework. Ten przełącznik odpowiada przełącznikowi -netcf kompilatora vbc.exe .
TargetType	Opcjonalny String parametr. Określa format pliku wyjściowego. Ten parametr może mieć wartość library, która tworzy bibliotekę kodu, exe, która tworzy aplikację konsolową , module, która tworzy moduł lub winexe, co tworzy program systemu Windows. Wartość domyślna to library. Ten parametr odpowiada przełącznikowi -target kompilatora vbc.exe .
Timeout	Opcjonalny Int32 parametr. Określa czas w milisekundach, po którym plik wykonywalny zadania zostanie zakończony. Wartość domyślna to Int.MaxValue, co oznacza, że nie ma limitu czasu.
ToolPath	Opcjonalny String parametr. Określa lokalizację, z której zadanie załaduje źródłowy plik wykonywalny (vbc.exe). Jeśli ten parametr nie zostanie określony, zadanie używa ścieżki instalacyjnej zestawu SDK odpowiadającej wersji platformy z uruchomionym programem MSBuild.
TreatWarningsAsErrors	Opcjonalny Boolean parametr. Jeśli truewszystkie ostrzeżenia są traktowane jako błędy. Aby uzyskać więcej informacji, zobacz -warnaserror (Visual Basic).
UseHostCompilerIfAvailable	Opcjonalny Boolean parametr. Nakazuje zadaniu użycie obiektu kompilatora w procesie, jeśli jest dostępny. Używane tylko przez program Visual Studio.
Utf8Output	Opcjonalny Boolean parametr. Rejestruje dane wyjściowe kompilatora przy użyciu kodowania UTF-8. Ten parametr odpowiada przełącznikowi -utf8output kompilatora vbc.exe .
Verbosity	Opcjonalny String parametr. Określa szczegółowość danych wyjściowych kompilatora. Czasownik może mieć Quietwartość , Normal (wartość domyślna) lub Verbose.
WarningsAsErrors	Opcjonalny String parametr. Określa listę ostrzeżeń, które mają być traktowane jako błędy. Aby uzyskać więcej informacji, zobacz -warnaserror (Visual Basic). Ten parametr zastępuje TreatWarningsAsErrors parametr .
WarningsNotAsErrors	Opcjonalny String parametr. Określa listę ostrzeżeń, które nie są traktowane jako błędy. Aby uzyskać więcej informacji, zobacz -warnaserror (Visual Basic). Ten parametr jest przydatny tylko wtedy, gdy TreatWarningsAsErrors parametr jest ustawiony na truewartość .
Win32Icon	Opcjonalny String parametr. Wstawia plik .ico w zestawie, który daje plik wyjściowy żądany wygląd w Eksplorator plików. Ten parametr odpowiada przełącznikowi -win32icon kompilatora vbc.exe .
Win32Resources	Opcjonalny String parametr. Wstawia plik zasobu Win32 (res) do pliku wyjściowego. Ten parametr odpowiada przełącznikowi -win32resource kompilatora vbc.exe .

Parametry toolTaskExtension

To zadanie dziedziczy z ToolTaskExtension klasy dziedziczonej ToolTask po klasie, która dziedziczy się po Task klasie. Ten łańcuch dziedziczenia dodaje kilka parametrów do zadań, które pochodzą z nich.

W poniższej tabeli opisano parametry klas bazowych:

Parametr	Opis
EchoOff	Opcjonalny bool parametr. Gdy jest ustawiona truewartość , to zadanie przekazuje /Q do wiersza polecenia cmd.exe , tak aby wiersz polecenia nie został skopiowany do stdout.
EnvironmentVariables	Opcjonalny String parametr tablicy. Tablica definicji zmiennych środowiskowych oddzielona średnikami. Każda definicja powinna określać nazwę zmiennej środowiskowej i wartość oddzieloną znakiem równości. Te zmienne są przekazywane do zduplikowanego pliku wykonywalnego oprócz zwykłego bloku środowiska lub selektywnego zastępowania. Na przykład Variable1=Value1;Variable2=Value2.
ExitCode	Opcjonalny Int32 parametr tylko do odczytu. Określa kod zakończenia udostępniany przez wykonane polecenie. Jeśli zadanie zarejestrowało błędy, ale proces miał kod zakończenia 0 (powodzenie), jest to ustawione na -1.
LogStandardErrorAsError	Opcjonalny bool parametr. Jeśli trueprogram , wszystkie komunikaty odebrane w standardowym strumieniu błędów są rejestrowane jako błędy.
StandardErrorImportance	Opcjonalny String parametr. Ważność rejestrowania tekstu ze standardowego strumienia błędów.
StandardOutputImportance	Opcjonalny String parametr. Ważność, za pomocą której ma być rejestrowany tekst ze standardowego strumienia wychodzącego.
Timeout	Opcjonalny Int32 parametr. Określa czas w milisekundach, po którym plik wykonywalny zadania zostanie zakończony. Wartość domyślna to Int.MaxValue, co oznacza, że nie ma limitu czasu. Limit czasu wynosi w milisekundach.
ToolExe	Opcjonalny string parametr. Projekty mogą implementować tę funkcję, aby zastąpić element ToolName. Zadania mogą zastąpić tę wartość, aby zachować wartość ToolName.
ToolPath	Opcjonalny string parametr. Określa lokalizację, z której zadanie ładuje źródłowy plik wykonywalny. Jeśli ten parametr nie zostanie określony, zadanie używa ścieżki instalacyjnej zestawu SDK odpowiadającej wersji platformy z uruchomionym programem MSBuild.
UseCommandProcessor	Opcjonalny bool parametr. Po ustawieniu truewartości to zadanie tworzy plik wsadowy dla wiersza polecenia i wykonuje go przy użyciu procesora poleceń zamiast bezpośredniego wykonywania polecenia.
YieldDuringToolExecution	Opcjonalny bool parametr. Gdy jest ustawiona wartość true, to zadanie daje węzeł, gdy jego zadanie jest wykonywane.

Przykład

Poniższy przykład kompiluje projekt Języka Visual Basic.

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

Zobacz też

• Kompilator wiersza polecenia języka Visual Basic
• Zadania
• Dokumentacja zadania