Vbc — Zadanie

  • Artykuł

Wraps vbc.exe, który tworzy pliki wykonywalne (.exe), biblioteki linku dynamicznego (.dll) lub moduły kodu (.netmodule). Aby uzyskać więcej informacji na temat pliku 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 biblioteki 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 -platform 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. Wartość domyślna 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ę biblioteki 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 do zestawu, 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 wartość true, to zadanie przekazuje /Q do wiersza polecenia cmd.exe , tak aby wiersz polecenia nie został skopiowany do pliku 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ż