AssignCulture タスク

  • [アーティクル]

このタスクは、有効な .NET カルチャ ID 文字列をファイル名の一部として含む可能性がある項目の一覧を受け取り、対応するカルチャ ID を含む Culture という名前のメタデータを持つ項目を生成します。 たとえば、ファイル名 Form1.fr-fr.resx には、"fr-fr" というカルチャ ID が埋め込まれています。したがって、このタスクでは、fr-fr と等しい値の Culture メタデータを持つ同じファイル名の項目が生成されます。 また、このタスクでは、ファイル名からカルチャを削除したファイル名の一覧も生成されます。

タスク パラメーター

AssignCulture タスクのパラメーターの説明を次の表に示します。

パラメーター 説明
AssignedFiles 省略可能な ITaskItem[] 型の出力パラメーターです。

Files パラメーターで受信した項目の一覧が含まれています。各項目には Culture メタデータ エントリが追加されています。

Files パラメーターから受信した項目に既に Culture メタデータ エントリが含まれている場合は、この元のメタデータ エントリが使用されます。

このタスクでは、ファイル名に有効なカルチャ ID が含まれている場合にのみ、Culture メタデータ エントリが割り当てられます。 カルチャ ID は、ファイル名の最後の 2 つのドットの間にある必要があります。
AssignedFilesWithCulture 省略可能な ITaskItem[] 型の出力パラメーターです。

AssignedFiles パラメーターの項目のうち、Culture メタデータ エントリを持つ項目のサブセットが含まれています。
AssignedFilesWithNoCulture 省略可能な ITaskItem[] 型の出力パラメーターです。

AssignedFiles パラメーターの項目のうち、Culture メタデータ エントリを持たない項目のサブセットが含まれています。
CultureNeutralAssignedFiles 省略可能な ITaskItem[] 型の出力パラメーターです。

AssignedFiles パラメーターに生成された項目の同じ一覧が含まれていますが、ファイル名からカルチャが削除されています。

このタスクでは、カルチャ ID が有効な場合にのみ、ファイル名からカルチャが削除されます。
Files 必須の ITaskItem[] 型のパラメーターです。

カルチャを割り当てるためのカルチャ名が埋め込まれたファイルの一覧を指定します。 このタスクは、各ファイルがカルチャ固有のリソースかどうか、およびその場合にどのカルチャであるかを判断しようとします。 この検出プロセスをスキップし、ファイルを強制的にカルチャに依存しないようにするには、メタデータ エントリ WithCulture を false に設定します。

解説

この記事にリストされているパラメーター以外に、このタスクは TaskExtension クラスからパラメーターを継承します。このクラス自体は Task クラスから継承されます。 これらの追加のパラメーターの一覧とその説明については、「TaskExtension Base Class」を参照してください。

例

ResourceFiles 項目コレクションを指定して AssignCulture タスクを実行する例を以下に示します。

<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 (カルチャ = "fr")

MyResource2.XX.resx (追加メタデータなし)
OutAssignedFilesWithCulture MyResource1.fr.resx (カルチャ = "fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (追加メタデータなし)
OutCultureNeutralAssignedFiles MyResource1.resx (カルチャ = "fr")

MyResource2.XX.resx (追加メタデータなし)

関連項目