Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Prend une liste d’un ou plusieurs noms de bibliothèque de types ou fichiers .tlb et résout ces bibliothèques de types en emplacements sur le disque.
Parameters
Le tableau suivant décrit les paramètres de la tâche ResolveCOMReference.
| Parameter | Description |
|---|---|
DelaySign |
Paramètre Boolean facultatif.Si true, place la clé publique dans l’assembly. Si false, signe entièrement l’assembly. |
EnvironmentVariables |
Paramètre String[] facultatif.Tableau de paires de variables d’environnement, séparées par des signes égaux. Ces variables sont transmises au tlbimp.exe généré et aximp.exe en plus, ou de manière sélective, au bloc d’environnement normal. |
ExecuteAsTool |
Paramètre Boolean facultatif.Si true, exécute tlbimp.exe et aximp.exe à partir du framework cible approprié out-of-proc pour générer les assemblys wrapper nécessaires. Ce paramètre active le ciblage multiple. |
IncludeVersionInInteropName |
Paramètre Boolean facultatif.Si true, la version de la bibliothèque de types est incluse dans le nom du wrapper. La valeur par défaut est false. |
KeyContainer |
Paramètre String facultatif.Spécifie un conteneur qui contient 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 à cette tâche. |
ResolvedModules |
Paramètre facultatif ITaskItem[]. |
SdkToolsPath |
Paramètre System.String facultatif. Si ExecuteAsTool c’est truele cas, ce paramètre doit être défini sur le chemin des outils sdk pour la version du framework ciblée. |
StateFile |
Paramètre String facultatif.Spécifie le fichier de cache pour les horodatages des composants COM. S’il n’est pas présent, chaque exécution régénère tous les wrappers. |
TargetFrameworkVersion |
Paramètre String facultatif.Spécifie la version du framework cible du projet. La valeur par défaut est String.Empty. cela signifie qu’il n’existe aucun filtrage pour une référence basée sur le framework cible. |
TargetProcessorArchitecture |
Paramètre String facultatif.Spécifie l’architecture de processeur cible préférée. Transmis au tlbimp.exe/machine flag après la traduction. La valeur du paramètre doit être membre de ProcessorArchitecture. |
TypeLibFiles |
Paramètre ITaskItem[] facultatif.Spécifie le chemin du fichier de bibliothèque de types vers les 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 de l’élément TypeLibFiles. |
TypeLibNames |
Paramètre ITaskItem[] facultatif.Spécifie les noms de bibliothèque 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 de l’élément TypeLibNames. |
WrapperOutputDirectory |
Paramètre String facultatif.Emplacement sur le disque où l’assembly d’interopérabilité généré est placé. Si ces métadonnées d’élément ne sont pas spécifiées, la tâche utilise le chemin absolu du répertoire où se trouve le fichier projet. |
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 TypeLibNames paramètre.
| Metadata | 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. |
EmbedInteropTypes |
Métadonnées facultatives Boolean .Si true, incorporez les types d’interopérabilité de cette référence directement dans votre assembly plutôt que de générer une DLL d’interopérabilité. |
LocaleIdentifier |
Métadonnées d’élément facultatives. Identificateur de paramètres régionaux (ou LCID) de la bibliothèque de types. Cet identificateur est spécifié sous la forme d’une valeur 32 bits qui identifie le langage humain préféré par 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 un identificateur de paramètres régionaux par défaut de « 0 ». |
WrapperTool |
Métadonnées d’élément facultatives. Spécifie l’outil wrapper utilisé pour 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 un outil wrapper par défaut de « tlbimp ». Les choix disponibles qui ne respectent pas la casse des bibliothèques de types sont les suivants : - Primary: Utilisez cet outil wrapper lorsque vous souhaitez utiliser un assembly d’interopérabilité principal déjà généré pour le composant COM. Lorsque vous utilisez cet outil wrapper, ne spécifiez pas de répertoire de sortie wrapper, car cela provoque 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.- PrimaryOrTLBImp: Utilisez cet outil wrapper lorsque vous ne savez pas si Primary ou TLBImp est approprié. La Primary logique est appliquée en premier, puis TLBImp.- 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 TypeLibFiles paramètre.
| Metadata | Description |
|---|---|
EmbedInteropTypes |
Paramètre Boolean facultatif.Si true, incorporez les types d’interopérabilité de cette référence directement dans votre assembly plutôt que de générer une DLL d’interopérabilité. |
WrapperTool |
Métadonnées d’élément facultatives. Spécifie l’outil wrapper utilisé pour 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 un outil wrapper par défaut de « tlbimp ». Les choix disponibles qui ne respectent pas la casse des bibliothèques de types sont les suivants : - Primary: Utilisez cet outil wrapper lorsque vous souhaitez utiliser un assembly d’interopérabilité principal déjà généré pour le composant COM. Lorsque vous utilisez cet outil wrapper, ne spécifiez pas de répertoire de sortie wrapper, car cela provoque 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. |
Note
Plus vous fournissez d’informations pour identifier de manière unique une bibliothèque de types, plus la tâche est résolue sur le fichier correct sur le disque.
Remarks
Outre les paramètres répertoriés dans cet article, cette tâche hérite des paramètres de la Task classe. Pour obtenir la liste de ces paramètres supplémentaires et de leurs descriptions, consultez classe de base de tâches.
La DLL COM n’a pas besoin d’être inscrite sur l’ordinateur pour que cette tâche fonctionne.
MSB4803 Error
Si vous essayez d’exécuter un projet qui utilise la ResolveCOMReference tâche à partir des dotnet commandes CLI, vous obtenez l’erreur :
MSB4803: The task "ResolveComReference" is not supported on the .NET Core version of MSBuild. Please use the .NET Framework version of MSBuild.
Cette tâche n’est pas prise en charge sur la version .NET Core de MSBuild, ce qui est utilisé lorsque vous exécutez la dotnet build commande à partir de la ligne de commande. Essayez de générer le projet en appelant MSBuild.exe à partir de l’invite de commandes du développeur Visual Studio, car cet exécutable utilise la version .NET Framework de MSBuild.