Dela via

AssignCulture-uppgift

  • Artikel

Den här uppgiften accepterar en lista över objekt som kan innehålla en giltig .NET-kulturidentifierarsträng som en del av filnamnet och skapar objekt som har en metadata med namnet Culture som innehåller motsvarande kulturidentifierare. Till exempel filnamnet Form1.fr-fr.resx har en inbäddad kulturidentifierare "fr-fr", så den här uppgiften genererar ett objekt som har samma filnamn med metadata Culture lika med fr-fr. Uppgiften skapar också en lista över filnamn med kulturen borttagen från filnamnet.

Aktivitetsparametrar

I följande tabell beskrivs parametrarna för den AssignCulture aktiviteten.

Parameter Beskrivning
AssignedFiles Valfri ITaskItem[] utdataparameter.

Innehåller listan över objekt som tas emot i parametern Files, med en Culture metadatapost som läggs till i varje objekt.

Om det inkommande objektet från parametern Files redan innehåller en Culture metadatapost används den ursprungliga metadataposten.

Uppgiften tilldelar endast en Culture metadatapost om filnamnet innehåller en giltig kulturidentifierare. Kulturidentifieraren måste vara mellan de två sista punkterna i filnamnet.
AssignedFilesWithCulture Valfri ITaskItem[] utdataparameter.

Innehåller delmängden av objekten från parametern AssignedFiles som har en Culture metadatapost.
AssignedFilesWithNoCulture Valfri ITaskItem[] utdataparameter.

Innehåller delmängden av objekten från parametern AssignedFiles som inte har en Culture metadatapost.
CultureNeutralAssignedFiles Valfri ITaskItem[] utdataparameter.

Innehåller samma lista över objekt som skapas i parametern AssignedFiles, förutom när kulturen har tagits bort från filnamnet.

Aktiviteten tar bara bort kulturen från filnamnet om det är en giltig kulturidentifierare.
Files Obligatorisk ITaskItem[] parameter.

Anger listan över filer med inbäddade kulturnamn att tilldela en kultur till. Uppgiften försöker ta reda på om varje fil är en kulturspecifik resurs, och i så fall vilken kultur. Om du vill hoppa över den här identifieringsprocessen och tvinga en fil att vara kulturneutral anger du metadataposten WithCulture till false.
RespectAlreadyAssignedItemCulture Valfri bool parameter.

Om värdet är inställt på true respekteras den redan angivna kulturmetadata på Files objektparametern och CultureNeutralAssignedFiles fylls i med ett oförändrat filnamn från Files.

Anmärkningar

Förutom de parametrar som anges i den här artikeln ärver den här aktiviteten parametrar från klassen TaskExtension, som i sig ärver från klassen Task. En lista över dessa ytterligare parametrar och deras beskrivningar finns i TaskExtension-basklassen.

Exempel

I följande exempel körs AssignCulture uppgift med ResourceFiles objektsamlingen.

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

I följande tabell beskrivs värdet för utdataobjekten efter aktivitetskörningen. Objektmetadata visas inom parenteser efter objektet.

Objektsamling Innehåll
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (inga ytterligare metadata)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (inga ytterligare metadata)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (inga ytterligare metadata)

Se även