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