ResolveComReference-Aufgabe
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 |
Beschreibungen |
|---|---|
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. |
EnvironmentVariables |
Optionaler String[]-Parameter. Array von Paaren von Umgebungsvariablen, durch Gleichheitszeichen getrennt. Diese Variablen werden an die erzeugte tlbimp.exe und aximp.exe übergeben, neben dem regulären Umgebungsblock oder diesen selektiv überschreibend. |
ExecuteAsTool |
Optionaler Boolean-Parameter. Wenn true, werden tlbimp.exe und aximp.exe vom entsprechenden Ziel-Framework-Out-of-Proc ausgeführt, um die erforderlichen Wrapperassemblys zu generieren. Dieser Parameter ermöglicht Festlegung von Zielversionen. |
IncludeVersionInInteropName |
Optionaler Boolean-Parameter. Bei true wird die Typelib-Version in den Wrappernamen aufgenommen. Der Standardwert ist false. |
KeyContainer |
Optionaler String-Parameter. Gibt einen Behälter mit einem Paar aus öffentlichem und privatem Schlüsselpaar. |
KeyFile |
Optionaler String-Parameter. Gibt ein Element mit einem Paar aus öffentlichem und privatem Schlüsselpaar. |
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. |
SdkToolsPath |
Optionaler [String]-Parameter. Wenn ExecuteAsTool gleich true ist, muss dieser Paramete auf den Pfad der SDK-Tools für die Zielframeworkversion festgelegt werden. |
StateFile |
Optionaler [String]-Parameter. Gibt die Cachedatei für Timestamps von COM-Komponenten an. Falls nicht vorhanden, werden bei jedem Lauf alle Wrapper neu generiert. |
TargetFrameworkVersion |
Optionaler [String]-Parameter. Gibt die Zielframeworkversion für das Projekt an. Der Standardwert ist String.Empty. d. h., die Verweise werden nicht anhand des Zielframeworks gefiltert. |
TargetProcessorArchitecture |
Optionaler [String]-Parameter. Gibt die bevorzugte Architektur des Zielprozessors an. Wird nach der Übersetzung an das /machine-Flag von tlbimp.exe übergeben. Der Wert des Parameters sollte ein Member von ProcessorArchitecture sein. |
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
Abzielen auf 32-Bit-Komponenten auf 64-Bit-Computern
Auf einem 64-Bit-Computer kann Framework64/<Version>/msbuilde COM-Objekte nicht auflösen, die als 32-Bit-Komponenten registriert wurde. Wenn Sie zum Beispiel ein COM-Objekt mit regsvr32 registrieren und dann versuchen, ein Projekt zu erstellen, das mit Framework64/<Version>/msbuild auf die x86-Plattform abzielt, kann der Build das COM-Objekt nicht auflösen. Wenn Sie stattdessen mit Framework/<Version>/msbuild erstellen, kann der Build das COM-Objekt auflösen.
TypeLibNames-Elementmetadaten
In der folgenden Tabelle werden die verfügbaren Elementmetadaten für die an den TypeLibNames-Parameter übergebenen Elemente beschrieben.
Metadaten |
Beschreibungen |
|---|---|
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.
|
TypeLibFiles-Elementmetadaten
In der folgenden Tabelle werden die verfügbaren Elementmetadaten für die an den TypeLibFiles-Parameter übergebenen Elemente beschrieben.
Metadaten |
Beschreibungen |
|---|---|
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.
|
.gif "Hinweis") Hinweis |
|---|
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. |
Hinweise
Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der Task-Klasse. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter Aufgabenbasisklasse.