Classe ComSourceInterfacesAttribute

Artigo
04/16/2018

Publicado: agosto de 2016

Dica

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Identifica uma lista de interfaces que são expostas como origens de evento COM para a classe atribuída.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (em mscorlib.dll)

Hierarquia de Herança

System.Object
System.Attribute
System.Runtime.InteropServices.ComSourceInterfacesAttribute

Sintaxe

[AttributeUsageAttribute(AttributeTargets.Class, Inherited = true)]
[ComVisibleAttribute(true)]
public sealed class ComSourceInterfacesAttribute : Attribute

[AttributeUsageAttribute(AttributeTargets::Class, Inherited = true)]
[ComVisibleAttribute(true)]
public ref class ComSourceInterfacesAttribute sealed : Attribute

[<Sealed>]
[<AttributeUsageAttribute(AttributeTargets.Class, Inherited = true)>]
[<ComVisibleAttribute(true)>]
type ComSourceInterfacesAttribute = 
    class
        inherit Attribute
    end

<AttributeUsageAttribute(AttributeTargets.Class, Inherited := True)>
<ComVisibleAttribute(True)>
Public NotInheritable Class ComSourceInterfacesAttribute
    Inherits Attribute

Construtores

	Nome	Descrição
	ComSourceInterfacesAttribute(String)	Inicializa uma nova instância da classe ComSourceInterfacesAttribute com o nome da interface de origem do evento.
	ComSourceInterfacesAttribute(Type)	Inicializa uma nova instância da classe ComSourceInterfacesAttribute com o tipo a ser usado como interface de origem.
	ComSourceInterfacesAttribute(Type, Type)	Inicializa uma nova instância da classe ComSourceInterfacesAttribute com os tipos a serem usados como interfaces de origem.
	ComSourceInterfacesAttribute(Type, Type, Type)	Inicializa uma nova instância da classe ComSourceInterfacesAttribute com os tipos a serem usados como interfaces de origem.
	ComSourceInterfacesAttribute(Type, Type, Type, Type)	Inicializa uma nova instância da classe ComSourceInterfacesAttribute com os tipos a serem usados como interfaces de origem.

Propriedades

	Nome	Descrição
	TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute.(Herdado de Attribute.)
	Value	Obtém o nome totalmente qualificado da interface de origem do evento.

Métodos

	Nome	Descrição
	Equals(Object)	Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Retorna um valor que indica se essa instância é igual a um objeto especificado.(Herdado de Attribute.)
	GetHashCode()	Retorna o código hash para essa 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.)
	ToString()	Retorna uma cadeia de caracteres que representa o objeto atual.(Herdado de Object.)

Implementações Explícitas da Interface

	Nome	Descrição
	_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.)

Comentários

Você pode aplicar esse atributo para classes.

Esse atributo é aplicado a uma classe gerenciada para identificar as interfaces de evento que a classe expõe como pontos de conexão de COM. Uma interface de evento contém métodos que são mapeados para os membros de evento da classe. O nome de classe de evento e o nome do método de interface devem ser os mesmos. Esse atributo pode acomodar até quatro interfaces de origem para uma classe, passando o tipo de interface de origem para o construtor apropriado, o que levar entre um e quatro argumentos de tipo. Para classes que deseja expor mais de quatro interfaces de origem, a versão de cadeia de caracteres do construtor pode ser usada. Para obter informações adicionais sobre os eventos de exposing.NET para clientes COM, consulte como: gerar eventos manipulados por um coletor COM.

Exemplos

O exemplo a seguir mostra como aplicar o ComSourceInterfacesAttribute para conectar-se a interface do coletor de eventos para uma classe, passando a interface do coletor de evento e de namespace.

using System.Runtime.InteropServices;

[ComSourceInterfacesAttribute("ButtonEventsLib.ButtonEvents, ButtonEventsLib")]
public class Baz 
{
   //Insert code here.
}

Imports System.Runtime.InteropServices

<ComSourceInterfacesAttribute("ButtonEventsLib.ButtonEvents, ButtonEventsLib")> _
public Class Baz
    'Insert code here.
End Class

using namespace System::Runtime::InteropServices;

[ComSourceInterfacesAttribute("ButtonEventsLib.ButtonEvents, ButtonEventsLib")]
public ref class Baz{};

Informações de Versão

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Windows Phone
Disponível desde 8.1

Acesso thread-safe

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Confira Também

Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via