Partager via


ResolveComReference, tâche

Mise à jour : novembre 2007

Utilise une liste d'un ou plusieurs noms de bibliothèques de types ou de fichiers .tlb et résout ces bibliothèques de types aux emplacements sur le disque.

Paramètres

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

Paramètres

Description

DelaySign

Paramètre Boolean facultatif.

Si la valeur est true, place la clé publique dans l'assembly. Si la valeur est false, signe complètement l'assembly.

KeyContainer

Paramètre String facultatif.

Spécifie un conteneur qui contient une paire de clés.

KeyFile

Paramètre String facultatif.

Spécifie un élément qui contient une paire de clés.

NoClassMembers

Paramètre Boolean facultatif.

ResolvedAssemblyReferences

Paramètre de sortie ITaskItem[] facultatif.

Spécifie les références d'assembly résolues.

ResolvedFiles

Paramètre de sortie ITaskItem[] facultatif.

Spécifie les fichiers qualifiés complets sur le disque qui correspondent aux emplacements physiques des bibliothèques de types fournies comme entrée pour cette tâche.

ResolvedModules

Paramètre ITaskItem[] facultatif.

TypeLibFiles

Paramètre ITaskItem[] facultatif.

Spécifie le chemin d'accès des bibliothèques de types aux références COM. Les éléments inclus dans ce paramètre peuvent contenir des métadonnées d'élément. Pour plus d'informations, consultez la section « Métadonnées d'élément TypeLibFiles » ci-dessous.

TypeLibNames

Paramètre ITaskItem[] facultatif.

Spécifie les noms de bibliothèques de types à résoudre. Les éléments inclus dans ce paramètre doivent contenir des métadonnées d'élément. Pour plus d'informations, consultez la section « Métadonnées d'élément TypeLibNames » ci-dessous.

WrapperOutputDirectory

Paramètre String facultatif.

Emplacement de l'assembly d'interopérabilité généré sur le disque. Si ces métadonnées d'élément ne sont pas spécifiées, la tâche utilise le chemin d'accès absolu du répertoire contenant le fichier projet.

Notes

Métadonnées d'élément TypeLibNames

Le tableau suivant décrit les métadonnées d'élément disponibles pour les éléments passés au paramètre TypeLibNames.

Métadonnées

Description

GUID

Métadonnées d'élément requises.

GUID pour la bibliothèque de types. Si ces métadonnées d'élément ne sont pas spécifiées, la tâche échoue.

VersionMajor

Métadonnées d'élément requises.

Version principale de la bibliothèque de types. Si ces métadonnées d'élément ne sont pas spécifiées, la tâche échoue.

VersionMinor

Métadonnées d'élément requises.

Version secondaire de la bibliothèque de types. Si ces métadonnées d'élément ne sont pas spécifiées, la tâche échoue.

LocaleIdentifier

Métadonnées d'élément facultatives.

Identificateur de paramètres régionaux (ou LCID) de la bibliothèque de types. Il s'agit d'une valeur 32 bits qui identifie le langage humain préféré pour un utilisateur, une région ou une application. Si ces métadonnées d'élément ne sont pas spécifiées, la tâche utilise la valeur par défaut "0" comme identificateur de paramètres régionaux.

WrapperTool

Métadonnées d'élément facultatives.

Spécifie l'outil wrapper utilisé afin de générer le wrapper d'assembly pour cette bibliothèque de types. Si ces métadonnées d'élément ne sont pas spécifiées, la tâche utilise l'outil wrapper par défaut "tlbimp". Les choix disponibles qui ne respectent pas la casse pour les typelibs sont les suivants :

  • Primary : Utilisez cet outil wrapper lorsque vous souhaitez employer un assembly PIA (Primary Interop Assembly) déjà généré pour le composant COM. Lorsque vous utilisez cet outil wrapper, ne spécifiez pas de répertoire de sortie de wrapper car cela provoquerait l'échec de la tâche.

  • TLBImp : Utilisez cet outil wrapper lorsque vous souhaitez générer un assembly d'interopérabilité pour le composant COM.

  • AXImp : Utilisez cet outil wrapper lorsque vous souhaitez générer un assembly d'interopérabilité pour un composant ActiveX.

Métadonnées d'élément TypeLibFiles

Le tableau suivant décrit les métadonnées d'élément disponibles pour les éléments passés au paramètre TypeLibFiles.

Métadonnées

Description

WrapperTool

Métadonnées d'élément facultatives.

Spécifie l'outil wrapper utilisé afin de générer le wrapper d'assembly pour cette bibliothèque de types. Si ces métadonnées d'élément ne sont pas spécifiées, la tâche utilise l'outil wrapper par défaut "tlbimp". Les choix disponibles qui ne respectent pas la casse pour les typelibs sont les suivants :

  • Primary : Utilisez cet outil wrapper lorsque vous souhaitez employer un assembly PIA (Primary Interop Assembly) déjà généré pour le composant COM. Lorsque vous utilisez cet outil wrapper, ne spécifiez pas de répertoire de sortie de wrapper car cela provoquerait l'échec de la tâche.

  • TLBImp : Utilisez cet outil wrapper lorsque vous souhaitez générer un assembly d'interopérabilité pour le composant COM.

  • AXImp : Utilisez cet outil wrapper lorsque vous souhaitez générer un assembly d'interopérabilité pour un composant ActiveX.

Remarque :

Plus vous donnez d'informations précises sur une bibliothèque de types, plus la tâche sera en mesure de résoudre le fichier correct sur le disque.

Voir aussi

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild