PrimaryInteropAssemblyAttribute-Klasse

 

Veröffentlicht: Oktober 2016

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

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

Vererbungshierarchie

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

Syntax

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

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

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false,
    AllowMultiple = true)>]
[<ComVisibleAttribute(true)>]
type PrimaryInteropAssemblyAttribute = 
    class
        inherit Attribute
    end

<AttributeUsageAttribute(AttributeTargets.Assembly, Inherited := False,
    AllowMultiple := True)>
<ComVisibleAttribute(True)>
Public NotInheritable Class PrimaryInteropAssemblyAttribute
    Inherits Attribute

Konstruktoren

	Name	Beschreibung
	PrimaryInteropAssemblyAttribute(Int32, Int32)	Initialisiert eine neue Instanz der PrimaryInteropAssemblyAttribute -Klasse mit der Haupt-und Nebenversionsnummer der Typbibliothek, für die diese Assembly die primäre Interop-Assembly ist.

Eigenschaften

	Name	Beschreibung
	MajorVersion	Ruft die Hauptversionsnummer der Typbibliothek, für die diese Assembly die primäre Interop-Assembly ist.
	MinorVersion	Ruft die Nebenversionsnummer der Typbibliothek, für die diese Assembly die primäre Interop-Assembly ist.
	TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab.(Geerbt von „Attribute“.)

Methoden

	Name	Beschreibung
	Equals(Object)	Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.(Geerbt von „Attribute“.)
	GetHashCode()	Gibt den Hashcode für diese Instanz zurück.(Geerbt von „Attribute“.)
	GetType()	Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)
	IsDefaultAttribute()	Gibt beim Überschreiben in einer abgeleiteten Klasse an, ob der Wert der Instanz der Standardwert für die abgeleitete Klasse ist.(Geerbt von „Attribute“.)
	Match(Object)	Ruft beim Überschreiben in einer abgeleiteten Klasse gibt einen Wert, der angibt, ob diese Instanz gleich ein angegebenen Objekt ist.(Geerbt von „Attribute“.)
	ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Ordnet eine Reihe von Namen einer entsprechenden Reihe von Dispatchbezeichnern zu.(Geerbt von „Attribute“.)
	_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Ruft die Typinformationen für ein Objekt ab, mit deren Hilfe die Typinformationen für eine Schnittstelle abgerufen werden können.(Geerbt von „Attribute“.)
	_Attribute.GetTypeInfoCount(UInt32)	Ruft die Anzahl der Schnittstellen mit Typinformationen ab, die von einem Objekt bereitgestellt werden (0 oder 1).(Geerbt von „Attribute“.)
	_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Stellt den Zugriff auf von einem Objekt verfügbar gemachte Eigenschaften und Methoden bereit.(Geerbt von „Attribute“.)

Hinweise

Sie können dieses Attribut auf Assemblys anwenden, obwohl die Tlbimp.exe (Type Library Importer) in der Regel für Sie gilt, wenn es sich um eine Typbibliothek importiert.

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. nur Metadaten (keinen Code). Primäre Interop-Assemblys werden von demselben Herausgeber der Typbibliothek bereitgestellt, die Sie beschreiben, die und geben Sie die offiziellen Definitionen der definierten Typen in dieser Typbibliothek. Primäre Interop-Assemblys werden immer vom Herausgeber signiert, um Eindeutigkeit zu gewährleisten.

Sie können eine primäre Interop-Assembly aus einer Typbibliothek in der folgenden Arten generieren:

• Führen Sie TlbImp.exe mit der /primary Option von der Befehlszeile aus.

• Anwenden der PrimaryInteropAssemblyAttribute zur Entwurfszeit.

Um eine primäre Interop-Assembly in verwaltetem Quellcode angeben, gilt die System.Runtime.InteropServices.GuidAttribute und PrimaryInteropAssemblyAttribute auf die Assembly zur Entwurfszeit. Die GuidAttribute für die primäre Interop-Assembly gibt die LIBID der Typbibliothek und der PrimaryInteropAssemblyAttribute Gibt die Version der bestimmten Typbibliothek für die diese Assembly die primäre Interop-Assembly ist. Die PrimaryInteropAssemblyAttribute kann mehrfach auftreten, wenn die Assembly die primäre Interop-Assembly für mehrere Versionen derselben Typbibliothek ist.

Wenn Sie die in einer Typbibliothek definierten Typen verwenden, immer verweisen Sie die primäre Interop-Assembly für diese Typbibliothek, anstatt Importieren oder Neudefinieren der Typen sich selbst. Richtlinien und Verfahren zum Erstellen und Verwenden von primären Interop-Assemblys finden Sie unter Primary Interop Assemblies. Eine ausführliche Beschreibung der Importvorgang Typbibliothek, finden Sie unter Type Library to Assembly Konvertierung: Zusammenfassung.

Versionsinformationen

.NET Framework
Verfügbar seit 1.1

Threadsicherheit

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Siehe auch

GuidAttribute
System.Runtime.InteropServices-Namespace
Tlbimp.exe (Type Library Importer)
Primäre Interop-Assemblys

Zurück zum Anfang