ExtensibleClassFactory Klasse

Definition

Namespace:

System.Runtime.InteropServices

Assembly:

mscorlib.dll

Ermöglicht die Anpassung von verwalteten Objekten, die sich während der Erstellung von nicht verwalteten Objekten erstrecken.

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

Vererbung

Object

ExtensibleClassFactory

Attribute

ComVisibleAttribute

Beispiele

Registriert ein delegate Objekt, das aufgerufen wird, wenn eine Instanz eines verwalteten Typs, die sich von einem nicht verwalteten Typ erstreckt, das aggregierte nicht verwaltete Objekt zuordnen muss. Dies delegate wird erwartet, dass das nicht verwaltete Objekt zugewiesen und aggregiert wird und anstelle eines CoCreateInstance. Diese Routine muss im Kontext des static Initialisierers für die Klasse aufgerufen werden, für die die Rückrufe vorgenommen werden.

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

Hinweise

Die ExtensibleClassFactory Benutzer können festlegen delegate , dass während der Erstellung eines laufzeitaufrufbaren Wrappers (RCW) aufgerufen wird, der eine Instanz des zugrunde liegenden COM-Objekts bereitstellt. Tatsächlich fungiert der Rückruf als Klassenfactory für das COM-Objekt, das von der RCW umbrochen wird. Ohne den Rückruf erstellt die Common Language Runtime das zugrunde liegende COM-Objekt durch Aufrufen CoCreateInstance. Dieser Rückruf bietet eine alternative Möglichkeit zum Aktivieren des zugrunde liegenden Objekts, z. B. mit einem COM-Moniker oder durch Bereitstellen eines Singleton-Objekts. Die RegisterObjectCreationCallback Methode muss im static Initialisierer der Klasse aufgerufen werden, die die RCW erweitert. Pro Objekttyp ist nur ein Objekterstellungsrückruf zulässig. Wenn der erweiterbare RCW aktiviert wird, wird der Rückruf registriert. Wenn das zugrunde liegende COM-Objekt erstellt werden muss, wird der Rückruf aufgerufen, um einen Verweis auf das Objekt bereitzustellen. Der Rückruf muss einen IUnknown Schnittstellenzeiger für das Basisobjekt zurückgeben.

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
RegisterObjectCreationCallback(ObjectCreationDelegate)	Registriert ein delegate Objekt, das aufgerufen wird, wenn eine Instanz eines verwalteten Typs, die sich von einem nicht verwalteten Typ erstreckt, das aggregierte nicht verwaltete Objekt zuordnen muss.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)