ClassInterfaceAttribute Klasse

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Quelle:

ClassInterfaceAttribute.cs

Gibt die Art der Klassenschnittstelle an, die für eine für COM verfügbar gemachte Klasse generiert werden soll (sofern überhaupt eine Schnittstelle generiert wird).

public ref class ClassInterfaceAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)]
public sealed class ClassInterfaceAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)>]
type ClassInterfaceAttribute = class
    inherit Attribute

Public NotInheritable Class ClassInterfaceAttribute
Inherits Attribute

Vererbung

Object

Attribute

ClassInterfaceAttribute

Attribute

AttributeUsageAttribute

Beispiele

Im folgenden Beispiel wird gezeigt, wie mit dem ClassInterfaceType -Wert AutoDispatchangewendet ClassInterfaceAttribute wird, der eine IDispatch Schnittstelle für MyClassgeneriert.

using namespace System::Runtime::InteropServices;

[ClassInterface(ClassInterfaceType::AutoDispatch)]
public ref class MyClass
{
public:
   MyClass(){}

};

using System.Runtime.InteropServices;

[ClassInterface(ClassInterfaceType.AutoDispatch)]
public class MyClass
{
   public MyClass() {}
}

Imports System.Runtime.InteropServices

<ClassInterface(ClassInterfaceType.AutoDispatch)> _
Public Class SampleClass    
    ' Insert class members here.
End Class

Hinweise

Sie können dieses Attribut auf Assemblys oder Klassen anwenden.

Dieses Attribut steuert, ob der Typbibliotheksexportierer (Tlbexp.exe) automatisch eine Klassenschnittstelle für die attributierte Klasse generiert. Eine Klassenschnittstelle trägt den gleichen Namen wie die Klasse selbst, aber dem Namen wird ein Unterstrich vorangestellt. Wenn sie verfügbar gemacht wird, enthält die Klassenschnittstelle alle publicNichtmember static der verwalteten Klasse, einschließlich membern, die von ihrer Basisklasse geerbt wurden. Verwaltete Klassen können nicht auf eine Klassenschnittstelle zugreifen und müssen nicht, da sie direkt auf die Klassenmember zugreifen können. Tlbexp.exe generiert einen eindeutigen Schnittstellenbezeichner (Unique Interface Identifier, IID) für die Klassenschnittstelle.

Klassenschnittstellen können duale Schnittstellen oder reine Dispatchschnittstellen sein. Optional können Sie die Generierung der Klassenschnittstelle unterdrücken und stattdessen eine benutzerdefinierte Schnittstelle bereitstellen. Sie machen eine Klassenschnittstelle verfügbar oder unterdrücken sie, indem Sie einen Enumerationsmember System.Runtime.InteropServices.ClassInterfaceType angeben. Wenn Sie auf eine Assembly anwenden ClassInterfaceAttribute , bezieht sich das Attribut auf alle Klassen in der Assembly, es sei denn, die einzelnen Klassen überschreiben die Einstellung mit einem eigenen Attribut.

Klassenschnittstellen vermeiden zwar die explizite Definition von Schnittstellen für jede Klasse, von deren Verwendung in Produktionsanwendungen wird jedoch dringend abgeraten. Duale Klassenschnittstellen ermöglichen Es Clients, eine Bindung an ein bestimmtes Schnittstellenlayout zu binden, das sich bei der Weiterentwicklung der Klasse ändern kann. Betrachten Sie beispielsweise eine verwaltete Klasse, die eine Klassenschnittstelle für COM-Clients verfügbar macht. Die erste Version der -Klasse enthält Methoden North und South. Ein nicht verwalteter Client kann eine Bindung an die Klassenschnittstelle herstellen, die als erste Methode in der Klassenschnittstelle und South als zweite Methode bereitstelltNorth. Sehen Sie sich nun die nächste Version der -Klasse an, die über eine neue Methode ( ) verfügt, Eastdie zwischen Methoden North und Southeingefügt wird. Nicht verwaltete Clients, die versuchen, über die alte Klassenschnittstelle an die neue Klasse zu binden, rufen die Methode East auf, wenn sie die Methode Southaufrufen möchten, da sich die Positionierung von Methoden innerhalb der Schnittstelle geändert hat. Darüber hinaus wirkt sich jede Änderung am Layout einer Basisklasse auch auf das Layout der Klassenschnittstelle für alle abgeleiteten Klassen aus. Verwaltete Clients, die direkt an Klassen gebunden sind, weisen nicht die gleichen Versionsverwaltungsprobleme auf. Spezifische Richtlinien zur Verwendung einer Klassenschnittstelle finden Sie unter COM Callable Wrapper.

Der Tlbimp.exe (Type Library Importer) gilt immer für importierte Klassen, die als ClassInterfaceType.None Enumerationsmember verwendet werden, um anzugeben, dass vorhandene COM-Klassen niemals verwaltete Schnittstellen verfügbar machen.

Konstruktoren

ClassInterfaceAttribute(ClassInterfaceType)	Initialisiert eine neue Instanz der ClassInterfaceAttribute-Klasse mit dem angegebenen ClassInterfaceType-Enumerationsmember.
ClassInterfaceAttribute(Int16)	Initialisiert eine neue Instanz der ClassInterfaceAttribute-Klasse mit dem angegebenen ClassInterfaceType-Enumerationswert.

Eigenschaften

TypeId	Ruft bei Implementierung in einer abgeleiteten Klasse einen eindeutigen Bezeichner für dieses Attribute ab. (Geerbt von Attribute)
Value	Ruft den ClassInterfaceType-Wert ab, der beschreibt, welcher Schnittstellentyp für die Klasse generiert werden soll.

Methoden

Equals(Object)	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)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert zurückgegeben, der angibt, ob diese Instanz einem bestimmten Objekt entspricht. (Geerbt von Attribute)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• ClassInterfaceType
• Tlbexp.exe (Type Library Exporter-Tool)
• Tlbimp.exe (Type Library Importer-Tool)