Bagikan melalui

Tugas AssignCulture

  • Artikel

Tugas ini menerima daftar item yang mungkin berisi string pengidentifikasi budaya .NET yang valid sebagai bagian dari nama file, dan menghasilkan item yang memiliki metadata bernama Culture yang berisi pengidentifikasi budaya yang sesuai. Misalnya, nama file Form1.fr-fr.resx memiliki pengidentifikasi budaya tersemat "fr-fr," sehingga tugas ini menghasilkan item yang memiliki nama file yang sama dengan metadata Culture yang sama fr-frdengan . Tugas ini juga menghasilkan daftar nama file dengan budaya yang dihapus dari nama file.

Parameter tugas

Tabel berikut ini menjelaskan parameter tugas AssignCulture.

Parameter Deskripsi
AssignedFiles Parameter output ITaskItem[] opsional.

Berisi daftar item yang diterima dalam Files parameter, dengan Culture entri metadata ditambahkan ke setiap item.

Jika item masuk dari Files parameter sudah berisi Culture entri metadata, entri metadata asli akan digunakan.

Tugas hanya menetapkan Culture entri metadata jika nama file berisi pengidentifikasi budaya yang valid. Pengidentifikasi budaya harus berada di antara dua titik terakhir dalam nama file.
AssignedFilesWithCulture Parameter output ITaskItem[] opsional.

Berisi subset item dari AssignedFiles parameter yang memiliki Culture entri metadata.
AssignedFilesWithNoCulture Parameter output ITaskItem[] opsional.

Berisi subset item dari AssignedFiles parameter yang tidak memiliki Culture entri metadata.
CultureNeutralAssignedFiles Parameter output ITaskItem[] opsional.

Berisi daftar item yang sama yang diproduksi dalam AssignedFiles parameter, kecuali dengan budaya yang dihapus dari nama file.

Tugas ini hanya menghapus budaya dari nama file jika itu adalah pengidentifikasi budaya yang valid.
Files Parameter ITaskItem[] wajib.

Menentukan daftar file dengan nama budaya yang disematkan untuk menetapkan budaya. Tugas ini mencoba mencari tahu apakah setiap file adalah sumber daya khusus budaya, dan jika demikian, budaya apa. Untuk melewati proses deteksi ini dan memaksa file menjadi netral budaya, atur entri WithCulture metadata ke false.

Keterangan

Selain parameter yang tercantum dalam artikel ini, tugas ini mewarisi parameter dari TaskExtension kelas , yang diwarisi sendiri dari Task kelas . Untuk daftar parameter tambahan ini dan deskripsinya, lihat kelas dasar TaskExtension.

Contoh

Contoh berikut menjalankan AssignCulture tugas dengan ResourceFiles koleksi item.

<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>

Tabel berikut menjelaskan nilai item output setelah eksekusi tugas. Metadata item ditampilkan dalam tanda kurung setelah item.

Koleksi item Konten
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (tanpa metadata tambahan)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (tanpa metadata tambahan)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (tanpa metadata tambahan)

Lihat juga