-target (Visual Basic)

  • Artykuł

Określa format danych wyjściowych kompilatora.

Składnia

-target:{exe | library | module | winexe | appcontainerexe | winmdobj}

Uwagi

W poniższej tabeli podsumowano efekt -target tej opcji.

Opcja Zachowanie
-target:exe Powoduje, że kompilator tworzy aplikację konsolową wykonywalną.

Jest to opcja domyślna, jeśli nie -target określono żadnej opcji. Plik wykonywalny jest tworzony za pomocą rozszerzenia .exe.

Jeśli nie określono inaczej z opcją -out , nazwa pliku wyjściowego przyjmuje nazwę pliku wejściowego, który zawiera procedurę Sub Main .

Tylko jedna Sub Main procedura jest wymagana w plikach kodu źródłowego, które są kompilowane w pliku .exe. Użyj opcji kompilatora -main , aby określić, która klasa zawiera procedurę Sub Main .
-target:library Powoduje utworzenie biblioteki łącza dynamicznego (DLL) przez kompilator.

Plik biblioteki linku dynamicznego jest tworzony za pomocą rozszerzenia .dll.

Jeśli nie określono inaczej z opcją -out , nazwa pliku wyjściowego przyjmuje nazwę pierwszego pliku wejściowego.

Podczas kompilowania biblioteki DLL procedura nie jest wymagana Sub Main .
-target:module Powoduje wygenerowanie modułu, który można dodać do zestawu przez kompilator.

Plik wyjściowy jest tworzony z rozszerzeniem .netmodule.

Środowisko uruchomieniowe języka wspólnego platformy .NET nie może załadować pliku, który nie ma zestawu. Można jednak dołączyć taki plik do manifestu zestawu zestawu przy użyciu polecenia -reference.

Gdy kod w jednym module odwołuje się do typów wewnętrznych w innym module, oba moduły muszą zostać włączone do manifestu zestawu przy użyciu polecenia -reference.

Opcja -addmodule importuje metadane z modułu.
-target:winexe Powoduje, że kompilator tworzy aplikację wykonywalną opartą na systemie Windows.

Plik wykonywalny jest tworzony za pomocą rozszerzenia .exe. Aplikacja oparta na systemie Windows to aplikacja, która udostępnia interfejs użytkownika z biblioteki klas platformy .NET Framework lub interfejsów API systemu Windows.

Jeśli nie określono inaczej z opcją -out , nazwa pliku wyjściowego przyjmuje nazwę pliku wejściowego, który zawiera procedurę Sub Main .

Tylko jedna Sub Main procedura jest wymagana w plikach kodu źródłowego, które są kompilowane w pliku .exe. W przypadkach, gdy kod ma więcej niż jedną klasę, która ma proceduręSub Main, użyj -main opcji kompilatora, aby określić, która klasa zawiera procedurę Sub Main
-target:appcontainerexe Powoduje, że kompilator tworzy wykonywalną aplikację opartą na systemie Windows, która musi być uruchamiana w kontenerze aplikacji. To ustawienie jest przeznaczone do użycia w aplikacjach ze sklepu Windows 8.x.

Ustawienie appcontainerexe ustawia nieco w polu Właściwości przenośnego pliku wykonywalnego . Ten bit wskazuje, że aplikacja musi być uruchomiona w kontenerze aplikacji. Po ustawieniu tego bitu wystąpi błąd, jeśli CreateProcess metoda próbuje uruchomić aplikację poza kontenerem aplikacji. Oprócz tego ustawienia bitowego parametr -target:appcontainerexe jest odpowiednikiem -target:winexe.

Plik wykonywalny jest tworzony za pomocą rozszerzenia .exe.

Jeśli nie określisz inaczej przy użyciu -out opcji, nazwa pliku wyjściowego przyjmuje nazwę pliku wejściowego, który zawiera procedurę Sub Main .

Tylko jedna Sub Main procedura jest wymagana w plikach kodu źródłowego, które są kompilowane w pliku .exe. Jeśli kod zawiera więcej niż jedną klasę zawierającą proceduręSub Main, użyj -main opcji kompilatora, aby określić, która klasa zawiera procedurę Sub Main
-target:winmdobj Powoduje utworzenie pliku pośredniego kompilatora, który można przekonwertować na plik binarny środowisko wykonawcze systemu Windows (winmd). Plik winmd może być używany przez programy JavaScript i C++, oprócz programów języka zarządzanego.

Plik pośredni jest tworzony z rozszerzeniem winmdobj.

Jeśli nie określisz inaczej przy użyciu -out opcji, nazwa pliku wyjściowego przyjmuje nazwę pierwszego pliku wejściowego. Procedura Sub Main nie jest wymagana.

Plik .winmdobj został zaprojektowany tak, aby był używany jako dane wejściowe narzędzia WinMDExp eksportu w celu utworzenia pliku metadanych systemu Windows (WinMD). Plik WinMD ma rozszerzenie winmd i zawiera zarówno kod z oryginalnej biblioteki, jak i definicje WinMD używane przez język JavaScript, C++i środowisko wykonawcze systemu Windows.

Jeśli nie określisz -target:moduleparametru , -target powoduje dodanie manifestu zestawu .NET Framework do pliku wyjściowego.

Każde wystąpienie Vbc.exe tworzy co najwyżej jeden plik wyjściowy. Jeśli określisz opcję kompilatora, taką jak -out lub -target więcej niż jeden raz, ostatni proces kompilatora zostanie wprowadzony w życie. Informacje o wszystkich plikach w kompilacji są dodawane do manifestu. Wszystkie pliki wyjściowe z wyjątkiem plików utworzonych z metadanymi -target:module zestawu w manifeście. Użyj Ildasm.exe (dezasembler IL), aby wyświetlić metadane w pliku wyjściowym.

Krótka forma to -target-t.

Aby ustawić element -target w środowisku IDE programu Visual Studio

  1. Wybierz projekt w Eksplorator rozwiązań. W menu Project (Projekt) kliknij pozycję Properties (Właściwości).

  2. Kliknij kartę Aplikacja .

  3. Zmodyfikuj wartość w polu Typ aplikacji.

Przykład

Poniższy kod kompiluje in.vbelement , tworząc in.dllpolecenie :

vbc -target:library in.vb

Zobacz też