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[] .

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

Замечания

Помимо параметров, перечисленных в этой статье, эта задача наследует параметры от 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 (без дополнительных метаданных)

См. также