次の方法で共有

AssignCulture タスク

  • [アーティクル]

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

タスク パラメーター

次の表では、AssignCulture タスクのパラメーターについて説明します。

パラメーター 形容
AssignedFiles 省略可能な ITaskItem[] 出力パラメーター。

Files パラメーターで受信した項目の一覧を格納し、各項目に Culture メタデータ エントリを追加します。

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

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

Culture メタデータ エントリを持つ AssignedFiles パラメーターの項目のサブセットを格納します。
AssignedFilesWithNoCulture 省略可能な ITaskItem[] 出力パラメーター。

Culture メタデータ エントリを持たない AssignedFiles パラメーターの項目のサブセットを格納します。
CultureNeutralAssignedFiles 省略可能な ITaskItem[] 出力パラメーター。

ファイル名からカルチャを削除した場合を除き、AssignedFiles パラメーターで生成される項目の同じリストが含まれます。

このタスクは、有効なカルチャ識別子である場合にのみ、ファイル名からカルチャを削除します。
Files 必須 ITaskItem[] パラメーターです。

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

true に設定すると、Files 項目パラメーターに既に設定されている Culture メタデータが尊重され、CultureNeutralAssignedFiles には Filesから変更されていないファイル名が設定されます。

備考

このタスクは、この記事に記載されているパラメーターに加えて、TaskExtension クラスからパラメーターを継承し、それ自体が Task クラスから継承します。 これらの追加パラメーターとその説明の一覧については、「TaskExtension 基底クラスのを参照してください。

例

次の例では、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 (Culture="fr")

MyResource2.XX.resx (追加のメタデータなし)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (追加のメタデータなし)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

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

関連項目