ClassInterfaceAttribute Klasse

Definition

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)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ClassInterfaceAttribute : Attribute

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

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

Public NotInheritable Class ClassInterfaceAttribute
Inherits Attribute

Vererbung

Object

Attribute

ClassInterfaceAttribute

Attribute

AttributeUsageAttribute ComVisibleAttribute

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

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

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