ComEventInterfaceAttribute Classe

Referência

Definição

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cuidado

ComEventInterfaceAttribute may be unavailable in future releases.

Identifica a interface de origem e a classe que implementa os métodos da interface do evento é gerado quando uma coclass é importada de uma biblioteca de tipos COM.

public ref class ComEventInterfaceAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)]
[System.Obsolete("ComEventInterfaceAttribute may be unavailable in future releases.")]
public sealed class ComEventInterfaceAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)]
public sealed class ComEventInterfaceAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ComEventInterfaceAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)>]
[<System.Obsolete("ComEventInterfaceAttribute may be unavailable in future releases.")>]
type ComEventInterfaceAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)>]
type ComEventInterfaceAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ComEventInterfaceAttribute = class
    inherit Attribute

Public NotInheritable Class ComEventInterfaceAttribute
Inherits Attribute

Herança: Object

Attribute
ComEventInterfaceAttribute

Atributos: AttributeUsageAttribute ObsoleteAttribute ComVisibleAttribute

Comentários

Você pode aplicar esse atributo a interfaces, embora o Tlbimp.exe (Importador de Biblioteca de Tipos) normalmente o aplique para você quando importa uma biblioteca de tipos.

Quando uma interface de origem é importada de uma biblioteca de tipos, todos os métodos implementados são adicionados como eventos a uma interface de evento gerada. Tlbimp.exe se aplica ComEventInterfaceAttribute à interface do evento para identificar a classe gerenciada que implementa os métodos da interface do evento e implementa a interface de origem original. O common language runtime usa esse atributo em tempo de execução para executar as seguintes tarefas:

Associar eventos expostos pela interface à sua implementação na classe de provedor de eventos.
Vincule os eventos à interface de origem COM original.

Você raramente aplica esse atributo. No entanto, se você planeja escrever o código-fonte que produz metadados que simulam de perto metadados produzidos por Tlbimp.exe, crie uma interface de evento para cada interface de origem original. Para obter uma descrição detalhada sobre como Tlbimp.exe importa eventos, consulte Conversão de Membro Importada. Para obter instruções sobre como expor um evento COM a um cliente .NET, consulte Como lidar com eventos gerados por uma fonte COM.

Construtores

ComEventInterfaceAttribute(Type, Type)

Inicializa uma nova instância da classe ComEventInterfaceAttribute com a interface de origem e a classe do provedor especificados.

Propriedades

EventProvider	Obtém a classe que implementa os métodos da interface do evento.
SourceInterface	Obtém a interface de origem original da biblioteca de tipos.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição. (Herdado de Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	Recupera as informações de tipo para um objeto, que pode ser usado para obter as informações de tipo para uma interface. (Herdado de Attribute)
_Attribute.GetTypeInfoCount(UInt32)	Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1). (Herdado de Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Fornece acesso a propriedades e métodos expostos por um objeto. (Herdado de Attribute)

Aplica-se a

Confira também

Tlbimp.exe (Importador de Biblioteca de Tipos)