Dela via

ResolveComReference task

Tar en lista över ett eller flera typbiblioteksnamn eller .tlb-filer och löser dessa typbibliotek till platser på disken.

Parameters

I följande tabell beskrivs parametrarna för den ResolveCOMReference aktiviteten.

Parameter Description
DelaySign Valfri Boolean parameter.

Om trueplacerar den offentliga nyckeln i sammansättningen. Om false, signerar sammansättningen fullständigt.
EnvironmentVariables Valfri String[] parameter.

Matris med par med miljövariabler, avgränsade med likhetstecken. Dessa variabler skickas till den skapade tlbimp.exe och aximp.exe utöver, eller selektivt åsidosättande, det vanliga miljöblocket.
ExecuteAsTool Valfri Boolean parameter.

Om truekörs tlbimp.exe och aximp.exe från lämpligt målramverk för att generera nödvändiga omslutningssammansättningar. Den här parametern aktiverar flera mål.
IncludeVersionInInteropName Valfri Boolean parameter.

Om trueingår typbiblioteksversionen i omslutningsnamnet. Standardvärdet är false.
KeyContainer Valfri String parameter.

Anger en container som innehåller ett offentligt/privat nyckelpar.
KeyFile Valfri String parameter.

Anger ett objekt som innehåller ett offentligt/privat nyckelpar.
NoClassMembers Valfri Boolean parameter.
ResolvedAssemblyReferences Valfri ITaskItem[] utdataparameter.

Anger de lösta sammansättningsreferenserna.
ResolvedFiles Valfri ITaskItem[] utdataparameter.

Anger de fullständigt kvalificerade filerna på disken som motsvarar de fysiska platserna för de typbibliotek som angavs som indata för den här uppgiften.
ResolvedModules Valfri ITaskItem[]parameter.
SdkToolsPath Valfri System.String parameter.

Om ExecuteAsTool är truemåste den här parametern vara inställd på SDK-verktygssökvägen för den ramverksversion som är mål.
StateFile Valfri String parameter.

Anger cachefilen för COM-komponentens tidsstämplar. Om den inte finns återskapar varje körning alla omslutningar.
TargetFrameworkVersion Valfri String parameter.

Anger projektmålramverkets version.

Standardvärdet är String.Empty. vilket innebär att det inte finns någon filtrering för en referens baserat på målramverket.
TargetProcessorArchitecture Valfri String parameter.

Anger önskad målprocessorarkitektur. Skickades till flaggantlbimp.exe/machine efter översättningen.

Parametervärdet ska vara medlem i ProcessorArchitecture.
TypeLibFiles Valfri ITaskItem[] parameter.

Anger filsökvägen för typbiblioteket till COM-referenser. Objekt som ingår i den här parametern kan innehålla objektmetadata. Mer information finns i avsnittet TypeLibFiles-objektmetadata.
TypeLibNames Valfri ITaskItem[] parameter.

Anger vilka typbiblioteksnamn som ska matchas. Objekt som ingår i den här parametern måste innehålla vissa objektmetadata. Mer information finns i avsnittet TypeLibNames-objektmetadata.
WrapperOutputDirectory Valfri String parameter.

Den plats på disken där den genererade interop-sammansättningen placeras. Om det här objektets metadata inte har angetts använder aktiviteten den absoluta sökvägen till katalogen där projektfilen finns.

TypeLibNames-objektmetadata

I följande tabell beskrivs de objektmetadata som är tillgängliga för objekt som skickas till parametern TypeLibNames .

Metadata Description
GUID Nödvändiga objektmetadata.

GUID för typbiblioteket. Om det här objektets metadata inte har angetts misslyckas uppgiften.
VersionMajor Nödvändiga objektmetadata.

Huvudversionen av typbiblioteket. Om det här objektets metadata inte har angetts misslyckas uppgiften.
VersionMinor Nödvändiga objektmetadata.

Delversionen av typbiblioteket. Om det här objektets metadata inte har angetts misslyckas uppgiften.
EmbedInteropTypes Valfria Boolean metadata.

Om truebäddar du in interop-typerna från den här referensen direkt i sammansättningen i stället för att generera en interop-DLL.
LocaleIdentifier Valfria objektmetadata.

Språkidentifieraren (eller LCID) för typbiblioteket. Den här identifieraren anges som ett 32-bitarsvärde som identifierar det mänskliga språk som föredras av en användare, region eller ett program. Om det här objektets metadata inte har angetts använder aktiviteten en standardidentifierare för nationella inställningar på "0".
WrapperTool Valfria objektmetadata.

Anger omslutningsverktyget som används för att generera sammansättningsomslutningen för det här typbiblioteket. Om det här objektets metadata inte har angetts använder aktiviteten ett standardomslutningsverktyg med "tlbimp". De tillgängliga, skiftlägesokänsliga alternativen för typbibliotek är:

- Primary: Använd det här omslutningsverktyget när du vill använda en redan genererad primär interop-sammansättning för COM-komponenten. När du använder det här omslutningsverktyget ska du inte ange en utdatakatalog för omslutningen eftersom det gör att uppgiften misslyckas.
- TLBImp: Använd det här omslutningsverktyget när du vill generera en interop-sammansättning för COM-komponenten.
- PrimaryOrTLBImp: Använd det här omslutningsverktyget när du är osäker på om Primary eller TLBImp är lämplig. Logiken Primary tillämpas först och sedan TLBImp.
- AXImp: Använd det här omslutningsverktyget när du vill generera en interop-sammansättning för en ActiveX-kontroll.

TypeLibFiles-objektmetadata

I följande tabell beskrivs de objektmetadata som är tillgängliga för objekt som skickas till parametern TypeLibFiles .

Metadata Description
EmbedInteropTypes Valfri Boolean parameter.

Om truebäddar du in interop-typerna från den här referensen direkt i sammansättningen i stället för att generera en interop-DLL.
WrapperTool Valfria objektmetadata.

Anger omslutningsverktyget som används för att generera sammansättningsomslutningen för det här typbiblioteket. Om det här objektets metadata inte har angetts använder aktiviteten ett standardomslutningsverktyg med "tlbimp". De tillgängliga, skiftlägesokänsliga alternativen för typbibliotek är:

- Primary: Använd det här omslutningsverktyget när du vill använda en redan genererad primär interop-sammansättning för COM-komponenten. När du använder det här omslutningsverktyget ska du inte ange en utdatakatalog för omslutningen eftersom det gör att uppgiften misslyckas.
- TLBImp: Använd det här omslutningsverktyget när du vill generera en interop-sammansättning för COM-komponenten.
- AXImp: Använd det här omslutningsverktyget när du vill generera en interop-sammansättning för en ActiveX-kontroll.

Note

Ju mer information du anger för att unikt identifiera ett typbibliotek, desto större är möjligheten att uppgiften matchar rätt fil på disken.

Remarks

Förutom de parametrar som anges i den här artikeln ärver den här aktiviteten parametrar från Task klassen. En lista över dessa ytterligare parametrar och deras beskrivningar finns i Aktivitetsbasklass.

COM DLL behöver inte vara registrerad på datorn för att den här uppgiften ska fungera.

MSB4803 Error

Om du försöker köra ett projekt som använder ResolveCOMReference uppgiften från dotnet CLI-kommandona får du felet:

MSB4803: The task "ResolveComReference" is not supported on the .NET Core version of MSBuild. Please use the .NET Framework version of MSBuild.

Den här uppgiften stöds inte i .NET Core-versionen av MSBuild, vilket är vad som används när du kör dotnet build kommandot från kommandoraden. Prova att skapa projektet genom att anropa MSBuild.exe från Visual Studio Developer Command Prompt, eftersom den körbara filen använder .NET Framework-versionen av MSBuild.

Related content