ActivatedClientTypeEntry Class
Holds values for an object type registered on the client end as a type that can be activated on the server.
Assembly: mscorlib (in mscorlib.dll)
To create an instance of a client-activated object on the client, you must know its Type and it must be registered on the client by using the RegisterActivatedClientType method. To obtain a proxy for a new instance of the client-activated object the client must first register a channel with ChannelServices and then activate the object by calling new.
To activate a client-activated object type with the new keyword, you must first register the object type on the client using the RegisterActivatedClientType method. By calling RegisterActivatedClientType you are giving the remoting infrastructure the location of the remote application where new attempts to create it. If, on the other hand, you use the Activator.CreateInstance method to create a new instance of the client-activated object, you must supply the remote application's URL as a parameter, so no prior registration on the client end is necessary. To supply the Activator.CreateInstance method with the URL of the server on which you want to create the object, you must encapsulate the URL in an instance of the UrlAttribute class.
For a detailed description of client activated objects and remote object activation see [<topic://cpconActivation>].
The following code example shows how to use a ActivatedClientTypeEntry to register a client activated remote object. The example contains three parts, a client, a server, and a remote object used by the client and server.
The following code example shows a client:
Imports System 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 'Main End Class 'MyClient
#using <mscorlib.dll>
#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(new TcpChannel());
// Create activated client type entry.
ActivatedClientTypeEntry* activatedClientTypeEntry =
new ActivatedClientTypeEntry(__typeof(HelloServer),
"tcp://localhost:8082");
// Register type on client to activate it on the server.
RemotingConfiguration::RegisterActivatedClientType
(activatedClientTypeEntry);
// Activate a client activated object type.
HelloServer* helloServer = new HelloServer(S"ParameterString");
// Print the object type.
Console::WriteLine(
S"Object type of client activated object: {0}",
activatedClientTypeEntry->ObjectType->ToString());
// Print the application URL.
Console::WriteLine(
S"Application url where the type is activated: {0}",
activatedClientTypeEntry->ApplicationUrl->ToString());
// Print the string representation of the type entry.
Console::WriteLine(
S"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(S"Could not locate server");
}
else
{
Console::WriteLine(S"Calling remote object");
Console::WriteLine(helloServer->HelloMethod(S"Bill"));
}
};
The following code example shows a server for this client:
Imports System 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 'Main End Class 'MyServer
#using <mscorlib.dll>
#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(new TcpChannel(8082));
RemotingConfiguration::RegisterActivatedServiceType(__typeof(HelloServer));
Console::WriteLine(S"Press enter to stop this process");
Console::ReadLine();
}
The following code example provides the remote object used by the client and the server:
Imports System 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 'New Public Function HelloMethod(myName As String) As String Console.WriteLine("HelloMethod : {0}", myName) Return "Hi there " + myName End Function 'HelloMethod End Class 'HelloServer
#using <mscorlib.dll>
using namespace System;
__gc public class HelloServer : public MarshalByRefObject
{
public:
HelloServer(String* myString)
{
Console::WriteLine(S"HelloServer activated");
Console::WriteLine(S"Paramater passed to the constructor is {0}", myString);
};
String* HelloMethod(String* myName)
{
Console::WriteLine(S"HelloMethod : {0}", myName);
return String::Format(S"Hi there {0}", myName);
};
};
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.