ResolveComReference Task

 

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

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.

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

ParamètreDescription
DelaySignParamè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.
EnvironmentVariablesParamètre String[] facultatif.

Tableau de paires de variables d'environnement, séparées par un signe égal. Ces variables sont passées aux fichiers tlbimp.exe et aximp.exe générés en plus du bloc environnement normal ou en remplacement de celui-ci.
ExecuteAsToolParamètre Boolean facultatif.

Si la valeur est true, exécute tlbimp.exe et aximp.exe à partir de la version cible du .NET Framework appropriée hors processus pour générer les assemblys de wrappers nécessaires. Ce paramètre permet le multi-ciblage.
IncludeVersionInInteropNameParamètre Boolean facultatif.

Si la valeur est true, la version de la typelib sera incluse dans le nom du wrapper. La valeur par défaut est false.
KeyContainerParamètre String facultatif.

Spécifie un conteneur qui détient une paire de clés publique/privée

.
KeyFileParamètre String facultatif.

Spécifie un élément qui contient une paire de clés publique/privée

.
NoClassMembersParamètre Boolean facultatif.
ResolvedAssemblyReferencesParamètre de sortie ITaskItem[] facultatif.

Spécifie les références d'assembly résolues.
ResolvedFilesParamè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.
ResolvedModulesParamètre ITaskItem[] optionnel.
SdkToolsPathParamètre String facultatif.

Si ExecuteAsTool a la valeur true, ce paramètre doit être défini sur le chemin d'accès des outils du Kit de développement logiciel pour la version de .NET Framework ciblée.
StateFileParamètre String facultatif.

Spécifie le fichier cache pour les horodatages de composant COM. En cas d'absence, chaque exécution régénère l'ensemble des wrappers.
TargetFrameworkVersionParamètre String facultatif.

Spécifie la version cible de .Net Framework pour un projet.

La valeur par défaut est String.Empty. ce qui signifie qu'il n'y a pas de filtrage de référence basé sur la version cible de .NET Framework.
TargetProcessorArchitectureParamètre String facultatif.

Spécifie l'architecture de processeur cible par défaut. Passé à l'indicateur de tlbimp.exe / de l'ordinateur après la translation.

La valeur du paramètre doit faire partie de ProcessorArchitecture.
TypeLibFilesParamètre ITaskItem[] optionnel.

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.
TypeLibNamesParamètre ITaskItem[] optionnel.

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.
WrapperOutputDirectoryParamè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.

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éesDescription
GUIDMétadonnées d'élément requises.

GUID de la bibliothèque de types. Si ces métadonnées d'élément ne sont pas spécifiées, la tâche échoue.
VersionMajorMé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.
VersionMinorMé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.
LocaleIdentifierMé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.
WrapperToolMé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 contrôle ActiveX.

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éesDescription
WrapperToolMé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 contrôle ActiveX.
System_CAPS_ICON_note.jpg 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.

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe Task. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez Task Base Class.

Tasks
Task Reference

Afficher: