ExtensibleClassFactory Класс

Определение

Пространство имен:

System.Runtime.InteropServices

Сборка:

mscorlib.dll

Включает настройку управляемых объектов, которые расширяются от неуправляемых объектов во время создания.

public ref class ExtensibleClassFactory sealed

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

[<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-объекта. В действительности обратный вызов выступает в качестве фабрики классов для COM-объекта, завернутого RCW. Без обратного вызова среда CLR создает базовый COM-объект путем вызова CoCreateInstance. Этот обратный вызов предоставляет альтернативный способ активации базового объекта, например с моникером COM или предоставлением однотонного объекта. Метод RegisterObjectCreationCallback должен вызываться в static инициализаторе класса, расширяющего RCW. Для каждого типа объекта разрешено только один обратный вызов создания объекта. При активации расширяемого RCW обратный вызов регистрируется. При создании базового COM-объекта вызывается обратный вызов для предоставления ссылки на объект. Обратный IUnknown вызов должен вернуть указатель интерфейса для базового объекта.

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
RegisterObjectCreationCallback(ObjectCreationDelegate)	delegate Регистрирует вызываемый экземпляр управляемого типа, который расширяется от неуправляемого типа, должен выделить агрегированный неуправляемый объект.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)