Partager via


ResolveComReference, tâche

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ètre

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.

EnvironmentVariables

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

ExecuteAsTool

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

IncludeVersionInInteropName

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

KeyContainer

Paramètre String facultatif.

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

.

KeyFile

Paramètre String facultatif.

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

.

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[] optionnel.

SdkToolsPath

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

StateFile

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

TargetFrameworkVersion

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

TargetProcessorArchitecture

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

TypeLibFiles

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

TypeLibNames

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

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 de 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 contrôle 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 contrôle 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.

Notes

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 Classe de base de tâche.

Voir aussi

Concepts

Tâches MSBuild

Autres ressources

Référence des tâches MSBuild