ActivatedClientTypeEntry Osztály

Definíció

Névtér:: System.Runtime.Remoting

Szerelvény:: mscorlib.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Az ügyfél végén regisztrált objektumtípus értékeit a kiszolgálón aktiválható típusként tárolja.

public ref class ActivatedClientTypeEntry : System::Runtime::Remoting::TypeEntry

public class ActivatedClientTypeEntry : System.Runtime.Remoting.TypeEntry

[System.Runtime.InteropServices.ComVisible(true)]
public class ActivatedClientTypeEntry : System.Runtime.Remoting.TypeEntry

type ActivatedClientTypeEntry = class
    inherit TypeEntry

[<System.Runtime.InteropServices.ComVisible(true)>]
type ActivatedClientTypeEntry = class
    inherit TypeEntry

Public Class ActivatedClientTypeEntry
Inherits TypeEntry

Öröklődés: Object

TypeEntry
ActivatedClientTypeEntry

Attribútumok: ComVisibleAttribute

Példák

Az alábbi példakód bemutatja, hogyan regisztrálhat egy ActivatedClientTypeEntry ügyfél által aktivált távoli objektumot egy ügyfél által aktivált távoli objektum regisztrálásához. A példa három részből áll, egy ügyfélből, egy kiszolgálóból és egy távoli objektumból, amelyet az ügyfél és a kiszolgáló használ.

Az alábbi példakód egy ügyfelet mutat be:

#using <System.Runtime.Remoting.dll>
#using <ActivatedClientTypeEntry_Share.dll>

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;
static void main()
{
   // Register TCP Channel.
   ChannelServices::RegisterChannel( gcnew TcpChannel );
   
   // Create activated client type entry.
   ActivatedClientTypeEntry^ activatedClientTypeEntry = gcnew ActivatedClientTypeEntry( HelloServer::typeid, "tcp://localhost:8082" );
   
   // Register type on client to activate it on the server.
   RemotingConfiguration::RegisterActivatedClientType( activatedClientTypeEntry );
   
   // Activate a client activated object type.
   HelloServer^ helloServer = gcnew HelloServer( "ParameterString" );
   
   // Print the object type.
   Console::WriteLine( "Object type of client activated object: {0}", activatedClientTypeEntry->ObjectType->ToString() );
   
   // Print the application URL.
   Console::WriteLine( "Application url where the type is activated: {0}", activatedClientTypeEntry->ApplicationUrl->ToString() );
   
   // Print the string representation of the type entry.
   Console::WriteLine( "Type and assembly name and application URL of the remote object: {0}", activatedClientTypeEntry->ToString() );
   
   // Print a blank line.
   Console::WriteLine();
   
   // Check that server was located.
   if (  !helloServer )
   {
      Console::WriteLine( "Could not locate server" );
   }
   else
   {
      Console::WriteLine( "Calling remote object" );
      Console::WriteLine( helloServer->HelloMethod( "Bill" ) );
   }
}

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

public class MyClient
{
    public static void Main()
    {
        // Register TCP Channel.
        ChannelServices.RegisterChannel(new TcpChannel());

        // Create activated client type entry.
        ActivatedClientTypeEntry myActivatedClientTypeEntry =
            new ActivatedClientTypeEntry(typeof(HelloServer),
            "tcp://localhost:8082");

        // Register type on client to activate it on the server.
        RemotingConfiguration.RegisterActivatedClientType(
            myActivatedClientTypeEntry);

        // Activate a client activated object type.
        HelloServer myHelloServer = new HelloServer("ParameterString");

        // Print the object type.
        Console.WriteLine(
            "Object type of client activated object: " +
            myActivatedClientTypeEntry.ObjectType.ToString());

        // Print the application URL.
        Console.WriteLine(
            "Application url where the type is activated: " +
            myActivatedClientTypeEntry.ApplicationUrl);

        // Print the string representation of the type entry.
        Console.WriteLine(
            "Type name, assembly name and application URL " +
            "of the remote object: " +
            myActivatedClientTypeEntry.ToString());

        // Print a blank line.
        Console.WriteLine();

        // Check that server was located.
        if (myHelloServer == null)
        {
            Console.WriteLine("Could not locate server");
        }
        else
        {
            Console.WriteLine("Calling remote object");
            Console.WriteLine(myHelloServer.HelloMethod("Bill"));
        }
    }
}

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

Public Class MyClient
    
    Public Shared Sub Main()
        ' Register TCP Channel.
        ChannelServices.RegisterChannel(New TcpChannel())

        ' Create activated client type entry.
        Dim myActivatedClientTypeEntry As _
            New ActivatedClientTypeEntry(GetType(HelloServer), _
            "tcp://localhost:8082")

        ' Register type on client to activate it on the server.
        RemotingConfiguration.RegisterActivatedClientType( _
            myActivatedClientTypeEntry)

        ' Activate a client activated object type.
        Dim myHelloServer As New HelloServer("ParameterString")

        ' Print the object type.
        Console.WriteLine("Object type of client activated object: " + _
            myActivatedClientTypeEntry.ObjectType.ToString())

        ' Print the application URL.
        Console.WriteLine("Application url where the type is activated: " + _
            myActivatedClientTypeEntry.ApplicationUrl)

        ' Print the string representation of the type entry.
        Console.WriteLine( _
            "Type name, assembly name and application URL " + _
            "of the remote object: " + _
            myActivatedClientTypeEntry.ToString())

        ' Print a blank line.
        Console.WriteLine()

        ' Check that server was located.
        If myHelloServer Is Nothing Then
            Console.WriteLine("Could not locate server")
        Else
            Console.WriteLine("Calling remote object")
            Console.WriteLine(myHelloServer.HelloMethod("Bill"))
        End If
    End Sub
End Class

Az alábbi példakód az ügyfél kiszolgálóját mutatja be:

#using <ActivatedClientTypeEntry_Share.dll>
#using <System.Runtime.Remoting.dll>

using namespace System;
using namespace System::Runtime::Remoting;
using namespace System::Runtime::Remoting::Channels;
using namespace System::Runtime::Remoting::Channels::Tcp;
void main()
{
   ChannelServices::RegisterChannel( gcnew TcpChannel( 8082 ) );
   RemotingConfiguration::RegisterActivatedServiceType( HelloServer::typeid );
   Console::WriteLine( "Press enter to stop this process" );
   Console::ReadLine();
}

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

public class MyServer
{
    public static void Main()
    {
        ChannelServices.RegisterChannel(new TcpChannel(8082));
        RemotingConfiguration.RegisterActivatedServiceType(typeof(HelloServer));
        Console.WriteLine("Press enter to stop this process");
        Console.ReadLine();
   }
}

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

Public Class MyServer
    
    Public Shared Sub Main()
        ChannelServices.RegisterChannel(New TcpChannel(8082))
        RemotingConfiguration.RegisterActivatedServiceType(GetType(HelloServer))
        Console.WriteLine("Press enter to stop this process")
        Console.ReadLine()
    End Sub

End Class

Az alábbi példakód az ügyfél és a kiszolgáló által használt távoli objektumot tartalmazza:

using namespace System;
public ref class HelloServer: public MarshalByRefObject
{
public:
   HelloServer( String^ myString )
   {
      Console::WriteLine( "HelloServer activated" );
      Console::WriteLine( "Paramater passed to the constructor is {0}", myString );
   }

   String^ HelloMethod( String^ myName )
   {
      Console::WriteLine( "HelloMethod : {0}", myName );
      return String::Format( "Hi there {0}", myName );
   }

};

using System;
public class HelloServer : MarshalByRefObject
{
    public HelloServer(String myString)
    {
        Console.WriteLine("HelloServer activated");
        Console.WriteLine("Parameter passed to the constructor is "+myString);
    }
    public String HelloMethod(String myName)
    {
        Console.WriteLine("HelloMethod : {0}",myName);
        return "Hi there " + myName;
    }
}

Public Class HelloServer
    Inherits MarshalByRefObject
    
    Public Sub New(myString As String)
        Console.WriteLine("HelloServer activated")
        Console.WriteLine("Parameter passed to the constructor is " + myString)
    End Sub
    
    Public Function HelloMethod(myName As String) As String
        Console.WriteLine("HelloMethod : {0}", myName)
        Return "Hi there " + myName
    End Function 'HelloMethod
End Class

Megjegyzések

Ha ügyfél által aktivált objektumpéldányt szeretne létrehozni az ügyfélen, ismernie kell annak példányát Type , és a metódus használatával regisztrálnia kell azt az RegisterActivatedClientType ügyfélen. Az ügyfél által aktivált objektum új példányához tartozó proxy beszerzéséhez az ügyfélnek először regisztrálnia kell egy csatornát ChannelServices , majd hívással newaktiválnia kell az objektumot.

Ha ügyfél által aktivált objektumtípust szeretne aktiválni a new kulcsszóval, először regisztrálnia kell az objektumtípust az ügyfélen a RegisterActivatedClientType módszerrel. A hívással RegisterActivatedClientType megadja az újraegyesítő infrastruktúrának annak a távoli alkalmazásnak a helyét, ahol new megkísérli létrehozni. Ha viszont ezzel a módszerrel hozza létre az Activator.CreateInstance ügyfél által aktivált objektum új példányát, paraméterként meg kell adnia a távoli alkalmazás URL-címét, így nincs szükség előzetes regisztrációra az ügyféloldalon. Ha meg szeretné adni a Activator.CreateInstance metódust annak a kiszolgálónak az URL-címével, amelyen létre szeretné hozni az objektumot, az osztály egy példányában kell beágyaznia az UrlAttribute URL-címet.

Az ügyfél által aktivált objektumok és a távoli objektumok aktiválásának részletes leírását lásd: Távoli objektumok aktiválása.

Konstruktorok

Name	Description
ActivatedClientTypeEntry(String, String, String)	Inicializálja az osztály új példányát a ActivatedClientTypeEntry megadott típusnévvel, szerelvénynévvel és alkalmazás URL-címmel.
ActivatedClientTypeEntry(Type, String)	Inicializálja az osztály új példányát a ActivatedClientTypeEntry megadott Type és az alkalmazás URL-címével.

Tulajdonságok

Name	Description
ApplicationUrl	Lekéri az alkalmazás URL-címét a típus aktiválásához.
AssemblyName	Lekéri annak az objektumtípusnak a szerelvénynevét, amely távoli aktiválású típusként van konfigurálva. (Öröklődés forrása TypeEntry)
ContextAttributes	Lekéri vagy beállítja az ügyfél által aktivált típus környezeti attribútumait.
ObjectType	Lekéri az Type ügyfél által aktivált típust.
TypeName	Lekéri annak az objektumtípusnak a teljes nevét, amely távoli aktiválású típusként van konfigurálva. (Öröklődés forrása TypeEntry)

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az ügyfél által aktivált típus Stringtípusnevét, szerelvénynevét és alkalmazás URL-címét adja vissza.

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?