ClassInterfaceType Enumeração

Definição

Espaço de Nomes:
System.Runtime.InteropServices
Assemblagens:
mscorlib.dll, System.Runtime.InteropServices.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Runtime.InteropServices.dll
Assemblagem:
netstandard.dll

Identifica o tipo de interface de classe que é gerada para uma classe.

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
Herança
Object
ValueType
Enum
ClassInterfaceType
Atributos
SerializableAttribute ComVisibleAttribute

Campos

Name Valor Description
None 0

Indica que não é gerada nenhuma interface de classe para a classe. Se nenhuma interface for implementada explicitamente, a classe só pode fornecer acesso com limite tardio através da IDispatch interface. Esta é a configuração recomendada para ClassInterfaceAttribute. Usar ClassInterfaceType.None é a única forma de expor funcionalidades através de interfaces implementadas explicitamente pela classe.

Tlbexp.exe (Type Library Exporter) expõe a primeira interface pública, visível em COM, implementada pela classe como a interface padrão da coclasse. No .NET Framework 2.0 e versões posteriores, pode especificar a interface padrão exposta ao COM usando o atributo ComDefaultInterfaceAttribute. Se a classe não implementar interfaces, a primeira interface pública, COM-visível, implementada por uma classe base torna-se a interface padrão (começando pela classe base mais recentemente derivada e trabalhando para trás). Tlbexp.exe expõe-se _Object como interface padrão se nem a classe nem as suas classes base implementarem interfaces.
AutoDispatch 1

Indica que a classe só suporta binding tardio para clientes COM. A dispinterface para a disciplina é automaticamente exposta a clientes COM mediante pedido. A biblioteca de tipos produzida pelo Tlbexp.exe (Type Library Exporter) não contém informação de tipo para o dispinterface , de modo a impedir que os clientes armazenem em cache os DISPIDs da interface. Não dispinterface apresenta os problemas de versionamento descritos em ClassInterfaceAttribute porque os clientes só conseguem ligar tardiamente à interface.

Esta é a definição padrão para ClassInterfaceAttribute.

AutoDual 2

Indica que uma interface de duas classes é automaticamente gerada para a classe e exposta ao COM. A informação de tipos é produzida para a interface de classes e publicada na biblioteca de tipos. A utilização AutoDual é fortemente desencorajada devido às limitações de versionamento descritas em ClassInterfaceAttribute.

Exemplos

Este exemplo mostra como aplicar o ClassInterfaceAttribute a um tipo, definindo o ClassInterfaceType. As classes definidas desta forma podem ser usadas a partir do COM não gerido.

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

Observações

Esta enumeração é usada em conjunto com o ClassInterfaceAttribute atributo.

Aplica-se a

Ver também