AssignCulture, tâche
Cette tâche accepte une liste d'éléments qui peuvent contenir une chaîne d'identificateur de culture .NET valide dans leur nom de fichier et génère des éléments possédant une entrée de métadonnées appelée Culture qui contient l'identificateur de culture correspondant. Par exemple, le nom de fichier Form1.fr-fr.resx possède un identificateur de culture incorporé, « fr-fr ». Cette tâche crée dès lors un élément portant le même nom de fichier avec l'entrée de métadonnées Culture correspondant à fr-fr. La tâche génère également une liste de noms de fichiers dont la culture a été supprimée du nom.
Paramètres de la tâche
Le tableau suivant décrit les paramètres de la tâche AssignCulture.
Paramètre |
Description |
|---|---|
AssignedFiles |
Paramètre de sortie ITaskItem[] facultatif. Contient la liste des éléments reçus dans le paramètre Files, avec une entrée de métadonnées Culture ajoutée à chaque élément. Si l'élément entrant du paramètre Files contient déjà une entrée de métadonnées Culture, l'entrée de métadonnées d'origine est utilisée. La tâche assigne uniquement une entrée de métadonnées Culture si le nom de fichier contient un identificateur de culture valide. L'identificateur de culture doit être spécifié entre les deux derniers points du nom de fichier. |
AssignedFilesWithCulture |
Paramètre de sortie ITaskItem[] facultatif. Contient le sous-ensemble d'éléments du paramètre AssignedFiles qui possèdent une entrée de métadonnées Culture. |
AssignedFilesWithNoCulture |
Paramètre de sortie ITaskItem[] facultatif. Contient le sous-ensemble d'éléments du paramètre AssignedFiles qui ne possèdent pas d'entrée de métadonnées Culture. |
CultureNeutralAssignedFiles |
Paramètre de sortie ITaskItem[] facultatif. Contient la même liste d'éléments créés dans le paramètre AssignedFiles, mais dont la culture a été supprimée du nom de fichier. La tâche supprime uniquement la culture du nom de fichier s'il s'agit d'un identificateur de culture valide. |
Files |
Paramètre ITaskItem[] obligatoire. Spécifie la liste des fichiers avec des noms de cultures incorporés auxquels assigner une culture. |
Notes
En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension, qui hérite elle-même de la classe Task. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez Classe TaskExtension Base.
Exemple
L'exemple suivant exécute la tâche AssignCulture avec la collection d'éléments 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>
Le tableau suivant décrit la valeur des éléments de sortie après l'exécution de la tâche. Les métadonnées de l'élément sont affichées entre parenthèses après l'élément.
Collection d'éléments |
Sommaire |
|---|---|
OutAssignedFiles |
MyResource1.fr.resx (Culture="fr") MyResource2.XX.resx (aucune métadonnée supplémentaire) |
OutAssignedFilesWithCulture |
MyResource1.fr.resx (Culture="fr") |
OutAssignedFilesWithNoCulture |
MyResource2.XX.resx (aucune métadonnée supplémentaire) |
OutCultureNeutralAssignedFiles |
MyResource1.resx (Culture="fr") MyResource2.XX.resx ( (aucune métadonnée supplémentaire) |