PrimaryInteropAssemblyAttribute-Klasse

Artikel
08/20/2007

Gibt an, dass die attributierte Assembly eine primäre Interop-Assembly ist.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited:=False, AllowMultiple:=True)> _
Public NotInheritable Class PrimaryInteropAssemblyAttribute
    Inherits Attribute
'Usage
Dim instance As PrimaryInteropAssemblyAttribute

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false, AllowMultiple=true)] 
public sealed class PrimaryInteropAssemblyAttribute : Attribute

[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Assembly, Inherited=false, AllowMultiple=true)] 
public ref class PrimaryInteropAssemblyAttribute sealed : public Attribute

/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false, AllowMultiple=true) */ 
public final class PrimaryInteropAssemblyAttribute extends Attribute

ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Assembly, Inherited=false, AllowMultiple=true) 
public final class PrimaryInteropAssemblyAttribute extends Attribute

Hinweise

Sie können dieses Attribut auf Assemblys anwenden, obwohl es beim Importieren einer Typbibliothek normalerweise von Type Library Importer-Tool (Tlbimp.exe) automatisch angewendet wird.

Eine Interop-Assembly enthält Metadaten, die vorhandene COM-Typen beschreiben, die häufig bereits in einer COM-Typbibliothek beschrieben sind. Tlbimp.exe erstellt Assemblys aus COM-Typbibliotheken. Interop-Assemblys enthalten i. d. R. Metadaten (keinen Code). Primäre Interop-Assemblys werden von demselben Herausgeber bereitgestellt wie die Typbibliothek, die sie beschreiben, und stellen die offiziellen Definitionen der in dieser Typbibliothek definierten Typen bereit. Primäre Interop-Assemblys werden immer vom Herausgeber signiert, um Eindeutigkeit zu gewährleisten.

Die folgenden Möglichkeiten zum Generieren einer primären Interop-Assembly aus einer Typbibliothek sind verfügbar:

Führen Sie in der Befehlszeile TlbImp.exe mit der /primary-Option aus.
Wenden Sie zur Entwurfszeit PrimaryInteropAssemblyAttribute an.

Zum Angeben einer primären Interop-Assembly in verwaltetem Quellcode müssen Sie zur Entwurfszeit System.Runtime.InteropServices.GuidAttribute und PrimaryInteropAssemblyAttribute auf die Assembly anwenden. Das GuidAttribute für die primäre Interop-Assembly gibt die LIBID der Typbibliothek an, und das PrimaryInteropAssemblyAttribute gibt die Version der bestimmten Typbibliothek an, für die diese Assembly die primäre Interop-Assembly ist. Das PrimaryInteropAssemblyAttribute kann mehrfach auftreten, wenn die Assembly die primäre Interop-Assembly für mehrere Versionen derselben Typbibliothek ist.

Verweisen Sie bei der Verwendung der in einer Typbibliothek definierten Typen immer auf die primäre Interop-Assembly für diese Typbibliothek, anstatt die Typen selbst neu zu importieren oder zu definieren. Richtlinien und Vorgehensweisen für das Erstellen und Verwenden von primären Interop-Assemblys finden Sie unter Primäre Interop-Assemblys. Eine ausführliche Beschreibung des Importvorgangs für Typbibliotheken finden Sie unter Zusammenfassung: Konvertieren einer Typbibliothek in eine Assembly.

Vererbungshierarchie

System.Object
System.Attribute
System.Runtime.InteropServices.PrimaryInteropAssemblyAttribute

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PrimaryInteropAssemblyAttribute-Member
System.Runtime.InteropServices-Namespace
GuidAttribute-Klasse

Weitere Ressourcen

Type Library Importer-Tool (Tlbimp.exe)
Primäre Interop-Assemblys

Freigeben über