Opcje konsolidatoraLinker options
LINK.exe łączy pliki i biblioteki obiektów Common Object Format (COFF), aby utworzyć plik wykonywalny (exe) lub bibliotekę dołączaną dynamicznie (DLL).LINK.exe links Common Object File Format (COFF) object files and libraries to create an executable (.exe) file or a dynamic-link library (DLL).
W poniższej tabeli wymieniono opcje LINK.exe.The following table lists options for LINK.exe. Aby uzyskać więcej informacji na temat łącza, zobacz:For more information about LINK, see:
W wierszu polecenia Opcje konsolidatora nie uwzględniają wielkości liter. na przykład /base i /BASE oznaczają to samo.On the command line, linker options aren't case-sensitive; for example, /base and /BASE mean the same thing. Aby uzyskać szczegółowe informacje na temat sposobu określania każdej opcji w wierszu polecenia lub w programie Visual Studio, zapoznaj się z dokumentacją dla tej opcji.For details on how to specify each option on the command line or in Visual Studio, see the documentation for that option.
Aby określić Opcje konsolidatora, można użyć dyrektywy pragma komentarza .You can use the comment pragma to specify some linker options.
Opcje konsolidatora w porządku alfabetycznymLinker options listed alphabetically
| OpcjaOption | PrzeznaczeniePurpose |
|---|---|
| @ | Określa plik odpowiedzi.Specifies a response file. |
| /ALIGN/ALIGN | Określa wyrównanie każdej sekcji.Specifies the alignment of each section. |
| /ALLOWBIND/ALLOWBIND | Określa, że nie można powiązać biblioteki DLL.Specifies that a DLL can't be bound. |
| /ALLOWISOLATION/ALLOWISOLATION | Określa zachowanie wyszukiwania manifestu.Specifies behavior for manifest lookup. |
| /APPCONTAINER/APPCONTAINER | Określa, czy aplikacja musi działać w środowisku procesu kontenera aplikacji.Specifies whether the app must run within an appcontainer process environment. |
| /ASSEMBLYDEBUG/ASSEMBLYDEBUG | Dodaje DebuggableAttribute do obrazu zarządzanego.Adds the DebuggableAttribute to a managed image. |
| /ASSEMBLYLINKRESOURCE/ASSEMBLYLINKRESOURCE | Tworzy łącze do zarządzanego zasobu.Creates a link to a managed resource. |
| /ASSEMBLYMODULE/ASSEMBLYMODULE | Określa, że moduł języka pośredniego (MSIL) firmy Microsoft powinien zostać zaimportowany do zestawu.Specifies that a Microsoft intermediate language (MSIL) module should be imported into the assembly. |
| /ASSEMBLYRESOURCE/ASSEMBLYRESOURCE | Osadza plik zasobów zarządzanych w zestawie.Embeds a managed resource file in an assembly. |
| /BASE/BASE | Ustawia adres podstawowy dla programu.Sets a base address for the program. |
| /CETCOMPAT/CETCOMPAT | Oznacza plik binarny jako zgodny ze stosem w tle (CET).Marks the binary as CET Shadow Stack compatible. |
| /CGTHREADS/CGTHREADS | Ustawia liczbę cl.exe wątków do użycia na potrzeby optymalizacji i generowania kodu, gdy zostanie określone generowanie kodu w czasie konsolidacji.Sets number of cl.exe threads to use for optimization and code generation when link-time code generation is specified. |
| /CLRIMAGETYPE/CLRIMAGETYPE | Ustawia typ (IJW, czysty lub bezpieczny) obrazu CLR.Sets the type (IJW, pure, or safe) of a CLR image. |
| /CLRSUPPORTLASTERROR/CLRSUPPORTLASTERROR | Zachowuje kod ostatniego błędu funkcji, które są wywoływane za pomocą mechanizmu P/Invoke.Preserves the last error code of functions that are called through the P/Invoke mechanism. |
| /CLRTHREADATTRIBUTE/CLRTHREADATTRIBUTE | Określa atrybut wątkowości, który ma zostać zastosowany do punktu wejścia programu CLR.Specifies the threading attribute to apply to the entry point of your CLR program. |
| /CLRUNMANAGEDCODECHECK/CLRUNMANAGEDCODECHECK | Określa, czy konsolidator będzie stosował atrybut SuppressUnmanagedCodeSecurity do wygenerowanych przez konsolidatora obiektów PInvoke, które wywołują z kodu zarządzanego do natywnych bibliotek DLL.Specifies whether the linker will apply the SuppressUnmanagedCodeSecurity attribute to linker-generated PInvoke stubs that call from managed code into native DLLs. |
| Opcją/DEBUG | Tworzy informacje debugowania.Creates debugging information. |
| /DEBUGTYPE/DEBUGTYPE | Określa, które dane mają być zawarte w informacjach o debugowaniu.Specifies which data to include in debugging information. |
| /DEF/DEF | Przekazuje plik definicji modułu (. def) do konsolidatora.Passes a module-definition (.def) file to the linker. |
| /DEFAULTLIB/DEFAULTLIB | Wyszukuje określoną bibliotekę, gdy odwołania zewnętrzne są rozwiązane.Searches the specified library when external references are resolved. |
| /DELAY/DELAY | Steruje opóźnionym ładowaniem bibliotek DLL.Controls the delayed loading of DLLs. |
| /DELAYLOAD/DELAYLOAD | Powoduje opóźnione ładowanie podanej biblioteki DLL.Causes the delayed loading of the specified DLL. |
| /DELAYSIGN/DELAYSIGN | Częściowo podpisuje zestaw.Partially signs an assembly. |
| /DEPENDENTLOADFLAG/DEPENDENTLOADFLAG | Ustawia domyślne flagi dla zależnych obciążeń biblioteki DLL.Sets default flags on dependent DLL loads. |
| /DLL/DLL | Kompiluje bibliotekę DLL.Builds a DLL. |
| /DRIVER/DRIVER | Tworzy sterownik trybu jądra.Creates a kernel mode driver. |
| /DYNAMICBASE/DYNAMICBASE | Określa, czy generować obraz wykonywalny, który jest zmieniany w czasie ładowania przy użyciu funkcji generowania losowego układu przestrzeni adresowej (ASLR).Specifies whether to generate an executable image that's rebased at load time by using the address space layout randomization (ASLR) feature. |
| /ENTRY/ENTRY | Ustawia adres początkowy.Sets the starting address. |
| /ERRORREPORT/ERRORREPORT | Przestarzałe.Deprecated. Raportowanie błędów jest kontrolowane przez ustawienia raportowanie błędów systemu Windows (wer) .Error reporting is controlled by Windows Error Reporting (WER) settings. |
| /EXPORT/EXPORT | Eksportuje funkcję.Exports a function. |
| /FILEALIGN/FILEALIGN | Wyrównuje sekcje w pliku wyjściowym do wielokrotności określonej wartości.Aligns sections within the output file on multiples of a specified value. |
| /FIXED/FIXED | Tworzy program, który można załadować tylko przy użyciu preferowanego adresu podstawowego.Creates a program that can be loaded only at its preferred base address. |
| /FORCE/FORCE | Wymusza zakończenie łącza nawet z nierozpoznanymi symbolami lub symbolami zdefiniowanymi więcej niż raz.Forces a link to complete even with unresolved symbols or symbols defined more than once. |
| /FUNCTIONPADMIN/FUNCTIONPADMIN | Tworzy obraz, który można zainstalować na gorąco.Creates an image that can be hot patched. |
| /GENPROFILE,/FASTGENPROFILE/GENPROFILE, /FASTGENPROFILE | Obie te opcje określają generowanie .pgd pliku przez konsolidator do obsługi optymalizacji opartej na profilach (PGO).Both of these options specify generation of a .pgd file by the linker to support profile-guided optimization (PGO). /GENPROFILE i/FASTGENPROFILE używają różnych parametrów domyślnych./GENPROFILE and /FASTGENPROFILE use different default parameters. |
| /GUARD/GUARD | Włącza ochronę za pomocą ochrony przepływu sterowania.Enables Control Flow Guard protection. |
| /HEAP/HEAP | Ustawia rozmiar sterty w bajtach.Sets the size of the heap, in bytes. |
| /HIGHENTROPYVA/HIGHENTROPYVA | Określa obsługę losowego generowania układu przestrzeni adresowej o wysokiej entropii 64 (ASLR).Specifies support for high-entropy 64-bit address space layout randomization (ASLR). |
| /IDLOUT/IDLOUT | Określa nazwę .idl pliku i inne pliki wyjściowe MIDL.Specifies the name of the .idl file and other MIDL output files. |
| /IGNORE/IGNORE | Pomija dane wyjściowe określonych ostrzeżeń konsolidatora.Suppresses output of specified linker warnings. |
| /IGNOREIDL/IGNOREIDL | Zapobiega przetwarzaniu informacji o atrybutach do .idl pliku.Prevents the processing of attribute information into an .idl file. |
| /IMPLIB/IMPLIB | Zastępuje domyślną nazwę biblioteki importu.Overrides the default import library name. |
| /INCLUDE/INCLUDE | Wymusza odwołania do symboli.Forces symbol references. |
| /INCREMENTAL/INCREMENTAL | Kontroluje łączenie przyrostowe.Controls incremental linking. |
| /INTEGRITYCHECK/INTEGRITYCHECK | Określa, że moduł wymaga sprawdzenia podpisu w czasie ładowania.Specifies that the module requires a signature check at load time. |
| /KEYCONTAINER/KEYCONTAINER | Określa kontener klucza do podpisania zestawu.Specifies a key container to sign an assembly. |
| /KEYFILE/KEYFILE | Określa klucz lub parę kluczy, aby podpisać zestaw.Specifies a key or key pair to sign an assembly. |
| /LARGEADDRESSAWARE/LARGEADDRESSAWARE | Informuje kompilator, że aplikacja obsługuje adresy większe niż dwa gigabajtyTells the compiler that the application supports addresses larger than two gigabytes |
| /LIBPATH/LIBPATH | Określa ścieżkę do wyszukania przed ścieżką biblioteki środowiska.Specifies a path to search before the environmental library path. |
| /LINKREPRO/LINKREPRO | Określa ścieżkę, w której mają zostać wygenerowane artefakty Odtwórz linku.Specifies a path to generate link repro artifacts in. |
| /LINKREPROTARGET/LINKREPROTARGET | Generuje link Odtwórz tylko podczas tworzenia określonego elementu docelowego. 16,1Generates a link repro only when producing the specified target.16.1 |
| /LTCG/LTCG | Określa generowanie kodu w czasie konsolidacji.Specifies link-time code generation. |
| /MACHINE/MACHINE | Określa platformę docelową.Specifies the target platform. |
| /MANIFEST/MANIFEST | Tworzy plik manifestu Side-by-Side i opcjonalnie osadza go w danych binarnych.Creates a side-by-side manifest file and optionally embeds it in the binary. |
| /MANIFESTDEPENDENCY/MANIFESTDEPENDENCY | Określa <dependentAssembly> sekcję w pliku manifestu.Specifies a <dependentAssembly> section in the manifest file. |
| /MANIFESTFILE/MANIFESTFILE | Zmienia domyślną nazwę pliku manifestu.Changes the default name of the manifest file. |
| /MANIFESTINPUT/MANIFESTINPUT | Określa plik wejściowy manifestu dla konsolidatora do przetworzenia i osadzenia w pliku binarnym.Specifies a manifest input file for the linker to process and embed in the binary. Można użyć tej opcji wiele razy, aby określić więcej niż jeden plik wejściowy manifestu.You can use this option multiple times to specify more than one manifest input file. |
| /MANIFESTUAC/MANIFESTUAC | Określa, czy informacje kontroli konta użytkownika (UAC) są osadzone w manifeście programu.Specifies whether User Account Control (UAC) information is embedded in the program manifest. |
| /MAP/MAP | Tworzy element mapfile.Creates a mapfile. |
| /MAPINFO/MAPINFO | Zawiera określone informacje w mapfile.Includes the specified information in the mapfile. |
| /MERGE/MERGE | Łączy sekcje.Combines sections. |
| /MIDL/MIDL | Określa opcje wiersza polecenia MIDL.Specifies MIDL command-line options. |
| /NATVIS/NATVIS | Dodaje Wizualizatory debugera z pliku Natvis do bazy danych programu (PDB).Adds debugger visualizers from a Natvis file to the program database (PDB). |
| /NOASSEMBLY/NOASSEMBLY | Pomija Tworzenie zestawu .NET Framework.Suppresses the creation of a .NET Framework assembly. |
| /NODEFAULTLIB/NODEFAULTLIB | Ignoruje wszystkie (lub określone) domyślne biblioteki, gdy odwołania zewnętrzne są rozwiązane.Ignores all (or the specified) default libraries when external references are resolved. |
| /NOENTRY/NOENTRY | Tworzy bibliotekę DLL tylko do zasobów.Creates a resource-only DLL. |
| /NOLOGO/NOLOGO | Pomija transparent startowy.Suppresses the startup banner. |
| /NXCOMPAT/NXCOMPAT | Oznacza plik wykonywalny jako zweryfikowany pod kątem zgodności z funkcją zapobiegania wykonywaniu danych systemu Windows.Marks an executable as verified to be compatible with the Windows Data Execution Prevention feature. |
| /OPT/OPT | Formanty łączy optymalizacje.Controls LINK optimizations. |
| /ORDER/ORDER | Umieszcza COMDAT w obrazie we wstępnie określonej kolejności.Places COMDATs into the image in a predetermined order. |
| /OUT/OUT | Określa nazwę pliku wyjściowego.Specifies the output file name. |
| /PDB/PDB | Tworzy plik PDB.Creates a PDB file. |
| /PDBALTPATH/PDBALTPATH | Używa alternatywnej lokalizacji do zapisania pliku PDB.Uses an alternate location to save a PDB file. |
| /PDBSTRIPPED/PDBSTRIPPED | Tworzy plik PDB, który nie ma prywatnych symboli.Creates a PDB file that has no private symbols. |
| /PGD/PGD | Określa .pgd plik dla optymalizacji z przewodnikiem.Specifies a .pgd file for profile-guided optimizations. |
| /POGOSAFEMODE/POGOSAFEMODE | Przestarzałe Tworzy bezpieczną wielowątkową kompilację PGO.Obsolete Creates a thread-safe PGO instrumented build. |
| /PROFILE/PROFILE | Tworzy plik wyjściowy, który może być używany z profilerem narzędzi wydajności.Produces an output file that can be used with the Performance Tools profiler. |
| /RELEASE/RELEASE | Ustawia sumę kontrolną w .exe nagłówku.Sets the Checksum in the .exe header. |
| /SAFESEH/SAFESEH | Określa, czy obraz będzie zawierać tabelę bezpiecznych procedur obsługi wyjątków.Specifies that the image will contain a table of safe exception handlers. |
| /SECTION/SECTION | Zastępuje atrybuty sekcji.Overrides the attributes of a section. |
| /SOURCELINK/SOURCELINK | Określa plik SourceLink do dodania do pliku PDB.Specifies a SourceLink file to add to the PDB. |
| /STACK/STACK | Ustawia rozmiar stosu w bajtach.Sets the size of the stack in bytes. |
| /STUB/STUB | Dołącza program zastępczy systemu MS-DOS do programu systemu Win32.Attaches an MS-DOS stub program to a Win32 program. |
| /SUBSYSTEM/SUBSYSTEM | Informuje system operacyjny, jak uruchomić .exe plik.Tells the operating system how to run the .exe file. |
| /SWAPRUN/SWAPRUN | Informuje system operacyjny, aby skopiował dane wyjściowe konsolidatora do pliku wymiany przed jego uruchomieniem.Tells the operating system to copy the linker output to a swap file before it's run. |
| /TLBID/TLBID | Określa identyfikator zasobu biblioteki typów generowanych przez konsolidator.Specifies the resource ID of the linker-generated type library. |
| /TLBOUT/TLBOUT | Określa nazwę .tlb pliku i inne pliki wyjściowe MIDL.Specifies the name of the .tlb file and other MIDL output files. |
| /TSAWARE/TSAWARE | Tworzy aplikację, która jest przeznaczona specjalnie do uruchamiania na serwerze terminali.Creates an application that is designed specifically to run under Terminal Server. |
| /USEPROFILE/USEPROFILE | W celu utworzenia zoptymalizowanego obrazu są stosowane dane szkoleniowe dotyczące optymalizacji opartej na profilach.Uses profile-guided optimization training data to create an optimized image. |
| /VERBOSE/VERBOSE | Drukuje wiadomości dotyczące postępu konsolidatora.Prints linker progress messages. |
| /VERSION/VERSION | Przypisuje numer wersji.Assigns a version number. |
| /WHOLEARCHIVE/WHOLEARCHIVE | Obejmuje każdy plik obiektu z określonych bibliotek statycznych.Includes every object file from specified static libraries. |
| /WINMD/WINMD | Włącza generowanie pliku metadanych środowisko wykonawcze systemu Windows.Enables generation of a Windows Runtime Metadata file. |
| /WINMDFILE/WINMDFILE | Określa nazwę pliku wyjściowego środowisko wykonawcze systemu Windows metadanych (WinMD), który jest generowany przez opcję konsolidatora /winmd .Specifies the file name for the Windows Runtime Metadata (winmd) output file that's generated by the /WINMD linker option. |
| /WINMDKEYFILE/WINMDKEYFILE | Określa klucz lub parę kluczy do podpisania środowisko wykonawcze systemu Windows pliku metadanych.Specifies a key or key pair to sign a Windows Runtime Metadata file. |
| /WINMDKEYCONTAINER/WINMDKEYCONTAINER | Określa kontener klucza do podpisania pliku metadanych systemu Windows.Specifies a key container to sign a Windows Metadata file. |
| /WINMDDELAYSIGN/WINMDDELAYSIGN | Częściowo podpisuje plik metadanych środowisko wykonawcze systemu Windows (WinMD), umieszczając klucz publiczny w pliku winmd.Partially signs a Windows Runtime Metadata (.winmd) file by placing the public key in the winmd file. |
| /WX/WX | Traktuje ostrzeżenia konsolidatora jako błędy.Treats linker warnings as errors. |
16,1 ta opcja jest dostępna począwszy od programu Visual Studio 2019 w wersji 16,1.16.1 This option is available starting in Visual Studio 2019 version 16.1.
Zobacz teżSee also
Dokumentacja konstrukcyjna języka C/C++C/C++ Building Reference
Dokumentacja konsolidatora MSVCMSVC linker reference