ExtensibleClassFactory 类

定义

命名空间:

System.Runtime.InteropServices

程序集:

mscorlib.dll

在创建过程中启用从非托管对象扩展的托管对象的自定义。

public ref class ExtensibleClassFactory sealed

public sealed class ExtensibleClassFactory

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class ExtensibleClassFactory

type ExtensibleClassFactory = class

[<System.Runtime.InteropServices.ComVisible(true)>]
type ExtensibleClassFactory = class

Public NotInheritable Class ExtensibleClassFactory

继承

Object

ExtensibleClassFactory

属性

ComVisibleAttribute

示例

注册一个 delegate ，每当从非托管类型扩展的托管类型的实例需要分配聚合的非托管对象时，就会调用该实例。 这 delegate 应分配和聚合非托管对象，并调用该对象代替 CoCreateInstance。 必须在将为其执行回调的 static 类的初始值设定项上下文中调用此例程。

public ref class CallBack
{
public:
   IntPtr Activate( IntPtr Aggregator )
   {
      ECFSRV32Lib::ObjectActivator^ oCOM = gcnew ECFSRV32Lib::ObjectActivator;
      ECFSRV32Lib::IObjectActivator^ itf = dynamic_cast<ECFSRV32Lib::IObjectActivator^>(oCOM);
      return (IntPtr)itf->CreateBaseComponent( (int)Aggregator );
   }
};

//
// The EcfInner class. First .NET class derived directly from COM class.
//
public ref class EcfInner: public ECFSRV32Lib::BaseComponent
{
private:
   static CallBack^ callbackInner;
   static void RegisterInner()
   {
      callbackInner = gcnew CallBack;
      System::Runtime::InteropServices::ExtensibleClassFactory::RegisterObjectCreationCallback( gcnew System::Runtime::InteropServices::ObjectCreationDelegate( callbackInner, &CallBack::Activate ) );
   }

   //This is the static initializer.    
   static EcfInner()
   {
      RegisterInner();
   }
};

using System;
using System.Runtime.InteropServices;

public class CallBack
{
   public IntPtr Activate(IntPtr Aggregator)
   {
      ECFSRV32Lib.ObjectActivator oCOM = new ECFSRV32Lib.ObjectActivator();
      ECFSRV32Lib.IObjectActivator itf = (ECFSRV32Lib.IObjectActivator)oCOM;
      return (IntPtr) itf.CreateBaseComponent((int)Aggregator);
   }
}

//
// The EcfInner class. First .NET class derived directly from COM class.
//
public class EcfInner : ECFSRV32Lib.BaseComponent
{
   static CallBack callbackInner;

   static void RegisterInner()
   {
      callbackInner = new CallBack();
      System.Runtime.InteropServices.ExtensibleClassFactory.RegisterObjectCreationCallback(new System.Runtime.InteropServices.ObjectCreationDelegate(callbackInner.Activate));
   }

   //This is the static initializer.
   static EcfInner()
   {
      RegisterInner();
   }
}

Imports System.Runtime.InteropServices

Public Class CallBack
    
    Public Function Activate(Aggregator As IntPtr) As IntPtr
        Dim oCOM As New ECFSRV32Lib.ObjectActivator()
        Dim itf As ECFSRV32Lib.IObjectActivator = _
           CType(oCOM, ECFSRV32Lib.IObjectActivator)
        Return New IntPtr(itf.CreateBaseComponent(Aggregator.ToInt32()))
    End Function
End Class

'
' The EcfInner class. First .NET class derived directly from COM class.
'
Public Class EcfInner
    Inherits ECFSRV32Lib.BaseComponent
    Private Shared callbackInner As CallBack    
    
    Shared Sub RegisterInner()
        callbackInner = New CallBack()
        ExtensibleClassFactory.RegisterObjectCreationCallback( _
           New System.Runtime.InteropServices.ObjectCreationDelegate( _
           AddressOf callbackInner.Activate))
    End Sub    
    
    'This is the static initializer.    
    Shared Sub New()
        RegisterInner()
    End Sub
End Class

注解

允许用户 ExtensibleClassFactory 指定在构造运行时可调用包装器时调用的 delegate (RCW) ，该包装器提供基础 COM 对象的实例。 实际上，回调充当 RCW 包装的 COM 对象的类工厂。 如果没有回调，公共语言运行时通过调用 CoCreateInstance创建基础 COM 对象。 此回调提供了激活基础对象的替代方法，例如通过 COM 名字对象或提供单一实例对象。 RegisterObjectCreationCallback必须在扩展 RCW 的类的初始值设定项中static调用该方法。 每个对象类型只允许一个对象创建回调。 激活可扩展 RCW 后，将注册回调。 需要创建基础 COM 对象时，将调用回调以提供对对象的引用。 回调必须返回 IUnknown 基对象的接口指针。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
RegisterObjectCreationCallback(ObjectCreationDelegate)	注册一个 delegate，每次从非托管类型扩展的托管类型的实例需要分配聚合的非托管对象时，都要调用该委托。
ToString()	返回表示当前对象的字符串。 (继承自 Object)