/INCREMENTAL (Přírůstkové propojení)

  • Článek

Určuje, jestli se má propojit přírůstkově, nebo vždy provést úplné propojení.

Syntaxe

/INCREMENTAL[:NO]

Poznámky

Možnost /INCREMENTAL linkeru určuje, jak linker zpracovává přírůstkové propojení.

Linker se standardně spouští v přírůstkovém režimu. Chcete-li přepsat výchozí přírůstkové propojení, zadejte /INCREMENTAL:NO.

Přírůstkově propojený program je funkčně ekvivalentní programu, který není přírůstkově propojený. Protože je ale připravený na následné přírůstkové odkazy, přírůstkově propojený spustitelný soubor, statickou knihovnu nebo soubor dynamické knihovny:

  • Je větší než program, který není přírůstkově propojený kvůli odsazení kódu a dat. Odsazení umožňuje linkeru zvětšit velikost funkcí a dat bez opětovného vytvoření souboru.

  • Mohou obsahovat převodní rutiny odskoků, které ošetřují přemístění funkcí na nové adresy.

    Poznámka:

    Pokud chcete zajistit, aby konečné sestavení vydané verze neobsahuje odsazení nebo bloky, propojte program nekrementálně.

Chcete-li propojit přírůstkově bez ohledu na výchozí hodnotu, zadejte /INCREMENTAL. Pokud je tato možnost vybraná, linker vydá upozornění, pokud nejde propojit přírůstkově, a pak propojí program, který není přírůstkový. Některé možnosti a situace přepíší /INCREMENTAL.

Většinu programů lze propojit přírůstkově. Některé změny jsou ale příliš rozsáhlé a některé parametry nejsou s přírůstkovým propojením kompatibilní. Při zadání libovolného z následujících parametrů provede příkaz LINK úplné propojení:

  • Přírůstkové propojení není zaškrtnuté (/INCREMENTAL:NO)

  • /OPT:REF je vybráno

  • /OPT:ICF je vybráno

  • /OPT:LBR je vybráno

  • /ORDER je vybráno

/INCREMENTAL je implicitní při /DEBUG zadání.

Příkaz LINK navíc provede úplné propojení, pokud dojde k některé z následujících situací:

  • Chybí soubor přírůstkového stavu (.ilk). (LINK vytvoří nový .ilk soubor v rámci přípravy na následné přírůstkové propojení.)

  • Soubor nemá oprávnění k zápisu .ilk . (ODKAZ ignoruje soubor a odkazy .ilk , které nejsou přírůstkové.)

  • Chybí .exe výstupní .dll soubor.

  • Časové razítko .ilk, .exenebo .dll je změněno.

  • Některý parametr příkazu LINK se změnil. Při změně mezi sestaveními způsobí většina parametrů příkazu LINK úplné propojení.

  • Objekt (.obj) soubor je přidán nebo vynechán.

Přírůstkové propojení vytvoří nebo aktualizuje soubor databáze .ilk přírůstkového propojení. Název a umístění tohoto souboru můžete zadat pomocí možnosti linkeru /ILK (Název přírůstkového databázového souboru ). Další informace o .ilk souboru najdete v souborech .ilk jako vstup linkeru.

Nastavení tohoto parametru linkeru ve vývojovém prostředí sady Visual Studio

  1. Otevřete dialogové okno Stránky vlastností projektu. Podrobnosti najdete v tématu Nastavení kompilátoru C++ a vlastností sestavení v sadě Visual Studio.

  2. Vyberte stránku vlastností linkeru>Obecné vlastnosti konfigurace>.

  3. Upravte vlastnost Povolit přírůstkové propojení.

Programové nastavení tohoto parametru linkeru

  1. Viz třída LinkIncremental.

Viz také

Referenční zdroje k linkeru MSVC
Možnosti linkeru MSVC
.ilk soubory jako vstup linkeru