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ím odpovídající identifikátor jazykové verze. Například název souboru Form1.fr-fr.resx má vložený identifikátor jazykové verze "fr-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 metadat přidanou Culture do každé položky.

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

Úloha přiřadí Culture položku metadat 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á Culture položku metadat.
AssignedFilesWithNoCulture Volitelný ITaskItem[] výstupní parametr.

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

Obsahuje stejný seznam položek, které jsou vytvořeny 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 Požadovaný parametr ITaskItem[].

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. Chcete-li tento proces detekce přeskočit a vynutit, aby soubor byl jazykově neutrální, nastavte položku WithCulture metadat na false.

Poznámky

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

Příklad

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

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