ClassInterfaceType Výčet

  • Reference

Definice

Obor názvů:
System.Runtime.InteropServices
Sestavení:
System.Runtime.InteropServices.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Identifikuje typ rozhraní třídy, který je generován pro třídu.

public enum class ClassInterfaceType
public enum ClassInterfaceType
[System.Serializable]
public enum ClassInterfaceType
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum ClassInterfaceType
type ClassInterfaceType = 
[<System.Serializable>]
type ClassInterfaceType = 
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ClassInterfaceType = 
Public Enum ClassInterfaceType
Dědičnost
Object
ValueType
Enum
ClassInterfaceType
Atributy
SerializableAttribute ComVisibleAttribute

Pole

AutoDispatch 1

Označuje, že třída podporuje pouze pozdní vazbu pro klienty com. Třída dispinterface je na vyžádání automaticky zpřístupněna klientům com. Knihovna typů vytvořená nástrojem Tlbexp.exe (Type Library Exporter) neobsahuje informace o typu pro dispinterface , aby se zabránilo klientům v ukládání dispidů rozhraní do mezipaměti. Objekt dispinterface nevykazuje problémy správy verzí popsané v ClassInterfaceAttribute části , protože klienti mohou s rozhraním provádět pouze pozdní vazbu.

Toto je výchozí nastavení pro ClassInterfaceAttribute.

AutoDual 2

Označuje, že rozhraní duální třídy je automaticky vygenerováno pro třídu a vystaveno modelu COM. Informace o typu jsou vytvořeny pro rozhraní třídy a publikovány v knihovně typů. Použití AutoDual se důrazně nedoporučuje kvůli omezením správy verzí popsaným v ClassInterfaceAttributetématu .
None 0

Označuje, že pro třídu není generováno žádné rozhraní třídy. Pokud nejsou explicitně implementována žádná rozhraní, může třída poskytovat přístup pouze s pozdní vazbou IDispatch prostřednictvím rozhraní. Toto je doporučené nastavení pro ClassInterfaceAttribute. Použití ClassInterfaceType.None je jediný způsob, jak zpřístupnit funkce prostřednictvím rozhraní implementovaných explicitně třídou .

Tlbexp.exe (exportér knihovny typů) zveřejňuje první veřejné rozhraní viditelné objektem COM implementované třídou jako výchozí rozhraní třídy coclass. V rozhraní .NET Framework 2.0 a novějších verzích můžete určit výchozí rozhraní vystavené modelu COM pomocí atributu ComDefaultInterfaceAttribute . Pokud třída neimplementuje žádná rozhraní, první veřejné rozhraní viditelné modelu COM implementované základní třídou se stane výchozím rozhraním (počínaje nejnovější odvozenou základní třídou a pracuje zpět). Tlbexp.exe zpřístupňuje _Object jako výchozí rozhraní, pokud třída ani její základní třídy neimplementují rozhraní.

Příklady

Tento příklad ukazuje, jak použít ClassInterfaceAttribute na typ a nastavit .ClassInterfaceType Třídy definované tímto způsobem lze použít z nespravovaného modelu COM.

using namespace System;
using namespace 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 ref class AClassUsableViaCOM
{
public:
    AClassUsableViaCOM() 
    { 
    }

public:
    int Add(int x, int 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 ref class AnotherClassUsableViaCOM : public IComparable
{
public:
    AnotherClassUsableViaCOM() 
    { 
    }

    virtual int CompareTo(Object^ o) = IComparable::CompareTo
    {
        return 0;
    }
};

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; }
}

Imports 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 Sub New()

    End Sub

    Public Function Add(ByVal x As Int32, ByVal y As Int32) As Int32
        Return x + y

    End Function
End Class
' 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
    Implements IComparable

    Public Sub New()

    End Sub

    Function CompareTo(ByVal o As [Object]) As Int32 Implements IComparable.CompareTo
        Return 0

    End Function 'IComparable.CompareTo
End Class

Poznámky

Tento výčet se používá ve spojení s atributem ClassInterfaceAttribute .

Platí pro

Viz také