次の方法で共有

AssignCulture タスク

  • [アーティクル]

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

タスク パラメーター

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

パラメーター

Description

AssignedFiles

省略可能な ITaskItem[] 型の出力パラメーター。

Files パラメーターで受け取ったアイテムの一覧が格納されています。各アイテムには Culture メタデータ エントリが追加されています。

Files パラメーターで受け取ったアイテムに、既に Culture メタデータ エントリが格納されている場合には、この元のメタデータ エントリが使用されます。

このタスクでは、ファイル名に有効なカルチャ ID が含まれている場合にだけ、Culture メタデータ エントリが割り当てられます。カルチャ ID は、ファイル名で、最後の 2 つのドットの間に埋め込まれている必要があります。

AssignedFilesWithCulture

省略可能な ITaskItem[] 型の出力パラメーター。

AssignedFiles パラメーターに含まれるアイテムのうち、Culture メタデータ エントリを持つアイテムのサブセットを格納してあります。

AssignedFilesWithNoCulture

省略可能な ITaskItem[] 型の出力パラメーター。

AssignedFiles パラメーターに含まれるアイテムのうち、Culture メタデータ エントリを持たないアイテムのサブセットが含まれています。

CultureNeutralAssignedFiles

省略可能な ITaskItem[] 型の出力パラメーター。

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

この処理では、カルチャ ID が有効な場合にだけ、ファイル名からカルチャが削除されます。

Files

必須の ITaskItem[] 型のパラメーターです。

カルチャを割り当てるためのカルチャ名が埋め込まれたファイルの一覧を指定します。

解説

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

使用例

ResourceFiles アイテム コレクションを指定して AssignCulture タスクを実行する例を次に示します。

<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 (メタデータの追加なし)

参照

概念

MSBuild タスク

その他の技術情報

MSBuild タスク リファレンス