Delen via

ResolveComReference task

Hiermee wordt een lijst met een of meer typebibliotheeknamen of .tlb-bestanden gebruikt en worden deze typebibliotheken omgezet naar locaties op schijf.

Parameters

In de volgende tabel worden de parameters van de ResolveCOMReference taak beschreven.

Parameter Description
DelaySign Optionele Boolean parameter.

Als true, plaatst u de openbare sleutel in de assembly. Indien false, volledig ondertekent de assembly.
EnvironmentVariables Optionele String[] parameter.

Matrix van paren van omgevingsvariabelen, gescheiden door gelijktekens. Deze variabelen worden doorgegeven aan het spawned tlbimp.exe en aximp.exe naast of selectief overschrijven van het reguliere omgevingsblok.
ExecuteAsTool Optionele Boolean parameter.

Als true, wordt tlbimp.exe en aximp.exe uitgevoerd vanuit het juiste doelframework out-of-proc om de benodigde wrapper-assembly's te genereren. Met deze parameter kunt u meerdere targetings instellen.
IncludeVersionInInteropName Optionele Boolean parameter.

Als truede versie van de typebibliotheek is opgenomen in de naam van de wrapper. De standaardwaarde is false.
KeyContainer Optionele String parameter.

Hiermee geeft u een container op die een openbaar/persoonlijk sleutelpaar bevat.
KeyFile Optionele String parameter.

Hiermee geeft u een item op dat een openbaar/persoonlijk sleutelpaar bevat.
NoClassMembers Optionele Boolean parameter.
ResolvedAssemblyReferences Optionele ITaskItem[] uitvoerparameter.

Hiermee geeft u de opgeloste assemblyverwijzingen op.
ResolvedFiles Optionele ITaskItem[] uitvoerparameter.

Hiermee geeft u de volledig gekwalificeerde bestanden op schijf die overeenkomen met de fysieke locaties van de typebibliotheken die als invoer voor deze taak zijn opgegeven.
ResolvedModules Optionele ITaskItem[]parameter.
SdkToolsPath Optionele System.String parameter.

Als ExecuteAsTool dat het is true, moet deze parameter worden ingesteld op het pad naar sdk-hulpprogramma's voor de frameworkversie waarop de toepassing wordt toegepast.
StateFile Optionele String parameter.

Hiermee geeft u het cachebestand voor COM-component timestamps. Als deze niet aanwezig is, genereert elke uitvoering alle wrappers opnieuw.
TargetFrameworkVersion Optionele String parameter.

Hiermee geeft u de versie van het projectdoelframework op.

De standaardwaarde is String.Empty. dit betekent dat er geen filters zijn voor een verwijzing op basis van het doelframework.
TargetProcessorArchitecture Optionele String parameter.

Hiermee geeft u de voorkeursdoelprocessorarchitectuur. Doorgegeven aan de tlbimp.exe/machinevlag na vertaling.

De parameterwaarde moet lid zijn van ProcessorArchitecture.
TypeLibFiles Optionele ITaskItem[] parameter.

Hiermee geeft u het type bibliotheekbestandspad naar COM-verwijzingen. Items die zijn opgenomen in deze parameter kunnen metagegevens van items bevatten. Zie de sectie TypeLibFiles-itemmetagegevens voor meer informatie.
TypeLibNames Optionele ITaskItem[] parameter.

Hiermee geeft u de typebibliotheeknamen op die moeten worden omgezet. Items die in deze parameter zijn opgenomen, moeten enkele metagegevens van items bevatten. Zie de sectie TypeLibNames-itemmetagegevens voor meer informatie.
WrapperOutputDirectory Optionele String parameter.

De locatie op schijf waar de gegenereerde interop-assembly wordt geplaatst. Als deze itemmetagegevens niet zijn opgegeven, gebruikt de taak het absolute pad van de map waarin het projectbestand zich bevindt.

Metagegevens van typeLibNames-items

In de volgende tabel worden de metagegevens van items beschreven die beschikbaar zijn voor items die aan de TypeLibNames parameter zijn doorgegeven.

Metadata Description
GUID Vereiste metagegevens van items.

De GUID voor de typebibliotheek. Als deze itemmetagegevens niet zijn opgegeven, mislukt de taak.
VersionMajor Vereiste metagegevens van items.

De primaire versie van de typebibliotheek. Als deze itemmetagegevens niet zijn opgegeven, mislukt de taak.
VersionMinor Vereiste metagegevens van items.

De secundaire versie van de typebibliotheek. Als deze itemmetagegevens niet zijn opgegeven, mislukt de taak.
EmbedInteropTypes Optionele Boolean metagegevens.

Als trueu de interoperabiliteitstypen uit deze verwijzing rechtstreeks in uw assembly insluit in plaats van een interop-DLL te genereren.
LocaleIdentifier Optionele metagegevens van items.

De landinstellings-id (of LCID) voor de typebibliotheek. Deze id wordt opgegeven als een 32-bits waarde die de voorkeur geeft aan de menselijke taal door een gebruiker, regio of toepassing. Als deze itemmetagegevens niet zijn opgegeven, gebruikt de taak een standaard landinstellings-id van '0'.
WrapperTool Optionele metagegevens van items.

Hiermee geeft u het wrapper-hulpprogramma op dat wordt gebruikt voor het genereren van de assembly-wrapper voor deze typebibliotheek. Als deze itemmetagegevens niet zijn opgegeven, gebruikt de taak een standaard-wrapperhulpprogramma van 'tlbimp'. De beschikbare, niet hoofdlettergevoelige opties van typebibliotheken zijn:

- Primary: Gebruik dit wrapper-hulpprogramma als u een reeds gegenereerde primaire interoperabiliteitsassembly wilt gebruiken voor het COM-onderdeel. Wanneer u dit wrapper-hulpprogramma gebruikt, geeft u geen wrapper-uitvoermap op, omdat deze ervoor zorgt dat de taak mislukt.
- TLBImp: Gebruik dit wrapper-hulpprogramma als u een interoperabiliteitsassembly wilt genereren voor het COM-onderdeel.
- PrimaryOrTLBImp: Gebruik dit wrapper-hulpprogramma wanneer u niet zeker weet of Primary of of dit TLBImp geschikt is. De Primary logica wordt eerst toegepast en vervolgens TLBImp.
- AXImp: Gebruik dit wrapper-hulpprogramma als u een interop-assembly wilt genereren voor een ActiveX-besturingselement.

Metagegevens van typeLibFiles-items

In de volgende tabel worden de metagegevens van items beschreven die beschikbaar zijn voor items die aan de TypeLibFiles parameter zijn doorgegeven.

Metadata Description
EmbedInteropTypes Optionele Boolean parameter.

Als trueu de interoperabiliteitstypen uit deze verwijzing rechtstreeks in uw assembly insluit in plaats van een interop-DLL te genereren.
WrapperTool Optionele metagegevens van items.

Hiermee geeft u het wrapper-hulpprogramma op dat wordt gebruikt voor het genereren van de assembly-wrapper voor deze typebibliotheek. Als deze itemmetagegevens niet zijn opgegeven, gebruikt de taak een standaard-wrapperhulpprogramma van 'tlbimp'. De beschikbare, niet hoofdlettergevoelige opties van typebibliotheken zijn:

- Primary: Gebruik dit wrapper-hulpprogramma als u een reeds gegenereerde primaire interoperabiliteitsassembly wilt gebruiken voor het COM-onderdeel. Wanneer u dit wrapper-hulpprogramma gebruikt, geeft u geen wrapper-uitvoermap op, omdat deze ervoor zorgt dat de taak mislukt.
- TLBImp: Gebruik dit wrapper-hulpprogramma als u een interoperabiliteitsassembly wilt genereren voor het COM-onderdeel.
- AXImp: Gebruik dit wrapper-hulpprogramma als u een interop-assembly wilt genereren voor een ActiveX-besturingselement.

Note

Hoe meer informatie u opgeeft om een typebibliotheek uniek te identificeren, hoe groter de mogelijkheid dat de taak wordt omgezet in het juiste bestand op schijf.

Remarks

Naast de parameters die in dit artikel worden vermeld, neemt deze taak parameters over van de Task klasse. Zie Task base-klassevoor een lijst met deze aanvullende parameters en de bijbehorende beschrijvingen.

Het COM-DLL-bestand hoeft niet te worden geregistreerd op de computer om deze taak te laten werken.

MSB4803 Error

Als u probeert een project uit te voeren dat gebruikmaakt van de ResolveCOMReference taak uit de dotnet CLI-opdrachten, wordt de volgende fout weergegeven:

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

Deze taak wordt niet ondersteund in de .NET Core-versie van MSBuild, wat wordt gebruikt wanneer u de dotnet build opdracht vanaf de opdrachtregel uitvoert. Probeer het project te bouwen door MSBuild.exe aan te roepen vanuit de Visual Studio Developer-opdrachtprompt, omdat dit uitvoerbare bestand gebruikmaakt van de .NET Framework-versie van MSBuild.

Related content