Export (0) Print
Expand All

ComAwareEventInfo Class

Permits late-bound registration of an event handler.

System.Object
  System.Reflection.MemberInfo
    System.Reflection.EventInfo
      System.Runtime.InteropServices.ComAwareEventInfo

Namespace:  System.Runtime.InteropServices
Assembly:  System.Core (in System.Core.dll)

public class ComAwareEventInfo : EventInfo

The ComAwareEventInfo type exposes the following members.

  NameDescription
Public methodComAwareEventInfoInitializes a new instance of the ComAwareEventInfo class by using the specified type and a name of the event on the type.
Top

  NameDescription
Public propertyAttributesGets the attributes for this event. (Overrides EventInfo.Attributes.)
Public propertyDeclaringTypeGets the class that declares this member. (Overrides MemberInfo.DeclaringType.)
Public propertyEventHandlerTypeGets the Type object of the underlying event-handler delegate associated with this event. (Inherited from EventInfo.)
Public propertyIsMulticastGets a value indicating whether the event is multicast. (Inherited from EventInfo.)
Public propertyIsSpecialNameGets a value indicating whether the EventInfo has a name with a special meaning. (Inherited from EventInfo.)
Public propertyMemberTypeGets a MemberTypes value indicating that this member is an event. (Inherited from EventInfo.)
Public propertyMetadataTokenGets a value that identifies a metadata element. (Inherited from MemberInfo.)
Public propertyModuleGets the module in which the type that declares the member represented by the current MemberInfo is defined. (Inherited from MemberInfo.)
Public propertyNameGets the name of the current member. (Overrides MemberInfo.Name.)
Public propertyReflectedTypeGets the class object that was used to initialize this instance. (Overrides MemberInfo.ReflectedType.)
Top

  NameDescription
Public methodAddEventHandlerAttaches an event handler to a COM object. (Overrides EventInfo.AddEventHandler(Object, Delegate).)
Public methodEqualsReturns a value that indicates whether this instance is equal to a specified object. (Inherited from EventInfo.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetAddMethod()Returns the method used to add an event handler delegate to the event source. (Inherited from EventInfo.)
Public methodGetAddMethod(Boolean)Gets the method that was used to add an event handler delegate to the event source. (Overrides EventInfo.GetAddMethod(Boolean).)
Public methodGetCustomAttributes(Boolean)When overridden in a derived class, gets an array that contains all the custom attributes that are applied to this member. (Overrides MemberInfo.GetCustomAttributes(Boolean).)
Public methodGetCustomAttributes(Type, Boolean)When overridden in a derived class, gets an array that contains all the custom attributes of the specified type that are applied to this member. (Overrides MemberInfo.GetCustomAttributes(Type, Boolean).)
Public methodGetCustomAttributesDataReturns a list of CustomAttributeData objects representing data about the attributes that have been applied to the target member. (Inherited from MemberInfo.)
Public methodGetHashCodeReturns the hash code for this instance. (Inherited from EventInfo.)
Public methodGetOtherMethods()Returns the public methods that have been associated with an event in metadata using the .other directive. (Inherited from EventInfo.)
Public methodGetOtherMethods(Boolean)Returns the methods that have been associated with the event in metadata using the .other directive, specifying whether to include non-public methods. (Inherited from EventInfo.)
Public methodGetRaiseMethod()Returns the method that is called when the event is raised. (Inherited from EventInfo.)
Public methodGetRaiseMethod(Boolean)When overridden in a derived class, returns the method that was called when the event was raised. (Overrides EventInfo.GetRaiseMethod(Boolean).)
Public methodGetRemoveMethod()Returns the method used to remove an event handler delegate from the event source. (Inherited from EventInfo.)
Public methodGetRemoveMethod(Boolean)When overridden in a derived class, retrieves the MethodInfo object for removing a method of the event. (Overrides EventInfo.GetRemoveMethod(Boolean).)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodIsDefinedIndicates whether one or more instances of the specified attribute are applied to this member. (Overrides MemberInfo.IsDefined(Type, Boolean).)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodRemoveEventHandlerDetaches an event handler from a COM object. (Overrides EventInfo.RemoveEventHandler(Object, Delegate).)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

  NameDescription
Explicit interface implemetationPrivate method_EventInfo.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers. (Inherited from EventInfo.)
Explicit interface implemetationPrivate method_EventInfo.GetTypeReturns a T:System.Type object representing the EventInfo type. (Inherited from EventInfo.)
Explicit interface implemetationPrivate method_EventInfo.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface. (Inherited from EventInfo.)
Explicit interface implemetationPrivate method_EventInfo.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from EventInfo.)
Explicit interface implemetationPrivate method_EventInfo.InvokeProvides access to properties and methods exposed by an object. (Inherited from EventInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeGets a Type object representing the MemberInfo class. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface. (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from MemberInfo.)
Explicit interface implemetationPrivate method_MemberInfo.InvokeProvides access to properties and methods exposed by an object. (Inherited from MemberInfo.)
Top

Normally, compilers will automatically embed calls to the ComAwareEventInfo.AddEventHandler(Object, Delegate) and ComAwareEventInfo.RemoveEventHandler(Object, Delegate) methods instead of using regular add handler and remove handler methods for events. This occurs if the interface that the corresponding event is defined on needs to be embedded.

You can specify this by embedding the entire assembly that contains the interface by using the /link option on the compilers or by setting the Embed Interop Types property to True in Visual Studio.

The ComAwareEventInfo type derives from the EventInfo class and overrides the EventInfo.AddEventHandler(Object, Delegate) and EventInfo.RemoveEventHandler(Object, Delegate) methods.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Community Additions

ADD
Show:
© 2014 Microsoft