Sdílet prostřednictvím

AssignCulture – úloha

  • Článek

Tento úkol přijímá seznam položek, které mohou obsahovat platný řetězec identifikátoru jazykové verze .NET jako součást názvu souboru, a vytvoří položky s metadaty s názvem Culture obsahující odpovídající identifikátor jazykové verze. Například název souboru Form1.fr-fr.resx má vložený identifikátor jazykové verzefr-fr, takže tato úloha vytvoří položku, která má stejný název souboru s metadaty Culture rovna fr-fr. Úloha také vytvoří seznam názvů souborů s jazykovou verzí odebranou z názvu souboru.

Parametry úkolu

Následující tabulka popisuje parametry AssignCulture úlohy.

Parametr Popis
AssignedFiles Volitelný ITaskItem[] výstupní parametr.

Obsahuje seznam položek přijatých v parametru Files s položkou Culture metadat přidanou do každé položky.

Pokud příchozí položka z parametru Files již obsahuje položku metadat Culture, použije se původní položka metadat.

Úloha přiřadí položku metadat Culture pouze v případě, že název souboru obsahuje platný identifikátor jazykové verze. Identifikátor jazykové verze musí být mezi posledními dvěma tečkami v názvu souboru.
AssignedFilesWithCulture Volitelný ITaskItem[] výstupní parametr.

Obsahuje podmnožinu položek z parametru AssignedFiles, který má položku metadat Culture.
AssignedFilesWithNoCulture Volitelný ITaskItem[] výstupní parametr.

Obsahuje podmnožinu položek z parametru AssignedFiles, který neobsahuje položku metadat Culture.
CultureNeutralAssignedFiles Volitelný ITaskItem[] výstupní parametr.

Obsahuje stejný seznam položek vytvořených v parametru AssignedFiles s výjimkou jazykové verze odebrané z názvu souboru.

Úloha odebere jazykovou verzi pouze z názvu souboru, pokud se jedná o platný identifikátor jazykové verze.
Files Povinný ITaskItem[] parametr.

Určuje seznam souborů s vloženými názvy jazykových verzí pro přiřazení jazykové verze. Úkol se pokusí zjistit, jestli je každý soubor zdrojem specifický pro jazykovou verzi, a pokud ano, jakou jazykovou verzi. Pokud chcete tento proces detekce přeskočit a vynutit, aby byl soubor neutrální pro jazykovou verzi, nastavte položku metadat WithCulture na false.
RespectAlreadyAssignedItemCulture Volitelný parametr bool.

Pokud je nastavená na true – už nastavená metadata jazykové verze u parametru položky Files se respektují a CultureNeutralAssignedFiles se vyplní beze změny názvu souboru z Files.

Poznámky

Kromě parametrů uvedených v tomto článku tato úloha dědí parametry z třídy TaskExtension, která sama dědí z třídy Task. Seznam těchto dalších parametrů a jejich popisů naleznete v tématu TaskExtension základní třídy.

Příklad

Následující příklad spustí úlohu AssignCulture s kolekcí položek ResourceFiles.

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

Následující tabulka popisuje hodnotu výstupních položek po spuštění úkolu. Metadata položek se zobrazují v závorkách za položkou.

Kolekce položek Obsah
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (žádná další metadata)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (žádná další metadata)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (žádná další metadata)

Viz také