Attività ResolveComReference
Accetta un elenco costituito da uno o più nomi di librerie dei tipi o file con estensione tlb e risolve tali librerie in percorsi sul disco.
Parametri
Nella tabella riportata di seguito sono descritti i parametri dell'attività ResolveCOMReference.
Parametro |
Descrizione |
|---|---|
DelaySign |
Parametro Boolean facoltativo. Se il parametro è impostato su true, la chiave pubblica viene inserita nell'assembly. Se è impostato su false, l'assembly viene firmato completamente. |
EnvironmentVariables |
Parametro String[] facoltativo. Matrice di coppie di variabili di ambiente, separate da segni di uguale. Tali variabili vengono passate ai file tlbimp.exe e aximp.exe compilati in aggiunta al blocco di ambiente regolare oppure eseguendo l'override selettivo di tale blocco. |
ExecuteAsTool |
Parametro Boolean facoltativo. Se true, tlbimp.exe e aximp.exe vengono eseguiti dal framework di destinazione appropriato in modalità out-of-process per generare gli assembly wrapper necessari. Questo parametro abilita il multitargeting. |
IncludeVersionInInteropName |
Parametro Boolean facoltativo. Se true, la versione typelib sarà inclusa nel nome del wrapper. Il valore predefinito è false. |
KeyContainer |
Parametro String facoltativo. Specifica un contenitore che contiene una coppia di chiavi pubblica/privata. |
KeyFile |
Parametro String facoltativo. Specifica un elemento che contiene una coppia di chiavi pubblica/privata. |
NoClassMembers |
Parametro Boolean facoltativo. |
ResolvedAssemblyReferences |
Parametro di output ITaskItem[] facoltativo. Specifica i riferimenti ad assembly risolti. |
ResolvedFiles |
Parametro di output ITaskItem[] facoltativo. Specifica in modo completo i file su disco che corrispondono alle posizioni fisiche delle librerie dei tipi fornite come input per questa attività. |
ResolvedModules |
Parametro ITaskItem[] facoltativo. |
SdkToolsPath |
Parametro [String] facoltativo. Se ExecuteAsTool è true, questo parametro deve essere impostato sul percorso degli strumenti SDK per la versione di framework di destinazione. |
StateFile |
Parametro [String] facoltativo. Specifica il file di cache per i timestamp dei componenti COM. Se non presente, ogni esecuzione rigenererà tutti i wrapper. |
TargetFrameworkVersion |
Parametro [String] facoltativo. Specifica la versione del framework di destinazione del progetto. Il valore predefinito è String.Empty. per indicare che non viene applicato alcun filtro per un riferimento in base al framework di destinazione. |
TargetProcessorArchitecture |
Parametro [String] facoltativo. Specifica l'architettura preferita del processore di destinazione. Passato al flag tlbimp.exe /machine dopo la conversione. Il valore del parametro deve essere un membro di ProcessorArchitecture. |
TypeLibFiles |
Parametro ITaskItem[] facoltativo. Specifica il percorso del file della libreria dei tipi per i riferimenti COM. Gli elementi inclusi in questo parametro possono contenere metadati dell'elemento. Per ulteriori informazioni, vedere la sezione "Metadati dell'elemento TypeLibFiles" riportata di seguito. |
TypeLibNames |
Parametro ITaskItem[] facoltativo. Specifica i nomi delle librerie dei tipi da risolvere. Gli elementi inclusi in questo parametro devono contenere alcuni metadati dell'elemento. Per ulteriori informazioni, vedere la sezione "Metadati dell'elemento TypeLibNames" riportata di seguito. |
WrapperOutputDirectory |
Parametro String facoltativo. Percorso su disco in cui viene inserito l'assembly di interoperabilità generato. Se non vengono specificati questi metadati di elemento, nell'attività verrà utilizzato il percorso assoluto della directory in cui si trova il file di progetto. |
Note
Metadati dell'elemento TypeLibNames
Nella tabella riportata di seguito vengono descritti i metadati disponibili per gli elementi passati al parametro TypeLibNames.
Metadati |
Descrizione |
|---|---|
GUID |
Metadati di elemento obbligatori. GUID per la libreria dei tipi. Se non vengono specificati questi metadati di elemento, l'attività ha esito negativo. |
VersionMajor |
Metadati di elemento obbligatori. La versione principale della libreria dei tipi. Se non vengono specificati questi metadati di elemento, l'attività ha esito negativo. |
VersionMinor |
Metadati di elemento obbligatori. La versione secondaria della libreria dei tipi. Se non vengono specificati questi metadati di elemento, l'attività ha esito negativo. |
LocaleIdentifier |
Metadati di elemento facoltativi. Identificatore delle impostazioni locali (LCID) per la libreria dei tipi. Viene specificato come valore a 32 bit che identifica la lingua preferita da un utente, un paese o un'applicazione. Se non vengono specificati questi metadati di elemento, nell'attività verrà utilizzato l'identificatore delle impostazioni locali predefinito "0". |
WrapperTool |
Metadati di elemento facoltativi. Specifica lo strumento wrapper utilizzato per generare il wrapper dell'assembly per la libreria dei tipi in oggetto. Se non vengono specificati questi metadati di elemento, nell'attività verrà utilizzato lo strumento wrapper predefinito "tlbimp". Di seguito sono riportate le opzioni disponibili per typelibs (non viene fatta distinzione tra maiuscole e minuscole):
|
Metadati dell'elemento TypeLibFiles
Nella tabella riportata di seguito vengono descritti i metadati disponibili per gli elementi passati al parametro TypeLibFiles.
Metadati |
Descrizione |
|---|---|
WrapperTool |
Metadati di elemento facoltativi. Specifica lo strumento wrapper utilizzato per generare il wrapper dell'assembly per la libreria dei tipi in oggetto. Se non vengono specificati questi metadati di elemento, nell'attività verrà utilizzato lo strumento wrapper predefinito "tlbimp". Di seguito sono riportate le opzioni disponibili per typelibs (non viene fatta distinzione tra maiuscole e minuscole):
|
Nota
Una maggiore quantità di informazioni fornite allo scopo di identificare in maniera univoca una libreria dei tipi aumenta le probabilità di risoluzione dell'attività nel file corretto su disco.
Note
Oltre ai parametri elencati in precedenza, questa attività eredita i parametri dalla classe Task. Per un elenco di tali parametri aggiuntivi e le relative descrizioni, vedere Classe di base Task.