AssignCulture görevi

  • Makale

Bu görev, dosya adının bir parçası olarak geçerli bir .NET kültür tanımlayıcı dizesi içerebilen öğelerin listesini kabul eder ve ilgili kültür tanımlayıcısını içeren adlı Culture meta verileri olan öğeler üretir. Örneğin, Form1.fr-fr.resx dosya adında "fr-fr" eklenmiş bir kültür tanımlayıcısı vardır, bu nedenle bu görev ile aynı dosya adına sahip ve meta verileri Culture ile eşit fr-frolan bir öğe oluşturur. Görev ayrıca, kültür dosya adından kaldırılmış dosya adlarının listesini oluşturur.

Görev parametreleri

Aşağıdaki tabloda görevin parametreleri AssignCulture açıklanmaktadır.

Parametre Tanım
AssignedFiles İsteğe bağlı ITaskItem[] çıkış parametresi.

Parametrede Files alınan öğelerin listesini içerir ve her öğeye bir Culture meta veri girişi eklenir.

Parametresinden Files gelen öğe zaten bir Culture meta veri girişi içeriyorsa, özgün meta veri girişi kullanılır.

Görev yalnızca dosya adında geçerli bir kültür tanımlayıcısı varsa bir Culture meta veri girdisi atar. Kültür tanımlayıcısı, dosya adındaki son iki nokta arasında olmalıdır.
AssignedFilesWithCulture İsteğe bağlı ITaskItem[] çıkış parametresi.

Parametresinden meta veri girişi olan Culture öğelerin AssignedFiles alt kümesini içerir.
AssignedFilesWithNoCulture İsteğe bağlı ITaskItem[] çıkış parametresi.

Parametresindeki meta veri girişi olmayan Culture öğelerin AssignedFiles alt kümesini içerir.
CultureNeutralAssignedFiles İsteğe bağlı ITaskItem[] çıkış parametresi.

Dosya adından kaldırılan kültür dışında parametresinde AssignedFiles üretilen öğelerin listesini içerir.

Görev yalnızca geçerli bir kültür tanımlayıcısıysa dosya adından kültürü kaldırır.
Files Gerekli ITaskItem[] parametresi.

Kültür atanacak eklenmiş kültür adlarına sahip dosyaların listesini belirtir. Görev, her dosyanın kültüre özgü bir kaynak olup olmadığını ve varsa hangi kültürün olduğunu anlamaya çalışır. Bu algılama işlemini atlamak ve bir dosyayı kültürden bağımsız olmaya zorlamak için meta veri girişini WithCulture olarak falseayarlayın.

Açıklamalar

Bu makalede listelenen parametrelere ek olarak, bu görev kendi sınıfından TaskExtension devralan sınıfından Task parametreleri devralır. Bu ek parametrelerin ve açıklamalarının listesi için bkz . TaskExtension temel sınıfı.

Örnek

Aşağıdaki örnek, görevi öğe koleksiyonuyla ResourceFiles yürütürAssignCulture.

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

Aşağıdaki tabloda, görev yürütmeden sonra çıkış öğelerinin değeri açıklanmaktadır. Öğe meta verileri, öğeden sonra parantez içinde gösterilir.

Öğe koleksiyonu İçindekiler
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (ek meta veri yok)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (ek meta veri yok)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (ek meta veri yok)

Ayrıca bkz.