Задача AssignCulture
Данная задача принимает список элементов, которые могут содержать строку действительного идентификатора языка и региональных параметров .NET в виде части имени файла, и позволяет получить элементы с метаданными Culture, содержащими соответствующий идентификатор языка и региональных параметров. Например, имя файла Form1.fr-fr.resx имеет встроенный идентификатор языка и региональных параметров "fr-fr", поэтому задача выдает элемент, который имеет такое же имя файла с метаданными Culture, имеющими значение fr-fr. Задача также выдает список имен файлов, в котором из имени файла удален язык и региональные параметры.
Параметры задачи
В следующей таблице описаны параметры задачи AssignCulture.
Параметр |
Описание |
|---|---|
AssignedFiles |
Необязательный выходной параметр ITaskItem[]. Содержит список элементов, полученных в параметре Files, где к каждому из них добавлена запись метаданных Culture. Если входящий элемент из параметра Files уже содержит запись метаданных Culture, то используется исходная запись метаданных. В задаче запись метаданных Culture назначается только в том случае, если имя файла содержит действительный идентификатор языка и региональных параметров. Идентификатор языка и региональных параметров должен находиться в имени файла между двумя последними точками. |
AssignedFilesWithCulture |
Необязательный выходной параметр ITaskItem[]. Содержит подмножество элементов из параметра AssignedFiles, имеющих запись метаданных Culture. |
AssignedFilesWithNoCulture |
Необязательный выходной параметр ITaskItem[]. Содержит подмножество элементов из параметра AssignedFiles, для которых отсутствует запись метаданных Culture. |
CultureNeutralAssignedFiles |
Необязательный выходной параметр ITaskItem[]. Содержит тот же список элементов, который может быть получен с помощью параметра AssignedFiles, но в нем из имени файла удален язык и региональные параметры. Эта задача удаляет язык и региональные параметры из имени файла только в том случае, если оно является действительным идентификатором языка и региональных параметров. |
Files |
Обязательный параметр ITaskItem[]. Задание списка файлов со встроенными именами языка и региональных параметров для назначения языка и региональных параметров. |
Заметки
Помимо параметров, которые перечислены выше, эта задача наследует параметры от класса TaskExtension, который наследует от класса Task. Чтобы получить список этих доп параметров и их описаний, см. Базовый класс TaskExtension.
Пример
В следующем примере выполняется задача AssignCulture с коллекцией элементов ResourceFiles.
<Project xmlns="https://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 (без дополнительных метаданных) |