AssignCulture Task

 

Date de publication : juillet 2016

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

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.

Le tableau suivant décrit les paramètres de la tâche AssignCulture.

ParamètreDescription
AssignedFilesParamè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.
AssignedFilesWithCultureParamè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.
AssignedFilesWithNoCultureParamè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.
CultureNeutralAssignedFilesParamè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.
FilesParamètre ITaskItem[] obligatoire.

Spécifie la liste des fichiers avec des noms de cultures incorporés auxquels assigner une culture.

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 TaskExtension Base Class.

L'exemple suivant exécute la tâche AssignCulture avec la collection d'éléments 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>  

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émentsSommaire
OutAssignedFilesMyResource1.fr.resx (Culture="fr")

 MyResource2.XX.resx (aucune métadonnée supplémentaire)
OutAssignedFilesWithCultureMyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCultureMyResource2.XX.resx (aucune métadonnée supplémentaire)
OutCultureNeutralAssignedFilesMyResource1.resx (Culture="fr")

 MyResource2.XX.resx ( (aucune métadonnée supplémentaire)

Tasks
Task Reference

Afficher: