/INCREMENTAL (Приращение ссылки)

Указывает, следует ли ссылаться постепенно или всегда выполнять полную ссылку.

Синтаксис

/INCREMENTAL[:NO]

Замечания

Параметр /INCREMENTAL компоновщика определяет, как компоновщик обрабатывает добавочное связывание.

По умолчанию компоновщик работает в инкрементном режиме. Чтобы переопределить добавочную ссылку по умолчанию, укажите /INCREMENTAL:NO.

Добавочная связанная программа функционально эквивалентна программе, которая не является добавочной. Однако, так как он подготовлен к последующим добавочным ссылкам, добавочно связанному исполняемому файлу, статической библиотеке или файлу библиотеки динамической компоновки:

  • Больше, чем добавочная связанная программа из-за заполнения кода и данных. Заполнение позволяет компоновщику увеличивать размер функций и данных без повторного создания файла.

  • Может содержать преобразователи переходов для обработки размещения функций по новым адресам.

    Примечание.

    Чтобы убедиться, что окончательная сборка выпуска не содержит заполнение или отложение, свяжите программу без добавочного.

Чтобы приращение ссылки независимо от значения по умолчанию, укажите /INCREMENTAL. Если этот параметр выбран, компоновщик выдает предупреждение, если он не может приращение связи, а затем связывает программу без добавочного. Некоторые варианты и ситуации переопределяются /INCREMENTAL.

Большинство программ можно компоновать инкрементно. Тем не менее некоторые изменения слишком значительны, а некоторые параметры — несовместимы с инкрементной компоновкой. LINK выполняет полною компоновку, если указаны любые из следующих параметров:

  • Приращение ссылки не выбрано (/INCREMENTAL:NO)

  • /OPT:REF выбран

  • /OPT:ICF выбран

  • /OPT:LBR выбран

  • /ORDER выбран

/INCREMENTAL подразумевается при /DEBUG указании.

Кроме того, LINK выполняет полную компоновку, если возникает одна из следующих ситуаций:

  • Отсутствует добавочный файл состояния (.ilk). (LINK создает новый .ilk файл в подготовке к последующему добавочному связыванию.)

  • Для файла нет разрешения на .ilk запись. (LINK игнорирует .ilk файл и ссылки, не инкрементно.)

  • Отсутствует или .dll выходной .exe файл.

  • Метка времени или .ilk.exe.dll изменена.

  • Изменен параметр LINK. Изменение большинства параметров LINK между сборками вызывают полную компоновку.

  • Файл объекта (.obj) добавляется или опущен.

Добавочная ссылка создает или обновляет файл базы данных .ilk добавочного канала. Имя и расположение этого файла можно указать с помощью /ILK параметра компоновщика (файл добавочной базы данных). Дополнительные сведения о .ilk файле см. в файлах .ilk в качестве входных данных компоновщика.

Задание данного параметра компоновщика в среде разработки Visual Studio

  1. Откройте диалоговое окно Страницы свойств проекта. Подробнее см. в статье Настройка компилятора C++ и свойства сборки в Visual Studio.

  2. Выберите страницу свойств>компоновщика>конфигурации "Общие свойства".

  3. Измените свойство Enable Incremental Linking .

Задание данного параметра компоновщика программным способом

  1. См. раздел LinkIncremental.

См. также

Справочник по компоновщику MSVC
Параметры компоновщика MSVC
.ilk файлы в качестве входных данных компоновщика