ResolveComReference, tâcheResolveComReference Task

Prend 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.Takes a list of one or more type library names or .tlb files and resolves those type libraries to locations on disk.

ParamètresParameters

Le tableau ci-dessous décrit les paramètres de la tâche ResolveCOMReference .The following table describes the parameters of the ResolveCOMReference task.

ParamètreParameter DescriptionDescription
DelaySign Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, place la clé publique dans l’assembly.If true, places the public key in the assembly. Si la valeur est false, signe complètement l’assembly.If false, fully signs the assembly.
EnvironmentVariables Paramètre String[] facultatif.Optional String[] parameter.

Tableau de paires de variables d'environnement, séparées par un signe égal.Array of pairs of environment variables, separated by equal signs. Ces variables sont passées aux fichiers tlbimp.exe et aximp.exe générés en plus ou en remplacement sélectif du bloc d’environnement normal.These variables are passed to the spawned tlbimp.exe and aximp.exe in addition to, or selectively overriding, the regular environment block..
ExecuteAsTool Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, exécute tlbimp.exe et aximp.exe à partir du framework cible approprié out-of-process pour générer les assemblys de wrappers nécessaires.If true, runs tlbimp.exe and aximp.exe from the appropriate target framework out-of-proc to generate the necessary wrapper assemblies. Ce paramètre permet le multiciblage.This parameter enables multi-targeting.
IncludeVersionInInteropName Paramètre Boolean facultatif.Optional Boolean parameter.

Si la valeur est true, la version de la typelib sera incluse dans le nom du wrapper.If true, the typelib version will be included in the wrapper name. La valeur par défaut est false.The default is false.
KeyContainer Paramètre String facultatif.Optional String parameter.

Spécifie un conteneur qui contient une paire de clésSpecifies a container that holds a public/private

publique/privée.key pair.
KeyFile Paramètre String facultatif.Optional String parameter.

Spécifie un élément qui contient une paire de clésSpecifies an item that contains a public/private

publique/privée.key pair.
NoClassMembers Paramètre Boolean facultatif.Optional Booleanparameter.
ResolvedAssemblyReferences Paramètre de sortie ITaskItem[] facultatif.Optional ITaskItem[] output parameter.

Spécifie les références d’assembly résolues.Specifies the resolved assembly references.
ResolvedFiles Paramètre de sortie ITaskItem[] facultatif.Optional ITaskItem[] output parameter.

Spécifie les fichiers avec leur nom complet sur le disque qui correspondent aux emplacements physiques des bibliothèques de types fournies comme entrée pour cette tâche.Specifies the fully qualified files on disk that correspond to the physical locations of the type libraries that were provided as input to this task.
ResolvedModules Paramètre ITaskItem[] facultatif.Optional ITaskItem[]parameter.
SdkToolsPath Paramètre System.String facultatif.Optional System.String parameter.

Si ExecuteAsTool a la valeur true, ce paramètre doit être défini sur le chemin des outils du SDK de la version du framework ciblée.If ExecuteAsTool is true, this parameter must be set to the SDK tools path for the framework version being targeted.
StateFile Paramètre String facultatif.Optional String parameter.

Spécifie le fichier cache pour les horodateurs de composant COM.Specifies the cache file for COM component timestamps. S’il n’est pas présent, chaque exécution régénère tous les wrappers.If not present, every run will regenerate all the wrappers.
TargetFrameworkVersion Paramètre String facultatif.Optional String parameter.

Spécifie la version du framework cible du projet.Specifies the project target framework version.

La valeur par défaut est String.Empty,The default is String.Empty. ce qui signifie qu’il n’existe pas de filtrage pour une référence basée sur le framework cible.which means there is no filtering for a reference based on the target framework.
TargetProcessorArchitecture Paramètre String facultatif.Optional String parameter.

Spécifie l’architecture de processeur cible préférée.Specifies the preferred target processor architecture. Passé à l’indicateur /machine de tlbimp.exe après traduction.Passed to the tlbimp.exe /machine flag after translation.

La valeur du paramètre doit être un membre de ProcessorArchitecture.The parameter value should be a member of ProcessorArchitecture.
TypeLibFiles Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Spécifie le chemin du fichier de bibliothèque de types vers les références COM.Specifies the type library file path to COM references. Les éléments inclus dans ce paramètre peuvent contenir des métadonnées d’élément.Items included in this parameter may contain item metadata. Pour plus d’informations, consultez la section « Métadonnées d’élément TypeLibFiles » ci-dessous.For more information, see the section "TypeLibFiles Item Metadata" below.
TypeLibNames Paramètre ITaskItem[] facultatif.Optional ITaskItem[] parameter.

Spécifie les noms de bibliothèques de types à résoudre.Specifies the type library names to resolve. Les éléments inclus dans ce paramètre doivent contenir certaines métadonnées d’élément.Items included in this parameter must contain some item metadata. Pour plus d’informations, consultez la section « Métadonnées d’élément TypeLibNames » ci-dessous.For more information, see the section "TypeLibNames Item Metadata" below.
WrapperOutputDirectory Paramètre String facultatif.Optional String parameter.

Emplacement sur le disque où se trouve l’assembly d’interopérabilité généré.The location on disk where the generated interop assembly is placed. Si ces métadonnées d’élément ne sont pas spécifiée, la tâche utilise le chemin absolu du répertoire où se trouve le fichier projet.If this item metadata is not specified, the task uses the absolute path of the directory where the project file is located.

NotesRemarks

Métadonnées d’élément TypeLibNamesTypeLibNames Item Metadata

Le tableau suivant décrit les métadonnées d’élément disponibles pour les éléments passés au paramètre TypeLibNames.The following table describes the item metadata available for items passed to the TypeLibNames parameter.

MétadonnéesMetadata DescriptionDescription
GUID Métadonnées d’élément obligatoires.Required item metadata.

GUID de la bibliothèque de types.The GUID for the type library. Si ces métadonnées d’élément ne sont pas spécifiées, la tâche échoue.If this item metadata is not specified , the task fails.
VersionMajor Métadonnées d’élément obligatoires.Required item metadata.

Version principale de la bibliothèque de types.The major version of the type library. Si ces métadonnées d’élément ne sont pas spécifiées, la tâche échoue.If this item metadata is not specified , the task fails.
VersionMinor Métadonnées d’élément obligatoires.Required item metadata.

Version secondaire de la bibliothèque de types.The minor version of the type library. Si ces métadonnées d’élément ne sont pas spécifiées, la tâche échoue.If this item metadata is not specified, the task fails.
LocaleIdentifier Métadonnées d’élément facultatives.Optional item metadata.

Identificateur de paramètres régionaux (LCID) pour la bibliothèque de types.The Locale Identifier (or LCID) for the type library. Ceci est spécifié sous la forme d’une valeur sur 32 bits qui identifie la langue préférée par un utilisateur, une région ou une application.This is specified as a 32-bit value that identifies the human language preferred by a user, region, or application. Si ces métadonnées d’élément ne sont pas spécifiées, la tâche utilise « 0 » comme identificateur de paramètres régionaux par défaut.If this item metadata is not specified, the task uses a default locale identifier of "0".
WrapperTool Métadonnées d’élément facultatives.Optional item metadata.

Spécifie l’outil wrapper utilisé pour générer le wrapper d’assembly pour cette bibliothèque de types.Specifies the wrapper tool that is used to generate the assembly wrapper for this type library. Si ces métadonnées d’élément ne sont pas spécifiées, la tâche utilise « tlbimp » comme outil wrapper par défaut.If this item metadata is not specified, the task uses a default wrapper tool of "tlbimp". Les choix disponibles (leur casse n’est pas prise en compte) sont :The available, case insensitive choices of typelibs are:

- Primary : utilisez cet outil wrapper quand vous voulez utiliser un assembly PIA (Primary Interop Assembly) déjà généré pour le composant COM.- Primary: Use this wrapper tool when you want to use an already generated primary interop assembly for the COM component. Quand vous utilisez cet outil wrapper, ne spécifiez pas un répertoire de sortie du wrapper, car cela provoquerait l’échec de la tâche.When you use this wrapper tool, do not specify a wrapper output directory because that will cause the task to fail.
- TLBImp : utilisez cet outil wrapper quand vous voulez générer un assembly d’interopérabilité pour le composant COM.- TLBImp: Use this wrapper tool when you want to generate an interop assembly for the COM component.
- AXImp : utilisez cet outil wrapper quand vous voulez générer un assembly d’interopérabilité pour un contrôle ActiveX.- AXImp:Use this wrapper tool when you want to generate an interop assembly for an ActiveX Control.

Métadonnées d’élément TypeLibFilesTypeLibFiles Item Metadata

Le tableau suivant décrit les métadonnées d’élément disponibles pour les éléments passés au paramètre TypeLibFiles.The following table describes the item metadata available for items passed to the TypeLibFiles parameter.

MétadonnéesMetadata DescriptionDescription
WrapperTool Métadonnées d’élément facultatives.Optional item metadata.

Spécifie l’outil wrapper utilisé pour générer le wrapper d’assembly pour cette bibliothèque de types.Specifies the wrapper tool that is used to generate the assembly wrapper for this type library. Si ces métadonnées d’élément ne sont pas spécifiées, la tâche utilise « tlbimp » comme outil wrapper par défaut.If this item metadata is not specified, the task uses a default wrapper tool of "tlbimp". Les choix disponibles (leur casse n’est pas prise en compte) sont :The available, case insensitive choices of typelibs are:

- Primary : utilisez cet outil wrapper quand vous voulez utiliser un assembly PIA (Primary Interop Assembly) déjà généré pour le composant COM.- Primary: Use this wrapper tool when you want to use an already generated primary interop assembly for the COM component. Quand vous utilisez cet outil wrapper, ne spécifiez pas un répertoire de sortie du wrapper, car cela provoquerait l’échec de la tâche.When you use this wrapper tool, do not specify a wrapper output directory because that will cause the task to fail.
- TLBImp : utilisez cet outil wrapper quand vous voulez générer un assembly d’interopérabilité pour le composant COM.- TLBImp: Use this wrapper tool when you want to generate an interop assembly for the COM component.
- AXImp : utilisez cet outil wrapper quand vous voulez générer un assembly d’interopérabilité pour un contrôle ActiveX.- AXImp: Use this wrapper tool when you want to generate an interop assembly for an ActiveX Control.

Note

Plus vous fournissez d’informations pour identifier de façon univoque une bibliothèque de types, plus grande est la possibilité que la tâche aboutisse au fichier correct sur le disque.The more information that you provide to uniquely identify a type library, the greater the possibility that the task will resolve to the correct file on disk.

NotesRemarks

En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe Task.In addition to the parameters listed above, this task inherits parameters from the Task class. Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Task, classe de base.For a list of these additional parameters and their descriptions, see Task Base Class.

Voir aussiSee Also

Tâches Tasks
Task Reference (Informations de référence sur les tâches MSBuild)Task Reference