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

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