Задача ResolveAssemblyReference

AllowedRelatedFileExtensions

Необязательный параметр типа String[].

Расширение имени файла для поиска файлов, связанных друг с другом. Расширениями по умолчанию являются PDB и XML.

Assemblies

Необязательный параметр типа ITaskItem[].

Задает элементы, для которых необходимо определить полные пути и зависимости. Эти элементы могут иметь простые имена, например "System", или строгие имена, например "System, Version=2.0.3500.0, Culture=neutral, PublicKeyToken=b77a5c561934e089".

Элементы, передаваемые этому параметру, могут содержать следующие необязательные метаданные:

• Private: значение типа Boolean. Если параметр имеет значение true, то элемент копируется локально. Значение по умолчанию — true.

• HintPath: значение типа String. Задает путь и имя файла для использования в качестве ссылки. Используется, когда параметр SearchPaths имеет значение {HintPathFromItem}. Значение по умолчанию — пустая строка.

• SpecificVersion: значение типа Boolean. Если параметр имеет значение true, требуется точное совпадение с именем, указанным в атрибуте Include. Если параметр имеет значение false, то достаточно совпадения простого имени сборки. Если параметр SpecificVersion не указан, задача проверит значение атрибута Include элемента. Если атрибут является простым именем, он ведет себя так, как если бы параметр SpecificVersion имел значение false. Если атрибут является строгим именем, он ведет себя так, как если бы параметр SpecificVersion имел значение true.

• ExecutableExtension: значение типа String. Если данное значение присутствует, разрешенные сборки должны иметь это расширение. Если данное значение отсутствует, сначала рассматривается библиотека DLL, а затем EXE-файл для каждого исследуемого каталога.

• SubType: значение типа String. В полные пути сборок будут разрешаться только элементы, для которых параметр SubType пуст. Элементы с непустым параметром SubType будут проигнорированы.

• AssemblyFolderKey: значение типа String. Этот параметр поддерживается для обратной совместимости. Он определяет пользовательский раздел реестра, например "hklm\VendorFolder", с помощью которого элемент Assemblies должен разрешать ссылки на сборки.

AutoUnify

Необязательный параметр типа Boolean.

Если параметр имеет значение true, полученный граф зависимостей автоматически рассматривается таким образом, как если бы в параметр AppConfigFile был передан файл App.Config. Этот виртуальный файл App.Config содержит записи bindingRedirect для каждого конфликтующего набора сборок, в результате чего выбирается сборка с наибольшим номером версии. Результатом такой организации является отсутствие предупреждений о конфликтующих сборках, т. к. каждый конфликт разрешается. Результатом каждого отдельного повторного сопоставления станет высокоприоритетный комментарий, в котором будут указаны старая и новая версии, а также упомянут тот факт, что повторное сопоставление было выполнено автоматически ввиду того, что параметр AutoUnify имел значение true.

Если параметр имеет значение false, сопоставление версии сборки происходит автоматически. При наличии двух версий сборки будет показано сообщение с предупреждением. Результатом каждого отдельного конфликта между различными версиями одинаковых сборок станет высокоприоритетный комментарий. После отображения всех комментариев появится одно предупреждение с уникальным кодом ошибки и текстом "Найден конфликт между различными версиям зависимых сборок".

Значение по умолчанию — false.

CopyLocalFiles

Необязательный выходной параметр ITaskItem[], предназначенный только для чтения.

Возвращает каждый файл в параметрах ResolvedFiles, ResolvedDependencyFiles, RelatedFiles, SatelliteFiles и ScatterFiles , которые содержат элементы метаданных CopyLocal со значением true.

FindDependencies

Необязательный параметр типа Boolean.

Если параметр имеет значение true, зависимости будут обнаружены. В противном случае будут найдены только первичные ссылки. Значение по умолчанию — true.

FindSatellites

Необязательный параметр типа Boolean.

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

FullTargetFrameworkSubsetNames

Необязательный параметр типа String[].

Содержит список имен подмножеств требуемой версии .NET Framework. Если имя подмножества в списке совпадает с именем в свойстве TargetFrameworkSubset, система исключает конкретное подмножество требуемой версии .NET Framework во время построения.

IgnoreDefaultInstalledAssemblySubsetTables

Необязательный параметр типа Boolean.

Если параметр имеет значение true, задача ищет и использует дополнительные таблицы подмножеств сборок (или "списки подмножеств"), расположенные в папке \SubsetList по пути TargetFrameworkDirectories. Значение по умолчанию — false.

InstalledAssemblyTables

Необязательный параметр типа String.

Содержит список XML-файлов, определяющих сборки, которые предположительно будут установлены на целевом компьютере.

Если параметр InstalledAssemblyTables задан, более ранние версии сборок в списке будут объединены с более новыми версиями, указанными в XML-файле. Кроме того, сборки, для которых не указано значение InGAC='true', считаются необходимыми для установки, и для них устанавливается CopyLocal='false', если нет явного переопределения.

Элементы в этом списке могут содержать метаданные "FrameworkDirectory" для связывания элемента InstalledAssemblyTable с конкретным каталогом .NET Framework. Но этот параметр не учитывается, если имя Redist начинается с

"Microsoft-Windows-CLRCoreComp".

Если имеется только один элемент TargetFrameworkDirectories, то все элементы списка, для которых нет метаданных "FrameworkDirectory", обрабатываются так, как если бы им было присвоено уникальное значение, передаваемое

в TargetFrameworkDirectories.

ResolvedDependencyFiles

Необязательный выходной параметр ITaskItem[], предназначенный только для чтения.

Содержит зависимости n-го порядка. Этот параметр не включает первичные ссылки, содержащиеся в параметре ResolvedFiles.

Элементы этого параметра могут содержать следующие метаданные элементов.

• CopyLocal: значение типа Boolean. Указывает, следует ли скопировать данную ссылку в выходной каталог.

• FusionName: значение типа String. Задает имя зависимости.

• ResolvedFrom: значение типа String. Указывает символьный путь поиска, с которого разрешается этот файл.

SatelliteFiles

Необязательный выходной параметр ITaskItem[], предназначенный только для чтения.

Указывает любые вспомогательные файлы. Параметр "CopyLocal" должен иметь значение "true", если ссылка или зависимость, вызвавшая этот элемент, имеет элемент метаданных "CopyLocal" со значением "true".

Элементы этого параметра могут содержать следующие метаданные элементов.

• CopyLocal: значение типа Boolean. Указывает, следует ли скопировать данную ссылку в выходной каталог. Параметр этого элемента имеет значение true, если ссылка или зависимость, вызвавшая этот элемент, имеет элемент метаданных CopyLocal со значением true.

• DestinationSubDirectory: значение типа String. Указывает относительный каталог, в который копируется этот элемент.

SearchPaths

Обязательный параметр типа String[].

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

Этот параметр принимает значения следующих типов.

• Путь к каталогу.

• {HintPathFromItem}: указывает задаче проверять метаданные HintPath основного элемента.

• {CandidateAssemblyFiles}: указывает задаче проверять файлы, передаваемые в параметр CandidateAssemblyFiles.

• {Registry:_AssemblyFoldersBase_, _RuntimeVersion_, _AssemblyFoldersSuffix_}:

• {AssemblyFolders}: указывает задаче использовать схему поиска сборок из реестра Visual Studio .NET 2003.

• {GAC}: указывает задаче выполнять поиск в глобальном кэше сборок.

• {RawFileName}: указывает задаче принимать значение элемента Include как точный путь и имя файла.

StateFile

Необязательный параметр типа String.

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

TargetFrameworkDirectories

Необязательный параметр типа String[].

Указывает путь к каталогу требуемой версии .NET Framework. Этот параметр необходим для определения состояния свойства CopyLocal для результирующих элементов.

Если этот параметр не задан, результирующие элементы не будут иметь значение CopyLocal true до тех пор, пока для исходных элементов не будет явно установлено значение true для метаданных Private.

TargetFrameworkVersion

Необязательный параметр типа String.

Требуемая версия .NET Framework для проекта. Значение по умолчанию пустое, что свидетельствует об отсутствии фильтрации для ссылок, исходя из требуемой версии .NET Framework.