ComEventInterfaceAttribute Classe

Definizione

Avviso

Questa API è ora obsoleta.

Identifica l'interfaccia di origine e la classe che implementa i metodi dell'interfaccia eventi generata quando si importa una coclasse da una libreria dei tipi COM.Identifies the source interface and the class that implements the methods of the event interface that is generated when a coclass is imported from a COM type library.

public ref class ComEventInterfaceAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Interface, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Obsolete("ComEventInterfaceAttribute may be unavailable in future releases.")]
public sealed class ComEventInterfaceAttribute : Attribute
type ComEventInterfaceAttribute = class
    inherit Attribute
Public NotInheritable Class ComEventInterfaceAttribute
Inherits Attribute
Ereditarietà
ComEventInterfaceAttribute
Attributi

Commenti

È possibile applicare questo attributo alle interfacce, anche se Tlbimp. exe (utilità di importazione della libreria dei tipi) viene in genere applicato all'utente durante l'importazione di una libreria dei tipi.You can apply this attribute to interfaces, although the Tlbimp.exe (Type Library Importer) typically applies it for you when it imports a type library.

Quando un'interfaccia di origine viene importata da una libreria dei tipi, tutti i metodi implementati vengono aggiunti come eventi a un'interfaccia eventi generata.When a source interface is imported from a type library, any methods it implements are added as events to a generated event interface. Tlbimp. exe si ComEventInterfaceAttribute applica all'interfaccia eventi per identificare la classe gestita che implementa i metodi dell'interfaccia eventi e implementa l'interfaccia di origine originale.Tlbimp.exe applies ComEventInterfaceAttribute to the event interface to identify the managed class that implements the methods of the event interface and implements the original source interface. Il Common Language Runtime utilizza questo attributo in fase di esecuzione per eseguire le attività seguenti:The common language runtime uses this attribute at run time to perform the following tasks:

  • Associare gli eventi esposti dall'interfaccia alla relativa implementazione nella classe del provider di eventi.Associate events exposed by the interface to their implementation in the event provider class.

  • Collegare gli eventi all'interfaccia di origine COM originale.Link the events to the original COM source interface.

Questo attributo viene raramente applicato.You rarely apply this attribute. Tuttavia, se si prevede di scrivere codice sorgente che produce metadati che simulano da vicino i metadati prodotti da Tlbimp. exe, è necessario creare un'interfaccia evento per ogni interfaccia di origine originale.However, if you plan to write source code that produces metadata that closely simulates metadata produced by Tlbimp.exe, you should create a event interface for each original source interface. Per una descrizione dettagliata del modo in cui Tlbimp. exe importa gli eventi, vedere conversione di membriimportati.For a detailed description about how Tlbimp.exe imports events, see Imported Member Conversion. Per istruzioni su come esporre un evento com a un client .NET, vedere procedura: Gestire gli eventi generati da un'originecom.For instruction about how to expose a COM event to a .NET client, see How to: Handle Events Raised by a COM Source.

Costruttori

ComEventInterfaceAttribute(Type, Type)

Inizializza una nuova istanza della classe ComEventInterfaceAttribute con la classe dell'interfaccia di origine e del provider di eventi.Initializes a new instance of the ComEventInterfaceAttribute class with the source interface and event provider class.

Proprietà

EventProvider

Ottiene la classe che implementa i metodi dell'interfaccia eventi.Gets the class that implements the methods of the event interface.

SourceInterface

Ottiene l'originale interfaccia di origine dalla libreria dei tipi.Gets the original source interface from the type library.

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Ereditato da Attribute)

Metodi

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Ereditato da Attribute)
GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Ereditato da Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Ereditato da Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Ereditato da Attribute)

Si applica a

Vedi anche