Auf Englisch lesen

Teilen über


ClassInterfaceType Enumeration

Definition

Identifiziert die Art der Klassenschnittstelle, die für eine Klasse generiert wird.

C#
public enum ClassInterfaceType
C#
[System.Serializable]
public enum ClassInterfaceType
C#
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum ClassInterfaceType
Vererbung
ClassInterfaceType
Attribute

Felder

Name Wert Beschreibung
AutoDispatch 1

Gibt an, dass die Klasse nur spätes Binden für COM-Clients unterstützt. Eine dispinterface für die Klasse wird auf Anforderung automatisch für COM-Clients verfügbar gemacht. Die vom Tlbexp.exe (Type Library Exporter) erstellte Typbibliothek enthält keine Typinformationen für die dispinterface, um zu verhindern, dass Clients die DISPIDs der Schnittstelle zwischenspeichern. Bei der dispinterface treten keine der in ClassInterfaceAttribute beschriebenen Versionsprobleme auf, da für Clients nur spätes Binden an die Schnittstelle möglich ist.

Das ist die Standardeinstellung für ClassInterfaceAttribute.

AutoDual 2

Gibt an, dass für die Klasse automatisch eine duale Klassenschnittstelle generiert und für COM verfügbar gemacht wird. Für die Klassenschnittstelle werden Typinformationen erstellt und in der Typbibliothek veröffentlicht. Aufgrund der unter ClassInterfaceAttribute beschriebenen Versionseinschränkungen wird von der Verwendung von AutoDual dringend abgeraten.

None 0

Gibt an, dass für die Klasse keine Klassenschnittstelle generiert wird. Wenn keine Schnittstellen explizit implementiert werden, kann die Klasse nur Zugriff mit spätem Binden über die IDispatch-Schnittstelle bereitstellen. Dies ist die empfohlene Einstellung für ClassInterfaceAttribute. Das Verwenden von ClassInterfaceType.None ist die einzige Möglichkeit, Funktionen über Schnittstellen verfügbar zu machen, die von der Klasse explizit implementiert werden.

Tlbexp.exe (Type Library Exporter) macht die erste öffentliche, für COM sichtbare Schnittstelle verfügbar, die von der Klasse als Standardschnittstelle der Co-Klasse implementiert wird. In .NET Framework 2.0 und höher können Sie die für COM verfügbar gemachte Standardschnittstelle mithilfe des Attributs ComDefaultInterfaceAttribute angeben. Wenn die Klasse keine Schnittstellen implementiert, wird die erste öffentliche, für COM sichtbare Schnittstelle, die von der Basisklasse implementiert wird, zur Standardschnittstelle. Hierbei werden die Basisklassen beginnend bei der zuletzt abgeleiteten abwärts verarbeitet. Die Datei „Tlbexp.exe“ macht _Object als Standardschnittstelle verfügbar, wenn weder die Klasse noch die Basisklassen eine Schnittstelle implementieren.

Beispiele

In diesem Beispiel wird gezeigt, wie auf ClassInterfaceAttribute einen Typ angewendet wird, wobei festgelegt wird ClassInterfaceType. Klassen, die auf diese Weise definiert sind, können von nicht verwaltetem COM verwendet werden.

C#
using System;
using System.Runtime.InteropServices;

// Have the CLR expose a class interface (derived from IDispatch) for this type.
// COM clients can call the  members of this class using the Invoke method from the IDispatch interface.
[ClassInterface(ClassInterfaceType.AutoDispatch)]
public class AClassUsableViaCOM
{
    public AClassUsableViaCOM() { }

    public Int32 Add(Int32 x, Int32 y) { return x + y; }
}

// The CLR does not expose a class interface for this type.
// COM clients can call the members of this class using the methods from the IComparable interface.
[ClassInterface(ClassInterfaceType.None)]
public class AnotherClassUsableViaCOM : IComparable
{
    public AnotherClassUsableViaCOM() { }

    Int32 IComparable.CompareTo(Object o) { return 0; }
}

Hinweise

Diese Enumeration wird in Verbindung mit dem ClassInterfaceAttribute -Attribut verwendet.

Gilt für:

Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Weitere Informationen