AssignCulture - задача
Эта задача принимает список элементов, которые могут содержать допустимую строку идентификатора языка и региональных параметров .NET в составе имени файла, и создает элементы, которые имеют метаданные Culture
, содержащие соответствующий идентификатор языка и региональных параметров. Например, имя файла Form1.fr-fr.resx имеет внедренный идентификатор языка и региональных параметров fr, поэтому эта задача создает элемент, имеющий то же имя файла с метаданными, равными fr-fr
метаданнымCulture
. Задача также выдает список имен файлов, из которых удалено указание языка и региональных параметров.
Параметры задачи
В следующей таблице приводятся параметры задачи AssignCulture
.
Параметр | Описание |
---|---|
AssignedFiles |
Необязательный выходной параметр ITaskItem[] .Содержит список элементов, полученных в параметре Files , с записью метаданных Culture , добавленной для каждого элемента.Если входящий элемент из параметра Files уже содержит запись метаданных Culture , используется исходная запись метаданных.Задача назначает запись метаданных Culture только в том случае, если имя файла содержит допустимый идентификатор языка и региональных параметров. Идентификатор языка и региональных параметров должен находиться между двумя последними точками в имени файла. |
AssignedFilesWithCulture |
Необязательный выходной параметр ITaskItem[] .Содержит подмножество элементов из AssignedFiles параметра, у которых есть запись метаданных Culture . |
AssignedFilesWithNoCulture |
Необязательный выходной параметр ITaskItem[] .Содержит подмножество элементов из AssignedFiles параметра, у которых нет Culture записи метаданных. |
CultureNeutralAssignedFiles |
Необязательный выходной параметр ITaskItem[] .Содержит тот же список элементов, который создается в параметре AssignedFiles , за исключением того, что из имени файла удалено упоминание языка и региональных параметров.Задача удаляет только язык и региональные параметры из имени файла, если это допустимый идентификатор языка и региональных параметров. |
Files |
Обязательный параметр ITaskItem[] .Указывает список файлов с внедренными именами языка и региональных параметров для назначения. Задача пытается выяснить, является ли каждый файл ресурсом, зависящим от языка и региональных параметров, и если да, то какой язык и региональные параметры. Чтобы пропустить этот процесс обнаружения и принудительно нейтрализовать файл и региональные параметры, задайте для записи метаданных значение WithCulture false . |
Замечания
Помимо параметров, перечисленных в этой статье, эта задача наследует параметры от TaskExtension класса, который сам наследует от Task класса. Список этих дополнительных параметров и их описания см. в статье Базовый класс TaskExtension.
Пример
Следующий пример выполняет задачу AssignCulture
с коллекцией элементов ResourceFiles
.
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<ResourceFiles Include="MyResource1.fr.resx"/>
<ResourceFiles Include="MyResource2.XX.resx"/>
</ItemGroup>
<Target Name="Culture">
<AssignCulture
Files="@(ResourceFiles)"
<Output TaskParameter="AssignedFiles"
ItemName="OutAssignedFiles"/>
<Output TaskParameter="AssignedFilesWithCulture"
ItemName="OutAssignedFilesWithCulture"/>
<Output TaskParameter="AssignedFilesWithNoCulture"
ItemName="OutAssignedFilesWithNoCulture"/>
<Output TaskParameter="CultureNeutralAssignedFiles"
ItemName="OutCultureNeutralAssignedFiles"/>
</AssignCulture>
</Target>
</Project>
Следующая таблица описывает значение выходных элементов после выполнения этой задачи. Метаданные элемента отображаются в скобках после элемента.
Коллекция элементов | Содержимое |
---|---|
OutAssignedFiles |
MyResource1.fr.resx (Culture="fr") MyResource2.XX.resx (без дополнительных метаданных) |
OutAssignedFilesWithCulture |
MyResource1.fr.resx (Culture="fr") |
OutAssignedFilesWithNoCulture |
MyResource2.XX.resx (без дополнительных метаданных) |
OutCultureNeutralAssignedFiles |
MyResource1.resx (Culture="fr") MyResource2.XX.resx (без дополнительных метаданных) |