Attività AssignCulture

Aggiornamento: novembre 2007

Questa attività accetta un elenco di elementi che possono contenere una stringa di identificazione della lingua .NET valida come parte del nome di file e genera elementi con un metadato denominato Culture contenente l'identificatore della lingua corrispondente. Ad esempio, poiché il nome di file Form1.fr-fr.resx contiene l'identificatore della lingua incorporato "fr-fr", verrà generato un elemento con lo stesso nome di file in cui il valore del metadato Culture sarà fr-fr. L'attività genera inoltre un elenco di nomi di file dai quali l'identificatore della lingua è stato rimosso.

Parametri dell'attività

Nella tabella riportata di seguito sono descritti i parametri dell'attività AssignCulture.

Parametro	Descrizione
AssignedFiles	Parametro di output ITaskItem[] facoltativo. Contiene l'elenco di elementi ricevuti nel parametro Files. A ciascun elemento è stato aggiunto un metadato Culture. Se l'elemento proveniente dal parametro Files contiene già un metadato Culture, viene utilizzato il metadato originale. L'attività assegna un metadato Culture soltanto se il nome di file contiene un identificatore della lingua valido. L'identificatore della lingua deve essere compreso tra gli ultimi due punti del nome di file.
AssignedFilesWithCulture	Parametro di output ITaskItem[] facoltativo. Contiene il sottoinsieme degli elementi del parametro AssignedFiles che presentano un metadato Culture.
AssignedFilesWithNoCulture	Parametro di output ITaskItem[] facoltativo. Contiene il sottoinsieme degli elementi del parametro AssignedFiles che non presentano un metadato Culture.
CultureNeutralAssignedFiles	Parametro di output ITaskItem[] facoltativo. Contiene lo stesso elenco di elementi generato nel parametro AssignedFiles, con la differenza che l'identificatore della lingua è stato rimosso dal nome di file. La lingua viene rimossa dal nome di file soltanto se si tratta di un identificatore della lingua valido.
Files	Parametro ITaskItem[] facoltativo. Specifica l'elenco di file con i nomi di lingua incorporati a cui assegnare una lingua.

Esempio

Nell'esempio riportato di seguito l'attività AssignCulture viene eseguita con l'insieme di elementi ResourceFiles.

<Project xmlns="https://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 riportata di seguito viene descritto il valore degli elementi di output dopo l'esecuzione dell'attività. I metadati degli elementi sono visualizzati tra parentesi dopo l'elemento.

Insieme di elementi	Contenuto
OutAssignedFiles	MyResource1.fr.resx (Culture="fr") MyResource2.XX.resx (nessun metadato aggiuntivo)
OutAssignedFilesWithCulture	MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture	MyResource2.XX.resx (nessun metadato aggiuntivo)
OutCultureNeutralAssignedFiles	MyResource1.resx (Culture="fr") MyResource2.XX.resx (nessun metadato aggiuntivo)

Vedere anche

Concetti

Attività di MSBuild

Altre risorse

Riferimenti delle attività MSBuild