Freigeben über


ResolveComReference-Aufgabe

Aktualisiert: November 2007

Erstellt eine Liste mit mindestens einem Typbibliotheknamen oder mindestens einer TLB-Datei und löst die Typbibliotheken in Speicherorten auf dem Datenträger auf.

Parameter

In der folgenden Tabelle werden die Parameter der ResolveCOMReference-Aufgabe beschrieben.

Parameter

Beschreibung

DelaySign

Optionaler Boolean-Parameter.

Wenn der Wert true lautet, fügt die Aufgabe den öffentlichen Schlüssel in die Assembly ein. Lautet der Wert false, signiert die Aufgabe die Assembly vollständig.

KeyContainer

Optionaler String-Parameter.

Gibt einen Container an, der ein Schlüsselpaar enthält.

KeyFile

Optionaler String-Parameter.

Gibt ein Element an, das ein Schlüsselpaar enthält.

NoClassMembers

Optionaler Boolean-Parameter.

ResolvedAssemblyReferences

Optionaler ITaskItem[]-Ausgabeparameter.

Gibt die aufgelösten Assemblyverweise an.

ResolvedFiles

Optionaler ITaskItem[]-Ausgabeparameter.

Gibt die vollqualifizierten Dateien auf dem Datenträger an, die mit den physikalischen Speicherorten der Typbibliotheken übereinstimmen, die bei dieser Aufgabe eingegeben wurden.

ResolvedModules

Optionaler ITaskItem[]-Parameter.

TypeLibFiles

Optionaler ITaskItem[]-Parameter.

Gibt den Dateipfad der Typbibliothek für COM-Verweise an. Die Elemente in diesem Parameter enthalten möglicherweise Elementmetadaten. Weitere Informationen finden Sie im Abschnitt "TypeLibFiles-Elementmetadaten" weiter unten.

TypeLibNames

Optionaler ITaskItem[]-Parameter.

Gibt die aufzulösenden Typbibliotheknamen an. Die Elemente in diesem Parameter müssen einige Elementmetadaten enthalten. Weitere Informationen finden Sie im Abschnitt "TypeLibNames-Elementmetadaten" weiter unten.

WrapperOutputDirectory

Optionaler String-Parameter.

Die Position auf dem Datenträger, an der die generierte Interop-Assembly gespeichert ist. Wenn diese Elementmetadaten nicht angegeben sind, verwendet die Aufgabe den absoluten Pfad des Verzeichnisses, in dem sich die Projektdatei befindet.

Hinweise

TypeLibNames-Elementmetadaten

In der folgenden Tabelle werden die verfügbaren Elementmetadaten für die an den TypeLibNames-Parameter übergebenen Elemente beschrieben.

Metadaten

Beschreibung

GUID

Erforderliche Elementmetadaten.

Die GUID für die Typbibliothek. Wenn diese Elementmetadaten nicht angegeben werden, kann die Aufgabe nicht ausgeführt werden.

VersionMajor

Erforderliche Elementmetadaten.

Die Hauptversion der Typbibliothek. Wenn diese Elementmetadaten nicht angegeben werden, kann die Aufgabe nicht ausgeführt werden.

VersionMinor

Erforderliche Elementmetadaten.

Die Nebenversion der Typbibliothek. Wenn diese Elementmetadaten nicht angegeben werden, kann die Aufgabe nicht ausgeführt werden.

LocaleIdentifier

Optionale Elementmetadaten.

Der Gebietsschemabezeichner (oder LCID) für die Typbibliothek. Dieser wird als 32-Bit-Wert festgelegt, mit dem die von einem Benutzer, in einer Region oder einer Anwendung bevorzugte Sprache angegeben wird. Wenn diese Elementmetadaten nicht angegeben werden, verwendet die Aufgabe den Standard-Gebietsschemabezeichner "0".

WrapperTool

Optionale Elementmetadaten.

Gibt das Wrappertool an, das zum Generieren des Assemblywrappers für diese Typbibliothek verwendet wird. Wenn diese Elementmetadaten nicht angegeben werden, verwendet die Aufgabe das Standardwrappertool "tlbimp". Folgende Optionen von typelibs können ausgewählt werden. Dabei muss die Groß- und Kleinschreibung beachtet werden.

  • Primary: Über dieses Wrappertool können Sie eine bereits generierte primäre Interop-Assembly für die COM-Komponente verwenden. Geben Sie bei Verwendung des Wrappertools kein Wrapperausgabeverzeichnis an, da dadurch Fehler beim Ausführen der Aufgabe auftreten.

  • TLBImp: Über dieses Wrappertool können Sie eine Interop-Assembly für die COM-Komponente generieren.

  • AXImp: Über dieses Wrappertool können Sie eine Interop-Assembly für eine ActiveX-Komponente generieren.

TypeLibFiles-Elementmetadaten

In der folgenden Tabelle werden die verfügbaren Elementmetadaten für die an den TypeLibFiles-Parameter übergebenen Elemente beschrieben.

Metadaten

Beschreibung

WrapperTool

Optionale Elementmetadaten.

Gibt das Wrappertool an, das zum Generieren des Assemblywrappers für diese Typbibliothek verwendet wird. Wenn diese Elementmetadaten nicht angegeben werden, verwendet die Aufgabe das Standardwrappertool "tlbimp". Folgende Optionen von typelibs können ausgewählt werden. Dabei muss die Groß- und Kleinschreibung beachtet werden.

  • Primary: Über dieses Wrappertool können Sie eine bereits generierte primäre Interop-Assembly für die COM-Komponente verwenden. Geben Sie bei Verwendung des Wrappertools kein Wrapperausgabeverzeichnis an, da dadurch Fehler beim Ausführen der Aufgabe auftreten.

  • TLBImp: Über dieses Wrappertool können Sie eine Interop-Assembly für die COM-Komponente generieren.

  • AXImp: Über dieses Wrappertool können Sie eine Interop-Assembly für eine ActiveX-Komponente generieren.

Tipp

Je mehr Informationen Sie zur eindeutigen Erkennung einer Typbibliothek eingeben, desto größer ist die Wahrscheinlichkeit, dass die Aufgabe die korrekte Datei auf dem Datenträger auflöst.

Siehe auch

Konzepte

MSBuild-Aufgaben

Weitere Ressourcen

Referenz zu MSBuild-Aufgaben