ComEventInterfaceAttribute 類別

定義

警告

此 API 現已淘汰。

識別來源介面,以及實作事件介面 (從 COM 類型程式庫匯入 Coclass 時所產生) 之方法的類別。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
繼承
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 套用至事件介面,以識別實作用事件介面之方法並執行原始來源介面的 managed 類別。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. Common language runtime 會在執行時間使用這個屬性來執行下列工作: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()

取得目前執行個體的 TypeGets 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)

將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。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)

適用於

另請參閱