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 :
|
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 :
|
Notes
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.