PrimaryInteropAssemblyAttribute 類別

定義

表示使用屬性組件 (Assembly) 為主要 Interop 組件。Indicates that the attributed assembly is a primary interop assembly.

public ref class PrimaryInteropAssemblyAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=true, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
public sealed class PrimaryInteropAssemblyAttribute : Attribute
type PrimaryInteropAssemblyAttribute = class
    inherit Attribute
Public NotInheritable Class PrimaryInteropAssemblyAttribute
Inherits Attribute
繼承
PrimaryInteropAssemblyAttribute
屬性

備註

雖然tlbimp.exe (類型程式庫匯入工具)通常會在匯入類型程式庫時套用此屬性,但您可以將此屬性套用至元件。You can apply this attribute to assemblies, although the Tlbimp.exe (Type Library Importer) typically applies it for you when it imports a type library.

Interop 元件包含的中繼資料會描述現有的 COM 類型,這些型別通常已經在 COM 類型程式庫中描述過。An interop assembly contains metadata that describes existing COM types, which are often already described in a COM type library. Tlbimp.exe 會從 COM 類型程式庫產生 interop 元件。Tlbimp.exe produces interop assemblies from COM type libraries. Interop 元件通常只包含中繼資料(沒有程式碼)。Interop assemblies typically only contain metadata (no code). 主要 interop 元件是由與它們所描述之類型程式庫相同的發行者所提供,並提供使用該類型程式庫所定義之類型的官方定義。Primary interop assemblies are provided by the same publisher as the type library they describe, and provide the official definitions of the types defined with that type library. 主要 interop 元件一律由其發行者簽署,以確保其唯一性。Primary interop assemblies are always signed by their publisher to ensure uniqueness.

您可以透過下列方式,從類型程式庫產生主要 interop 元件:You can generate a primary interop assembly from a type library in the following ways:

若要在 managed 原始程式碼中指定主要 interop 元件,您必須在設計階段將 System.Runtime.InteropServices.GuidAttributePrimaryInteropAssemblyAttribute 套用至元件。To specify a primary interop assembly in managed source code, you must apply the System.Runtime.InteropServices.GuidAttribute and PrimaryInteropAssemblyAttribute to the assembly at design time. 主要 interop 元件上的 GuidAttribute 會識別類型程式庫的 LIBID,而 PrimaryInteropAssemblyAttribute 會識別此元件為主要 interop 元件之特定類型程式庫的版本。The GuidAttribute on the primary interop assembly identifies the LIBID of the type library and the PrimaryInteropAssemblyAttribute identifies the version of the particular type library for which this assembly is the primary interop assembly. 如果元件是相同類型程式庫之多個版本的主要 interop 元件,則 PrimaryInteropAssemblyAttribute 可以出現多次。The PrimaryInteropAssemblyAttribute can appear multiple times if the assembly is the primary interop assembly for multiple versions of the same type library.

使用類型程式庫中定義的類型時,請一律參考該類型程式庫的主要 interop 元件,而不是重新匯入或重新定義類型本身。When using the types defined in a type library, always reference the primary interop assembly for that type library, rather than reimporting or redefining the types themselves. 如需如何產生或使用主要 interop 元件的指導方針和程式,請參閱主要 Interop 元件For guidelines and procedures on how to produce or use primary interop assemblies, see Primary Interop Assemblies. 如需類型程式庫匯入程式的詳細描述,請參閱類型程式庫至元件轉換的摘要For a detailed description of the type library importing process, see Type Library to Assembly Conversion Summary.

建構函式

PrimaryInteropAssemblyAttribute(Int32, Int32)

使用組件為主要 Interop 組件的型別程式庫主要和次要版本號碼,初始化 PrimaryInteropAssemblyAttribute 類別的新執行個體。Initializes a new instance of the PrimaryInteropAssemblyAttribute class with the major and minor version numbers of the type library for which this assembly is the primary interop assembly.

屬性

MajorVersion

取得型別程式庫主要版本號碼,其中的組件為主要 Interop 組件。Gets the major version number of the type library for which this assembly is the primary interop assembly.

MinorVersion

取得型別程式庫次要版本號碼,其中的組件為主要 Interop 組件。Gets the minor version number of the type library for which this assembly is the primary interop assembly.

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)

適用於

另請參閱