AssignCulture (tâche)

  • Article

Cette tâche accepte une liste d’éléments dont le nom de fichier peut contenir une chaîne d’identificateur de culture .NET valide. De plus, cette tâche génère des éléments dont les métadonnées nommées Culture contiennent l’identificateur de culture correspondant. Par exemple, le nom de fichier Form1.fr-fr.resx comprend l’identificateur de culture incorporé « fr-fr ». Cette tâche génère donc un élément qui porte le même nom de fichier et dont les métadonnées Culture sont égales à fr-fr. La tâche génère également une liste de noms de fichiers desquels la culture a été supprimée.

Paramètres de tâche

Le tableau ci-dessous 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 par le paramètre Files, avec une entrée de métadonnées Culture ajoutée à chaque élément.

Si l’élément reçu par le 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 attribue une entrée de métadonnées Culture uniquement si le nom de fichier contient un identificateur de culture valide. L’identificateur de culture doit être placé 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 ont 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 n’ont pas d’entrée de métadonnées Culture.
CultureNeutralAssignedFiles Paramètre de sortie ITaskItem[] facultatif.

Contient la même liste d’éléments que celle qui est produite dans le paramètre AssignedFiles, mais sans la culture dans le nom de fichier.

La tâche supprime la culture du nom de fichier uniquement si l’identificateur de culture est valide.
Files Paramètre ITaskItem[] obligatoire.

Spécifie la liste des fichiers avec des noms de culture incorporés auxquels affecter une culture. La tâche tente de déterminer si chaque fichier est une ressource spécifique à la culture et, le cas échéant, quelle culture. Pour ignorer ce processus de détection et forcer un fichier à être culturellement neutre, définissez l’entrée de métadonnées WithCulture sur false .

Notes

En plus des paramètres énumérés dans ce document, cette tâche hérite des paramètres de la classe TaskExtension, qui elle-même hérite de la classe Task. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.

Exemple

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éments. Contenu
OutAssignedFiles MyResource1.fr.resx (Culture="fr")

MyResource2.XX.resx (pas de métadonnées supplémentaires)
OutAssignedFilesWithCulture MyResource1.fr.resx (Culture="fr")
OutAssignedFilesWithNoCulture MyResource2.XX.resx (pas de métadonnées supplémentaires)
OutCultureNeutralAssignedFiles MyResource1.resx (Culture="fr")

MyResource2.XX.resx (pas de métadonnées supplémentaires)

Voir aussi