ClassInterfaceAttribute 类

定义

命名空间:

System.Runtime.InteropServices

程序集:

netstandard.dll, System.Runtime.InteropServices.dll

Source:

ClassInterfaceAttribute.cs

指示在完全生成某个接口后为要向 COM 公开的类生成的类接口类型。

C#

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)]
public sealed class ClassInterfaceAttribute : Attribute

继承

Object

Attribute

ClassInterfaceAttribute

属性

AttributeUsageAttribute

示例

以下示例演示如何应用ClassInterfaceAttribute值 AutoDispatch为 生成IDispatch接口MyClass的 ClassInterfaceType 。

C#

using System.Runtime.InteropServices;

[ClassInterface(ClassInterfaceType.AutoDispatch)]
public class MyClass
{
   public MyClass() {}
}

注解

可以将此属性应用于程序集或类。

此属性控制类型库导出程序 (Tlbexp.exe) 是否自动生成特性化类的类接口。 类接口携带与类本身相同的名称，但名称带有下划线前缀。 公开时，类接口包含托管类的所有 public非 static 成员，包括从其基类继承的成员。 托管类无法访问类接口，并且无需访问，因为它们可以直接访问类成员。 Tlbexp.exe 为类接口生成唯一的接口标识符 (IID) 。

类接口可以是双接口，也可以是仅调度接口。 （可选）可以禁止生成类接口，改为提供自定义接口。 通过指定 System.Runtime.InteropServices.ClassInterfaceType 枚举成员来公开或禁止类接口。 应用于 ClassInterfaceAttribute 程序集时， 属性与程序集中的所有类相关，除非各个类使用自己的属性替代设置。

尽管类接口无需为每个类显式定义接口，但强烈建议不要在生产应用程序中使用它们。 双类接口允许客户端绑定到特定的接口布局，该布局可能会随着类的发展而更改。 例如，考虑向 COM 客户端公开类接口的托管类。 类的第一个版本包含 方法和 NorthSouth。 非托管客户端可以绑定到类接口，该接口提供 North 作为类接口中的第一个方法，将 方法 South 作为第二种方法提供。 现在考虑类的下一个版本，该类在 方法East和 South之间插入了一个新方法 North 。 尝试通过旧类接口绑定到新类的非托管客户端在打算调用 方法 East 时，最终会调用 方法 South，因为接口中方法的位置已更改。 此外，对基类布局的任何更改也会影响所有派生类的类接口布局。 直接绑定到类的托管客户端不会出现相同的版本控制问题。 有关使用类接口的具体准则，请参阅 COM 可调用包装器。

Tlbimp.exe (类型库导入程序) 始终应用于导入的ClassInterfaceType.None类枚举成员，以指示现有 COM 类永远不会公开托管接口。

构造函数

ClassInterfaceAttribute(ClassInterfaceType)	使用指定的 ClassInterfaceType 枚举成员初始化 ClassInterfaceAttribute 类的新实例。
ClassInterfaceAttribute(Int16)	使用指定的 ClassInterfaceType 枚举值初始化 ClassInterfaceAttribute 类的新实例。

属性

TypeId	在派生类中实现时，获取此 Attribute 的唯一标识符。 (继承自 Attribute)
Value	获取 ClassInterfaceType 值，该值描述应为该类生成的接口的类型。

方法

Equals(Object)	返回一个值，该值指示此实例是否与指定的对象相等。 (继承自 Attribute)
GetHashCode()	返回此实例的哈希代码。 (继承自 Attribute)
GetType()	获取当前实例的 Type。 (继承自 Object)
IsDefaultAttribute()	在派生类中重写时，指示此实例的值是否是派生类的默认值。 (继承自 Attribute)
Match(Object)	当在派生类中重写时，返回一个指示此实例是否等于指定对象的值。 (继承自 Attribute)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

适用于

另请参阅

• ClassInterfaceType
• Tlbexp.exe（类型库导出程序）
• Tlbimp.exe（类型库导入程序）