Attività AssignCulture
Questa attività accetta un elenco di elementi che possono contenere una stringa di identificazione delle impostazioni cultura .NET valida come parte del nome di file e genera elementi con un metadato denominato Culture contenente l'identificatore delle impostazioni cultura corrispondente.Ad esempio, poiché il nome di file Form1.fr-fr.resx contiene l'identificatore delle impostazioni cultura 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 delle impostazioni cultura è 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 una voce di metadati Culture solo se il nome file contiene un identificatore delle impostazioni cultura valido.L'identificatore delle impostazioni cultura 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 delle impostazioni cultura è stato rimosso dal nome di file. Le impostazioni cultura vengono rimosse dal nome di file soltanto se si tratta di un identificatore delle impostazioni cultura valido. |
Files |
Parametro ITaskItem[] obbligatorio. Specifica l'elenco di file con i nomi di impostazioni cultura incorporati a cui assegnare determinate impostazioni cultura. |
Note
Oltre ai parametri sopra elencati, questa attività eredita i parametri dalla classe TaskExtension, che eredita dalla classe Task.Per un elenco di tali parametri aggiuntivi e le relative descrizioni, vedere Classe di base TaskExtension.
Esempio
Nell'esempio riportato di seguito l'attività AssignCulture viene eseguita con la raccolta 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 vengono visualizzati tra parentesi dopo l'elemento.
Raccolta 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) |