Condividi tramite

Attività AssignCulture

  • Articolo

Questa attività accetta un elenco di elementi che possono contenere una stringa di identificatore delle impostazioni cultura .NET valida come parte del nome file e produce elementi con metadati denominati Culture contenenti l'identificatore delle impostazioni cultura corrispondente. Ad esempio, il nome del file Form1.fr-fr.resx ha un identificatore delle impostazioni cultura incorporato "fr-fr", quindi questa attività genera un elemento con lo stesso nome file con i metadati Culture uguale a fr-fr. L'attività genera anche un elenco di nomi file con le impostazioni cultura rimosse dal nome file.

Parametri dell'attività

Nella tabella seguente vengono descritti i parametri dell'attività AssignCulture.

Parametro Descrizione
AssignedFiles Facoltativo ITaskItem[] parametro di output.

Contiene l'elenco di elementi ricevuti nel parametro Files, con una voce di metadati Culture aggiunta a ogni elemento.

Se l'elemento in ingresso dal parametro Files contiene già una voce di metadati Culture, viene usata la voce di metadati originale.

L'attività assegna una voce di metadati Culture solo se il nome del file contiene un identificatore delle impostazioni cultura valido. L'identificatore delle impostazioni cultura deve essere compreso tra gli ultimi due punti nel nome file.
AssignedFilesWithCulture Facoltativo ITaskItem[] parametro di output.

Contiene il subset degli elementi del parametro AssignedFiles con una voce di metadati Culture.
AssignedFilesWithNoCulture Facoltativo ITaskItem[] parametro di output.

Contiene il subset degli elementi del parametro AssignedFiles che non hanno una voce di metadati Culture.
CultureNeutralAssignedFiles Facoltativo ITaskItem[] parametro di output.

Contiene lo stesso elenco di elementi prodotti nel parametro AssignedFiles, ad eccezione delle impostazioni cultura rimosse dal nome del file.

L'attività rimuove le impostazioni cultura solo dal nome del file se si tratta di un identificatore delle impostazioni cultura valido.
Files Parametro ITaskItem[] obbligatorio.

Specifica l'elenco di file con nomi di impostazioni cultura incorporati a cui assegnare impostazioni cultura. L'attività tenta di determinare se ogni file è una risorsa specifica delle impostazioni cultura e, in tal caso, quali impostazioni cultura. Per ignorare questo processo di rilevamento e forzare la neutralità delle impostazioni cultura di un file, impostare la voce di metadati WithCulture su false.
RespectAlreadyAssignedItemCulture Parametro bool facoltativo.

Se impostato su true: i metadati delle impostazioni cultura già impostati nel parametro dell'elemento Files vengono rispettati e il CultureNeutralAssignedFiles verrà popolato con un nome file invariato da Files.

Osservazioni

Oltre ai parametri elencati in questo articolo, questa attività eredita i parametri dalla classe TaskExtension, che eredita dalla classe Task. Per un elenco di questi parametri aggiuntivi e delle relative descrizioni, vedere classe di base TaskExtension.

Esempio

Nell'esempio seguente viene eseguita l'attività AssignCulture con la raccolta di elementi 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>

Nella tabella seguente viene descritto il valore degli elementi di output dopo l'esecuzione dell'attività. I metadati degli elementi vengono visualizzati tra parentesi dopo l'elemento.

Raccolta di elementi Contenuto
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (senza metadati aggiuntivi)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (senza metadati aggiuntivi)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (senza metadati aggiuntivi)

Vedere anche