ComEventInterfaceAttribute ComEventInterfaceAttribute ComEventInterfaceAttribute ComEventInterfaceAttribute Class

Определение

Предупреждение

Этот API устарел.

Определяет исходный интерфейс и класс, реализующий методы интерфейса событий, созданного при импорте компонентного класса из библиотеки типов 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
Наследование
ComEventInterfaceAttributeComEventInterfaceAttributeComEventInterfaceAttributeComEventInterfaceAttribute
Атрибуты

Комментарии

Этот атрибут можно применить к интерфейсам, несмотря на то что Tlbimp.exe (программа импорта библиотек типов) обычно использует его при импортировании библиотеки типов.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.

Если исходный интерфейс импортируется из библиотеки типов, любые методы, реализующие добавляются как события в созданный интерфейс события.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 применяет ComEventInterfaceAttribute на интерфейс событий для определения управляемого класса, реализующий методы интерфейса событий и реализует исходный интерфейс источника.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. Среда CLR использует этот атрибут во время выполнения для выполнения следующих задач:The common language runtime uses this attribute at run time to perform the following tasks:

  • Связывает события, предоставляемые интерфейсом к их реализации в событии класс поставщика.Associate events exposed by the interface to their implementation in the event provider class.

  • Связывает исходный интерфейс COM источника события.Link the events to the original COM source interface.

Этот атрибут применяется редко.You rarely apply this attribute. Тем не менее если вы планируете написать исходный код, создающий метаданные, точно моделирующую создаваемые программой Tlbimp.exe, следует создать интерфейс события для каждого исходного интерфейса источника.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. Подробную информацию о том, как Tlbimp.exe импортирует события, см. в разделе преобразовании.For a detailed description about how Tlbimp.exe imports events, see Imported Member Conversion. Инструкции о том, как события COM клиенту .NET, см. в разделе как: Обработка событий, вызванных COM-источником.For instruction about how to expose a COM event to a .NET client, see How to: Handle Events Raised by a COM Source.

Конструкторы

ComEventInterfaceAttribute(Type, Type) ComEventInterfaceAttribute(Type, Type) ComEventInterfaceAttribute(Type, Type) ComEventInterfaceAttribute(Type, Type)

Инициализирует новый экземпляр класса ComEventInterfaceAttribute, используя интерфейс источника и класс поставщика событий.Initializes a new instance of the ComEventInterfaceAttribute class with the source interface and event provider class.

Свойства

EventProvider EventProvider EventProvider EventProvider

Возвращает класс, реализующий методы интерфейса события.Gets the class that implements the methods of the event interface.

SourceInterface SourceInterface SourceInterface SourceInterface

Возвращает исходный интерфейс источника из библиотеки типов.Gets the original source interface from the type library.

TypeId TypeId TypeId TypeId

При реализации в производном классе возвращает уникальный идентификатор для этого Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Возвращает хэш-код для данного экземпляра.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

При переопределении в производном классе показывает, является ли значение данного экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Явные реализации интерфейса

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

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые могут использоваться для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Применяется к

Дополнительно