Condividi tramite

AssignCulture (attività)

  • Articolo

Questa attività accetta un elenco di elementi che possono contenere una stringa dell'identificatore di impostazioni cultura .NET valida come parte del nome file e genera elementi con metadati denominati Culture che contengono l'identificatore di impostazioni cultura corrispondente. Ad esempio, il nome 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 uguali a fr-fr. L'attività genera inoltre un elenco di nomi di file con le impostazioni cultura rimosse dal nome del file.

Parametri dell'attività

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

Parametro Descrizione
AssignedFiles Parametro di output ITaskItem[] facoltativo.

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

Se l'elemento proveniente 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 di impostazioni cultura valido. L'identificatore di impostazioni cultura deve essere compreso tra gli ultimi due punti nel nome file.
AssignedFilesWithCulture Parametro di output ITaskItem[] facoltativo.

Contiene il subset degli elementi del parametro AssignedFiles che hanno una voce di metadati Culture.
AssignedFilesWithNoCulture Parametro di output ITaskItem[] facoltativo.

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

Contiene lo stesso elenco di elementi generato nel parametro AssignedFiles, eccetto le 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 le 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 WithCulture di metadati su false.

Osservazioni:

Oltre ai parametri elencati in questo articolo, questa attività eredita i parametri dalla TaskExtension classe , che a sua volta eredita dalla Task classe . Per un elenco di questi parametri aggiuntivi e le rispettive descrizioni, vedere TaskExtension Base Class.

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>

La tabella seguente descrive 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 (Impostazioni cultura="fr")

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

MyResource2.XX.resx (senza metadati aggiuntivi)

Vedi anche