ClassInterfaceAttribute Sınıf

Tanım

public ref class ClassInterfaceAttribute sealed : Attribute

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

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

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)>]
type ClassInterfaceAttribute = class
    inherit Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ClassInterfaceAttribute = class
    inherit Attribute

Public NotInheritable Class ClassInterfaceAttribute
Inherits Attribute

Devralma

Object

Attribute

ClassInterfaceAttribute

Öznitelikler

AttributeUsageAttribute ComVisibleAttribute

Örnekler

Aşağıdaki örnek için bir IDispatch arabirim MyClassoluşturan değeriyle AutoDispatchClassInterfaceType uygulamasının nasıl yapılacağını ClassInterfaceAttribute gösterir.

using namespace System::Runtime::InteropServices;

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

};

using System.Runtime.InteropServices;

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

Imports System.Runtime.InteropServices

<ClassInterface(ClassInterfaceType.AutoDispatch)> _
Public Class SampleClass    
    ' Insert class members here.
End Class

Açıklamalar

Bu özniteliği derlemelere veya sınıflara uygulayabilirsiniz.

Bu öznitelik, Tür Kitaplığı Dışarı Aktarıcısı'nın (Tlbexp.exe) öznitelikli sınıf için otomatik olarak bir sınıf arabirimi oluşturup oluşturmadığını denetler. Sınıf arabirimi, sınıfın kendisiyle aynı adı taşır, ancak adın önüne bir alt çizgi eklenir. Kullanıma sunulduğunda, sınıf arabirimi, temel sınıfından publicdevralınan üyeler de dahil olmak üzere yönetilen sınıfın tüm , olmayan static üyelerini içerir. Yönetilen sınıflar bir sınıf arabirimine erişemez ve sınıf üyelerine doğrudan erişebilecekleri için buna gerek yoktur. Tlbexp.exe, sınıf arabirimi için benzersiz bir arabirim tanımlayıcısı (IID) oluşturur.

Sınıf arabirimleri çift veya yalnızca dağıtım arabirimleri olabilir. İsteğe bağlı olarak, sınıf arabiriminin oluşturulmasını gizleyebilir ve bunun yerine özel bir arabirim sağlayabilirsiniz. Bir numaralandırma üyesi belirterek System.Runtime.InteropServices.ClassInterfaceType bir sınıf arabirimini kullanıma sunar veya gizlersiniz. Bir derlemeye uyguladığınızda ClassInterfaceAttribute , tek tek sınıflar ayarı kendi öznitelikleriyle geçersiz kılmadığı sürece özniteliği bütünleştirilmiş koddaki tüm sınıflarla ilişkilidir.

Sınıf arabirimleri her sınıf için arabirimleri açıkça tanımlama görevini ortadan kaldırsa da, üretim uygulamalarında kullanımları kesinlikle önerilmez. İkili sınıf arabirimleri, istemcilerin sınıf geliştikçe değişikliğe tabi olan belirli bir arabirim düzenine bağlanmasına olanak tanır. Örneğin, com istemcileri için bir sınıf arabirimini kullanıma sunan yönetilen bir sınıf düşünün. sınıfının ilk sürümü ve Southyöntemlerini North içerir. Yönetilmeyen bir istemci, sınıf arabiriminde ilk yöntemi ve ikinci yöntem olarak yöntemi South sağlayan North sınıf arabirimine bağlanabilir. Şimdi ve yöntemleri NorthSoutharasına eklenen yeni bir yöntemi Eastolan sınıfının sonraki sürümünü düşünün. Eski sınıf arabirimi aracılığıyla yeni sınıfa bağlanmaya çalışan yönetilmeyen istemciler, yöntemini çağırmayı East amaçladığında yöntemini çağırır Southçünkü arabirim içindeki yöntemlerin konumlandırılması değişmiştir. Ayrıca, bir temel sınıfın düzeninde yapılan tüm değişiklikler, türetilmiş tüm sınıflar için sınıf arabiriminin düzenini de etkiler. Doğrudan sınıflara bağlanan yönetilen istemciler, aynı sürüm oluşturma sorunlarını sergilemez. Sınıf arabirimi kullanmayla ilgili belirli yönergeler için bkz. COM Çağrılabilen Sarmalayıcı.

Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcısı), mevcut COM sınıflarının yönetilen arabirimleri hiçbir zaman kullanıma sunmadığını belirtmek için numaralandırma üyesi içeri aktarılan sınıflar ClassInterfaceType.None için her zaman geçerlidir.

Oluşturucular

Özellikler

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• ClassInterfaceType
• Tlbexp.exe (Tür Kitaplığı Dışarı Aktarıcı)
• Tlbimp.exe (Tür Kitaplığı İçeri Aktarıcı)