ComEventInterfaceAttribute Класс

Определение

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

Этот 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.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
type ComEventInterfaceAttribute = class
    inherit Attribute
Public NotInheritable Class ComEventInterfaceAttribute
Inherits Attribute
Наследование
ComEventInterfaceAttribute
Атрибуты

Комментарии

Этот атрибут можно применить к интерфейсам, хотя программа 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, используя интерфейс источника и класс поставщика событий.Initializes a new instance of the ComEventInterfaceAttribute class with the source interface and event provider class.

Свойства

EventProvider

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

SourceInterface

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

TypeId

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

(Унаследовано от Attribute)

Методы

Equals(Object)

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

(Унаследовано от Attribute)
GetHashCode()

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

(Унаследовано от Attribute)
GetType()

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

(Унаследовано от Object)
IsDefaultAttribute()

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

(Унаследовано от Attribute)
Match(Object)

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

(Унаследовано от Attribute)
MemberwiseClone()

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

(Унаследовано от Object)
ToString()

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

(Унаследовано от Object)

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

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

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

(Унаследовано от Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

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

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

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

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

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

(Унаследовано от Attribute)

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

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