Задача ResolveComReference
Принимает список из одного или нескольких имен библиотек типов или TLB-файлов и определяет местоположение этих библиотек типов на диске.
Параметры
В следующей таблице описаны параметры задачи ResolveCOMReference.
Параметр |
Описание |
|---|---|
DelaySign |
Необязательный параметр типа Boolean. Если значение равно true, в сборку добавляется открытый ключ. Если значение равно false, сборка полностью подписывается. |
EnvironmentVariables |
Необязательный параметр типа String[]. Массив пар из переменных окружения, разделенных знаками равенства. Эти переменные должны быть переданы файлам tlbimp.exe и aximp.exe в дополнение к обычному блоку среды (или частично переопределяя его). |
ExecuteAsTool |
Необязательный параметр типа Boolean. Если true, выполняет tlbimp.exe и aximp.exe из соответствующей требуемой версии .NET Framework из внешнего процесса для создания необходимых сборок-оболочек. Этот параметр позволяет настройку для различных версий. |
IncludeVersionInInteropName |
Необязательный параметр типа Boolean. Если true, версия библиотеки typelib включается в имя оболочки. По умолчанию используется значение false. |
KeyContainer |
Необязательный параметр типа String. Задает контейнер, хранящий открытый/закрытый пара ключей. |
KeyFile |
Необязательный параметр типа String. Задает элемент, содержащий открытый/закрытый пара ключей. |
NoClassMembers |
Необязательный параметр типа Boolean. |
ResolvedAssemblyReferences |
Необязательный выходной параметр ITaskItem[]. Задает разрешенные ссылки на сборки. |
ResolvedFiles |
Необязательный выходной параметр ITaskItem[]. Задает полные имена файлов на диске, соответствующие физическому местоположению библиотек типов, которые были указаны во входных данных задачи. |
ResolvedModules |
Необязательный параметр ITaskItem[] . |
SdkToolsPath |
Необязательный параметр типа [String]. Если для свойства ExecuteAsTool задано значение true, для данного параметра необходимо задать путь к инструментам SDK для целевой версии платформы. |
StateFile |
Необязательный параметр типа [String]. Задает Файл кэша для отметок времени COM-компонентов. Если не существует, при каждом запуске все оболочки будут создаваться заново. |
TargetFrameworkVersion |
Необязательный параметр типа [String]. Задает требуемую версию .NET Framework для проекта. По умолчанию используется значение String.Empty. что свидетельствует об отсутствии фильтрации ссылок по требуемой версии .NET Framework. |
TargetProcessorArchitecture |
Необязательный параметр типа [String]. Задает Предпочитаемая архитектура процессора. Передан tlbimp.exe с флагом /Machine после транзакции. Значение параметра должно быть членом ProcessorArchitecture. |
TypeLibFiles |
Необязательный параметр ITaskItem[] . Задает путь к файлу библиотеки типов для COM-ссылок. Элементы в этом параметре могут содержать метаданные. Дополнительные сведения см. далее в разделе "Метаданные элементов TypeLibFiles". |
TypeLibNames |
Необязательный параметр ITaskItem[] . Задает имена библиотек типов, которые требуется разрешить. Элементы в этом параметре должны содержать определенные метаданные. Дополнительные сведения см. далее в разделе "Метаданные элементов TypeLibNames". |
WrapperOutputDirectory |
Необязательный параметр типа String. Расположение на диске, в которое помещается сгенерированная сборка взаимодействия. Если метаданные для этого элемента не заданы, задача использует абсолютный путь к каталогу, где располагается файл проекта. |
Заметки
Предназначается для 32-разрядных компонентов на 64-разрядных компьютерах
На 64-битном компьютере Framework64/<версия>/msbuild не удается разрешить библиотеку COM-объектов, зарегистрированных как 32-разрядные компоненты. Например, при регистрации COM-объекта с regsvr32 и попытке построения проекта, предназначенного для платформы x86 с Framework64/<версия>/msbuild, построение не сможет разрешить COM-объект. Если построение выполняется с помощью Framework/<версия>/msbuild, построения может разрешить COM-объект.
Метаданные элементов TypeLibNames
В следующей таблице описываются метаданные элементов, передаваемых параметру TypeLibNames.
Метаданные |
Описание |
|---|---|
GUID |
Обязательные метаданные элемента. GUID библиотеки типов. Если эти метаданные для элемента не заданы, происходит сбой выполнения задачи. |
VersionMajor |
Обязательные метаданные элемента. Основной номер версии библиотеки типов. Если эти метаданные для элемента не заданы, происходит сбой выполнения задачи. |
VersionMinor |
Обязательные метаданные элемента. Дополнительный номер версии библиотеки типов. Если эти метаданные для элемента не заданы, происходит сбой выполнения задачи. |
LocaleIdentifier |
Необязательные метаданные элемента. Идентификатор языкового стандарта (LCID) для библиотеки типов. Задается в виде 32-разрядного значения, идентифицирующего предпочтительный естественный язык для пользователя, области или приложения. Если эти метаданные для элемента не заданы, задача использует заданный по умолчанию идентификатор языкового стандарта, равный "0". |
WrapperTool |
Необязательные метаданные элемента. Задает инструмент создания оболочек, при помощи которого генерируется оболочка сборки для данной библиотеки типов. Если эти метаданные для элемента не заданы, задача использует заданный по умолчанию инструмент создания оболочек "tlbimp". На выбор доступны следующие средства создания оболочек (регистр символов не имеет значения):
|
Метаданные элементов TypeLibFiles
В следующей таблице описываются метаданные элементов, передаваемых параметру TypeLibFiles.
Метаданные |
Описание |
|---|---|
WrapperTool |
Необязательные метаданные элемента. Задает инструмент создания оболочек, при помощи которого генерируется оболочка сборки для данной библиотеки типов. Если эти метаданные для элемента не заданы, задача использует заданный по умолчанию инструмент создания оболочек "tlbimp". На выбор доступны следующие средства создания оболочек (регистр символов не имеет значения):
|
.gif "Примечание") Примечание |
|---|
Чем больше информации вы предоставите для уникальной идентификации библиотеки типов, тем больше вероятности, что задачей будет выбран правильный файл на диске. |
Заметки
Помимо параметров, которые перечислены выше, эта задача наследует параметры от класса Task. Чтобы получить список этих доп параметров и их описаний, см. Базовый класс Task.