RemotingConfiguration.RegisterActivatedClientType Methode

public:
 static void RegisterActivatedClientType(System::Runtime::Remoting::ActivatedClientTypeEntry ^ entry);

public static void RegisterActivatedClientType (System.Runtime.Remoting.ActivatedClientTypeEntry entry);

static member RegisterActivatedClientType : System.Runtime.Remoting.ActivatedClientTypeEntry -> unit

Public Shared Sub RegisterActivatedClientType (entry As ActivatedClientTypeEntry)

Parameter

Ausnahmen

Hinweise

Um eine Instanz eines clientaktivierten Objekts auf dem Server zu erstellen, müssen Sie dessen Type kennen, und es muss auf dem Serverende mit der RegisterActivatedServiceType -Methode registriert werden. Um einen Proxy für eine neue Instanz des vom Client aktivierten Objekts abzurufen, muss der Client zuerst einen Kanal bei ChannelServices registrieren und dann das -Objekt aktivieren, indem er aufruft new.

Um einen clientaktivierbaren Objekttyp mit dem new Schlüsselwort zu aktivieren, müssen Sie zuerst den Objekttyp auf dem Clientende mithilfe der RegisterActivatedClientType -Methode registrieren. Beim Aufrufen der RegisterActivatedClientType -Methode erhält die Remotinginfrastruktur den Speicherort der Remoteanwendung, an der new versucht wird, sie zu erstellen. Wenn Sie hingegen die Activator.CreateInstance -Methode verwenden, um eine neue Instanz des clientaktivierten Objekts zu erstellen, müssen Sie die URL der Remoteanwendung als Parameter angeben, sodass keine vorherige Registrierung auf dem Clientende erforderlich ist. Um die Activator.CreateInstance -Methode mit der URL des Servers anzugeben, auf dem Sie das Objekt erstellen möchten, müssen Sie die URL in einer Instanz der UrlAttribute -Klasse kapseln.

Eine ausführliche Beschreibung der vom Client aktivierten Objekte finden Sie unter Clientaktivierung.

Weitere Informationen

• ActivatedClientTypeEntry
• ActivatedServiceTypeEntry

public:
 static void RegisterActivatedClientType(Type ^ type, System::String ^ appUrl);

public static void RegisterActivatedClientType (Type type, string appUrl);

static member RegisterActivatedClientType : Type * string -> unit

Public Shared Sub RegisterActivatedClientType (type As Type, appUrl As String)

Parameter

Ausnahmen

Beispiele

Das folgende Codebeispiel veranschaulicht die Registrierung eines Objekttyps auf dem Clientende als Typ, der auf dem Server aktiviert werden kann. Den Servercode, der dem angezeigten Clientcode entspricht, finden Sie im Beispiel für die RegisterActivatedServiceType -Methode.

#using <system.dll>
#using <system.runtime.remoting.dll>
#using "service.dll"

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;

int main()
{
   ChannelServices::RegisterChannel( gcnew TcpChannel );
   RemotingConfiguration::RegisterActivatedClientType( HelloServiceClass::typeid, "tcp://localhost:8082" );
   try
   {
      HelloServiceClass ^ service = gcnew HelloServiceClass;

      // Calls the remote method.
      Console::WriteLine();
      Console::WriteLine( "Calling remote Object" );
      Console::WriteLine( service->HelloMethod( "Caveman" ) );
      Console::WriteLine( service->HelloMethod( "Spaceman" ) );
      Console::WriteLine( service->HelloMethod( "Client Man" ) );
      Console::WriteLine( "Finished remote Object call" );
    }
    catch (Exception ex)
    {
        Console::WriteLine("An exception occurred: " + ex.Message);
    }
   Console::WriteLine();
   return 0;
}

using System;
using System.Runtime.Remoting;
using System.Runtime.Remoting.Channels;
using System.Runtime.Remoting.Channels.Tcp;

public class ClientClass {

    public static void Main() {

        ChannelServices.RegisterChannel(new TcpChannel());

        RemotingConfiguration.RegisterActivatedClientType(typeof(HelloServiceClass),
                                                   "tcp://localhost:8082");

        try
        {
            HelloServiceClass service = new HelloServiceClass();

           // Calls the remote method.
           Console.WriteLine();
           Console.WriteLine("Calling remote object");
           Console.WriteLine(service.HelloMethod("Caveman"));
           Console.WriteLine(service.HelloMethod("Spaceman"));
           Console.WriteLine(service.HelloMethod("Client Man"));
           Console.WriteLine("Finished remote object call");
           Console.WriteLine();
        }
    catch (Exception ex)
    {
       Console.WriteLine("An exception occurred: " + ex.Message);
        }
    }
}

Imports System.Runtime.Remoting
Imports System.Runtime.Remoting.Channels
Imports System.Runtime.Remoting.Channels.Tcp


Public Class ClientClass
   
   Public Shared Sub Main()
      
      ChannelServices.RegisterChannel(New TcpChannel())
      
      RemotingConfiguration.RegisterActivatedClientType(GetType(HelloServiceClass), "tcp://localhost:8082")
      
      Try
          Dim service As New HelloServiceClass()
      
       
          ' Calls the remote method.
          Console.WriteLine()
          Console.WriteLine("Calling remote object")
          Console.WriteLine(service.HelloMethod("Caveman"))
          Console.WriteLine(service.HelloMethod("Spaceman"))
          Console.WriteLine(service.HelloMethod("Client Man"))
          Console.WriteLine("Finished remote object call")
      Catch ex as Exception
          Console.WriteLine("An exception occurred: " + ex.Message)
      End Try

      Console.WriteLine()

   End Sub

End Class

Hinweise

Um eine Instanz eines clientaktivierten Objekts auf dem Server zu erstellen, müssen Sie dessen Type kennen, und es muss auf dem Serverende mit der RegisterActivatedServiceType -Methode registriert werden. Um einen Proxy für eine neue Instanz des vom Client aktivierten Objekts abzurufen, muss der Client zuerst einen Kanal bei ChannelServices registrieren und dann das -Objekt aktivieren, indem er aufruft new.

Um einen clientaktivierbaren Objekttyp mit dem new Schlüsselwort zu aktivieren, müssen Sie zuerst den Objekttyp auf dem Clientende mithilfe der RegisterActivatedClientType -Methode registrieren. Beim Aufrufen der RegisterActivatedClientType -Methode erhält die Remotinginfrastruktur den Speicherort der Remoteanwendung, an der new versucht wird, sie zu erstellen. Wenn Sie hingegen die Activator.CreateInstance -Methode verwenden, um eine neue Instanz des clientaktivierten Objekts zu erstellen, müssen Sie die URL der Remoteanwendung als Parameter angeben, sodass keine vorherige Registrierung auf dem Clientende erforderlich ist. Um die Activator.CreateInstance -Methode mit der URL des Servers anzugeben, auf dem Sie das Objekt erstellen möchten, müssen Sie die URL in einer Instanz der UrlAttribute -Klasse kapseln.

Eine ausführliche Beschreibung der vom Client aktivierten Objekte finden Sie unter Clientaktivierung.

Weitere Informationen

• ActivatedClientTypeEntry
• ActivatedServiceTypeEntry