Страницы свойств компоновщика

Следующие свойства находятся в разделе ProjectPropertiesConfiguration PropertiesLinker. Дополнительные сведения о компоновщике см. в разделе CL Вызов компоновщика и Опции компоновщика.

Страница свойств "Общие"

Выходной файл

Опция переопределяет заданное по умолчанию имя и расположение программы, которую создает компоновщик.

Отображать ход выполнения

Печать сообщений о ходе выполнения компоновщика

Варианты

  • Не задано — нет детализации.
  • Отображение всех сообщений о ходе выполнения — отображает все сообщения о ходе выполнения.
  • При поиске библиотек отображаются прогресс-сообщения, показывающие только библиотеки, в которых был выполнен поиск.
  • О свертке COMDAT во время оптимизированной компоновки. Отображает сведения о свертке COMDAT во время оптимизированной компоновки.
  • Сведения об удалении данных во время оптимизированной компоновки — отображает сведения о функциях и данных, удаленных во время оптимизированной компоновки.
  • Сведения о модулях, несовместимых с SEH . Отображает сведения о модулях, несовместимых с безопасной обработкой исключений.
  • Сведения о деятельности компоновщика, связанной с управляемым кодом. Отобразите сведения о деятельности компоновщика, связанной с управляемым кодом.

Версия

Параметр указывает компоновщику поместить номер версии в заголовок или файл. Используется для просмотра поля версии образа для просмотра эффекта .

Включить инкрементную компоновку

Включает инкрементную компоновку. ()

Указывает расположение файла базы данных инкрементной компоновки. ()

Отключить загрузочное объявление

Параметр запрещает отображение сообщения об авторских правах и номера версии.

Игнорировать библиотеку импорта

Это свойство сообщает компоновщику не связывать выходные данные, созданные в результате этой сборки, в любой зависимый проект. Она позволяет системе проекта обрабатывать файлы, которые не создают файл при сборке. Если проект зависит от другого проекта, создающего библиотеку DLL, система проекта автоматически связывает файл, созданный этим дочерним проектом. Это свойство может быть ненужным в проектах, которые создают библиотеки DLL com или библиотеки DLL только для ресурсов, так как эти библиотеки DLL не имеют значимых экспортов. Если библиотека DLL не содержит экспортируемых функций, компоновщик не создает никакой файл. Если файл экспорта отсутствует, и система проекта указывает компоновщику связать с отсутствующей библиотекой DLL, связь завершается неудачей. Для устранения этой проблемы используйте свойство Пропустить библиотеку импорта. Если задано значение "Да", система проекта игнорирует наличие или отсутствие файла и приводит к тому, что любой проект, зависящий от этого проекта, не связан с несуществующим файлом.

Для программного доступа к этому свойству см. раздел .

Зарегистрировать вывод

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

Для программного доступа к этому свойству см. раздел .

Перенаправление для пользователей

Регистрация в Visual Studio традиционно выполняется в HKEY_CLASSES_ROOT (HKCR). С помощью #REF! и более поздних операционных систем для доступа к HKCR необходимо запустить Visual Studio в режиме с повышенными привилегиями. Разработчики не всегда хотят работать в режиме с повышенными привилегиями, но по-прежнему должны работать с регистрацией. Перенаправление для пользователя позволяет вам зарегистрироваться без необходимости выполнять программу в режиме с повышенными привилегиями.

Перенаправление для каждого пользователя заставляет все записи в HKCR перенаправляться в (HKCU). Если перенаправление для каждого пользователя отключено, это может вызвать ошибку сборки проекта PRJ0050, когда программа пытается записать в HKCR.

Дополнительные каталоги библиотек

Позволяет пользователю переопределить путь к библиотеке среды. ()

Указывает, следует ли связывать файлы, созданные зависимыми проектами. Как правило, вы хотите связать файлы, но это может быть не так для некоторых библиотек DLL.

Вы также можете указать файл, указав имя файла и относительный путь, например . Если исходный код для файла использует предварительно скомпилированные заголовки, например, то такой файл расположен в той же папке, что и . Кроме того, необходимо добавить в качестве дополнительной зависимости.

Использовать входные данные зависимостей библиотек

Указывает, следует ли использовать входные данные инструмента библиотекаря, а не сам файл библиотеки как таковой, при связывании выходных данных библиотек из зависимостей проекта. В большом проекте, когда зависимый проект создает файл, добавочное связывание отключается. Если есть много зависимых проектов, создающих файлы, создание приложения может занять много времени. Если это свойство установлено в "Да", система проекта добавляет ссылки на файлы для [файлы], создаваемые зависимыми проектами, тем самым позволяя выполнение инкрементного связывания.

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

Указывает, должен ли компоновщик отображать индикатор хода выполнения, показывающий процент завершения процесса компоновки. Настройка по умолчанию — не отображать эту информацию о состоянии. ()

Запрет привязки DLL

задает бит в заголовке библиотеки DLL, указывающий на то, что привязка образа не разрешена. Если DLL имеет цифровую подпись, привязывать ее не следует (при привязке цифровая подпись становится недействительной).

Рассматривать предупреждения компоновщика как ошибки

Если компоновщик выдает предупреждение, это не приводит к созданию выходного файла.

Принудительный вывод файла

Параметр сообщает компоновщику создать объектный файл или библиотеку DLL, даже если символ упомянут, но не определён, или если он определён несколько раз. Он может создать недопустимый файл.

Варианты

  • Включение без аргументов подразумевает и то, и другое.
  • Умножение определенного символа — используется для создания выходного файла, даже если LINK находит несколько определений для символа.
  • Неопределенный символ — используется для создания выходного файла независимо от того, находит ли LINK неопределенный символ. игнорируется, если символ точки входа остался неразрешённым.

Создание образа для горячего исправления

Готовит образ к оперативному исправлению.

Варианты

  • Включено. Подготавливает образ для горячего патчинга.
  • Только образ X86 — подготавливает образ X86 к горячему обновлению.
  • Только образ X64— подготавливает образ X64 для горячего исправления.
  • Только образ Itanium — подготавливает образ Itanium для горячего обновления.

Указание атрибутов раздела

Параметр изменяет атрибуты раздела, переопределяя атрибуты, заданные при компиляции файла для раздела.

Страница "Входное свойство"

Дополнительные зависимости

Указывает дополнительные элементы зависимостей, добавляемые в командную строку ссылки, например .

Игнорировать все библиотеки по умолчанию

Параметр указывает компоновщику удалить одну или несколько библиотек по умолчанию из списка, в котором он ищет при разрешении внешних ссылок.

Игнорировать конкретные стандартные библиотеки

Указывает одно или несколько имен пропускаемых библиотек по умолчанию. Разделите несколько библиотек точкой с запятой. ()

Файл определения модуля

Этот параметр передает файл определения модуля () компоновщику. Для LINK можно указать только один файл.

Добавление модуля в сборку

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

Внедрение управляемого файла ресурсов

внедряет файл ресурса в выходной файл.

Принудительно включать ссылки на символы

Опция сообщает компоновщику добавить указанный символ в таблицу символов.

Задержанная загрузка DLL библиотек

Этот параметр приводит к задержке загрузки библиотек DLL. Имя DLL указывает библиотеку для отложенной загрузки.

Параметр /ASSEMBLYLINKRESOURCE создает ссылку на ресурс .NET Framework в выходном файле. Компоновщик не помещает файл ресурса в исходный файл.

Страница свойств файла манифеста

Создание манифеста

указывает, что компоновщик должен создать параллельный файл манифеста.

Файл манифеста

позволяет изменить имя файла манифеста по умолчанию. Имя файла манифеста по умолчанию — это имя файла с добавленным суффиксом.

Дополнительные зависимости манифеста

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

Разрешить изоляцию

Задает поведение поиска манифеста. ()

Включение контроля учетных записей пользователей (UAC)

Указывает, включена ли контроль учетных записей пользователей. ()

Уровень выполнения UAC

Указывает запрошенный уровень выполнения для приложения при запуске с помощью управления учетными записями пользователей. ()

Варианты

  • asInvoker — уровень выполнения UAC: как вызывающий.
  • наивысший доступный - уровень выполнения UAC: наивысший доступный.
  • requireAdministrator — уровень выполнения UAC: требуется администратор.

Обход защиты пользовательского интерфейса UAC

Указывает, следует ли обходить уровни защиты пользовательского интерфейса для других окон на рабочем столе. Задайте для этого свойства значение "Да" только для приложений специальных возможностей. ()

Страница свойств отладки

Создание сведений об отладке

Этот параметр позволяет создавать сведения об отладке для файла или библиотеки DLL.

Варианты

  • Нет — не создает сведений об отладке.
  • Создание сведений об отладке. Создание полной базы данных программы (PDB) идеально подходит для распространения на сервер символов Майкрософт.
  • Создание отладочной информации, оптимизированной для ускоренного связывания. Создает идеальную базу данных программы (PDB) для быстрого цикла редактирования, связывания и отладки.
  • Генерация сведений об отладке, оптимизированных для общего доступа и публикации, создает базу данных программы (PDB), которая идеально подходит для общего цикла редактирования, связывания и отладки.

Создание файла базы данных программы

По умолчанию при указании компоновщик создает базу данных программы (PDB), содержащую сведения об отладке. Имя файла по умолчанию для PDB имеет базовое имя программы и расширения .

Удаление частных символов

Параметр создает второй файл базы данных программы (PDB-файл), когда вы собираете образ программы с любым из параметров компилятора или компоновщика, которые создают PDB-файл ( , , , или ).

Создание файла карты

Параметр сообщает компоновщику создать файл карты.

Имя файла карты

Указанное пользователем имя файла mapfile. Он заменяет имя по умолчанию.

Экспорт карт

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

Отлаживаемая сборка

выдает атрибут с отслеживанием сведений отладки и отключает оптимизацию JIT.

Поддержка динамической отладки C++

(Предварительная версия) Установите флаг компоновщика для включения динамической отладки C++. Размещайте неоптимизованные точки останова и выполняйте переход внутрь функций в любом месте с деоптимизацией функции по запросу. Используйте этот режим для отладки оптимизированного кода.

Страница свойств системы

Подсистема

Параметр сообщает операционной системе, как запустить файл. Выбор подсистемы влияет на идентификатор точки входа (или функцию точки входа), которую будет выбирать компоновщик.

Варианты

  • Не задано — подсистема не задана.
  • Консоль — приложение в режиме символов Win32. Консольные приложения получают консоль от операционной системы. Если определено или , то используется значение по умолчанию.
  • #REF! — приложению не требуется консоль, вероятно, потому что она создает собственные windows для взаимодействия с пользователем. Если или определено, используется значение по умолчанию.
  • Native — драйверы устройств для #REF! NT. Если задано, используется значение по умолчанию.
  • Приложение EFI — приложение EFI.
  • Драйвер службы загрузки EFI — драйвер службы загрузки EFI.
  • EFI ROM - EFI ROM.
  • EFI Runtime — среда выполнения EFI.
  • POSIX — приложение, работающее с подсистемой POSIX в #REF! NT.

Минимальная требуемая версия

Укажите минимальную требуемую версию подсистемы. Аргументы — десятичные числа в диапазоне от 0 до 65535.

Размер резерва кучи

Указывает общий размер выделения кучи в виртуальной памяти. Значение по умолчанию — 1 МБ. ()

Размер фиксации кучи

Указывает общий размер выделения кучи в физической памяти. Значение по умолчанию — 4 КБ. ()

Размер резерва стека

Определяет общий размер виртуальной памяти, выделяемой для стека. Значение по умолчанию — 1 МБ. ()

Размер фиксации стека

Указывает общий размер выделения стека в физической памяти. Значение по умолчанию — 4 КБ. ()

Включите большие адреса

Опция сообщает компоновщику, что приложение может обрабатывать адреса размером свыше 2 гигабайт. По умолчанию включен, если в строке компоновщика не указано иное.

Terminal Server (Сервер терминалов)

Опция задает флаг в поле необязательного заголовка образа программы. При установке этого флага сервер терминалов не будет вносить определенные изменения в приложение.

Переключение запуска с компакт-диска

Параметр сообщает операционной системе сначала скопировать выходные данные редактора связей в файл подкачки, а затем запустить образ оттуда. Этот параметр является функцией #REF! NT 4.0 (и более поздних версий). При указании операционная система копирует образ на съемный диск в файл страницы, а затем загружает его.

Смена запуска из сети

Параметр сообщает операционной системе сначала скопировать выходные данные компоновщика в файл буфера, а затем запустить образ. Этот параметр является функцией #REF! NT 4.0 (и более поздних версий). Если задано, операционная система сначала копирует двоичный образ из сети в файл буфера и загружает его из него. Этот параметр полезен для запуска приложений по сети.

Драйвер

Используйте параметр компоновщика /DRIVER для создания драйвера режима ядра NT #REF!.

Варианты

  • Не задано — параметр драйвера по умолчанию.
  • Драйвер — драйвер
  • UP вызывает добавление бита в характеристики заголовка выходных данных для указания, что это драйвер для юнипроцессора (UP). Операционная система откажется загрузить драйвер UP в систему с несколькими обработчиками (MP).
  • WDM приводит к тому, что компоновщик устанавливает бит в поле необязательного заголовка.

Страница свойств оптимизации

Ссылки

устраняет функции и (или) данные, на которые никогда не ссылаются, в то время как сохраняет функции и (или) данные, на которые никогда не ссылаются.

Включить свертывание записей COMDAT

Используйте для выполнения идентичного свертывания COMDAT.

Порядок функций

Параметр указывает LINK оптимизировать вашу программу, расположив определенные COMDAT в образе в заранее заданном порядке. LINK помещает функции в указанный порядок в каждом разделе изображения.

База данных с управлением по профилю

Укажите файл для оптимизаций, управляемых профилем. ()

Задает генерацию кода на этапе компоновки. ()

Варианты

  • По умолчанию — параметр LTCG по умолчанию .
  • Используйте создание кода времени быстрого соединения. Используйте создание кода времени связи с .
  • Используйте генерацию кода во время линковки. Используйте генерацию кода во время линковки.
  • Профильная оптимизация — инструмент. Используйте профильную оптимизацию.
  • Оптимизация на базе профиля: указывает, что компоновщик должен использовать профильные данные, созданные после запуска инструментированного бинарного файла, для создания оптимизированного образа.
  • Руководство по оптимизации профиля — обновление — позволяет добавлять или изменять список входных файлов, которые были указаны на этапе.

Указывает расположение файла. ()

Страница свойств встроенного IDL

Команды MIDL

Укажите параметры командной строки MIDL. ()

Игнорировать внедренный IDL

Параметр указывает, что любые атрибуты IDL в исходном коде не должны обрабатываться в файл.

Объединенное имя базового файла IDL

Параметр задает имя и расширение файла.

Библиотека типов

Параметр задает имя и расширение файла.

Идентификатор ресурса TypeLib

Позволяет указать идентификатор ресурса созданной компоновщиком библиотеки типов. ()

страница свойств метаданных #REF!

Создание метаданных #REF!

Включает или отключает создание метаданных #REF!.

Варианты

  • Yes — включение создания файлов метаданных #REF!.
  • No — отключите создание файлов метаданных #REF!.

Файл метаданных #REF!

Переключатель опций.

Файл ключа метаданных #REF!

Укажите пару ключей или ключей, чтобы подписать метаданные #REF!. ()

Контейнер ключей метаданных #REF!

Укажите контейнер ключей для подписывания метаданных #REF!. ()

#REF! знак задержки метаданных

Частично подпишите метаданные #REF!. Используйте /WINMDDELAYSIGN, если вы хотите поместить открытый ключ только в метаданные #REF!. Значение по умолчанию — .

Страница расширенных свойств

Точка входа

Параметр задает функцию точки входа в качестве начального адреса для файла или библиотеки DLL.

Точка входа отсутствует

Этот параметр необходим для создания DLL, содержащей только ресурсы. Используйте этот параметр, чтобы LINK не добавлял ссылку на объект в DLL.

Установка контрольной суммы

Параметр задает контрольную сумму в заголовке файла.

Базовый адрес

Задает базовый адрес для программы. ()

Случайный базовый адрес

Случайный базовый адрес. ()

Фиксированный базовый адрес

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

Предотвращение выполнения данных (DEP)

Помечает исполняемый файл как тестируемый для совместимости с функцией предотвращения выполнения данных #REF!. ()

Отключите создание сборок

Параметр /NOASSEMBLY сообщает компоновщику создать образ для текущего выходного файла без сборки .NET Framework.

Выгрузка библиотеки DLL с отложенной загрузкой

Квалификатор сообщает функции помощника задержанной загрузки для поддержки явной выгрузки библиотеки DLL. ()

Nobind загружаемая с задержкой DLL

Квалификатор сообщает компоновщику не включать привязываемую таблицу адресов импортов (IAT) в конечный файл. По умолчанию создаётся привязываемая IAT для библиотек DLL, загружаемых с задержкой. ()

Импорт библиотеки

Переопределяет имя библиотеки импорта по умолчанию. ()

Объединить разделы

Параметр объединяет первый раздел со вторым разделом и дает результирующее имя второго раздела. Например, объединяет раздел с разделом и именует объединенный раздел.

Целевая машина

Параметр задает целевую платформу для программы.

Варианты

  • Не задан
  • MachineARM
  • MachineARM64
  • MachineEBC
  • MachineIA64
  • MachineMIPS
  • MachineMIPS16
  • MachineMIPSFPU
  • MachineMIPSFPU16
  • MachineSH4
  • MachineTHUMB
  • MachineX64
  • MachineX86

Профиль

Создает выходной файл, который может быть использован для профилировщика производительности. Требуется, чтобы для свойства Generate Debug Info было задано значение GenerateDebugInformation (/DEBUG). ()

Атрибут потока CLR

Явно укажите атрибут многопоточности для точки входа вашей программы CLR.

Варианты

  • Атрибут потоков MTA— применяет атрибут MTAThreadAttribute к точке входа программы.
  • Атрибут потоков STA — применяет атрибут STAThreadAttribute к точке входа программы.
  • Атрибут потоков по умолчанию — то же самое, как если бы он не был указан. Позволяет среде CLR задать атрибут потоков по умолчанию.

Тип образа CLR

Задает тип (IJW, pure или safe) CLR-образа.

Варианты

  • Принудительное использование образа IJW
  • Принудительное использование изображения Pure IL
  • Принудительное создание безопасного образа IL
  • Тип изображения по умолчанию

Файл ключа

Укажите ключ или пару ключей, чтобы подписать сборку. ()

Контейнер ключей

Укажите контейнер ключей для подписи сборки. ()

Знак задержки

Частично подписать сборку. Используйте, только если вы хотите поместить открытый ключ в сборку. Значение по умолчанию — .

Проверка неуправляемого кода в среде CLR

Указывает, будет ли компоновщик применяться к вызовам P/Invoke, созданным компоновщиком, из управляемого кода в собственные библиотеки DLL.

Отчет об ошибках

Позволяет предоставлять сведения о внутренней ошибке компилятора (ICE) непосредственно команде Visual Studio C++.

Варианты

  • PromptImmediately — выполнить запрос немедленно.
  • Очередь на следующий вход — очередь для следующего входа.
  • Отправка отчета об ошибке — отправить отчет об ошибке.
  • Отсутствует отчет об ошибке — нет отчета об ошибке.

Выравнивание секции

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

Сохранение последнего кода ошибки для вызовов PInvoke

, который по умолчанию включен, сохраняет последний код ошибки функций, вызываемых с помощью механизма P/Invoke, который позволяет вызывать собственные функции в DLLS из кода, скомпилированного с помощью.

Варианты

  • Включено — Включить.
  • Отключено — отключить .
  • Только системные библиотеки DLL— включите только системные библиотеки DLL.

Совместимый с теневым стеком CET

Указывает, следует ли пометить исполняемый образ как совместимый с теневым стеком технологии CET (принудительное управление потоками). ()

Изображение имеет безопасные обработчики исключений

При указании параметра компоновщик создает только образ, если он также может создать таблицу образа безопасных обработчиков исключений. Эта таблица определяет, какие обработчики исключений допустимы для образа в рамках операционной системы.

  • Last updated on