ActivatedClientTypeEntry Class

.NET Framework (current version)

Other Versions

Holds values for an object type registered on the client end as a type that can be activated on the server.

Namespace: System.Runtime.Remoting
Assembly: mscorlib (in mscorlib.dll)

Inheritance Hierarchy

System::Object
System.Runtime.Remoting::TypeEntry
System.Runtime.Remoting::ActivatedClientTypeEntry

Syntax

C++

[ComVisibleAttribute(true)]
public ref class ActivatedClientTypeEntry : TypeEntry

Constructors

	Name	Description
	ActivatedClientTypeEntry(String^, String^, String^)	Initializes a new instance of the ActivatedClientTypeEntry class with the given type name, assembly name, and application URL.
	ActivatedClientTypeEntry(Type^, String^)	Initializes a new instance of the ActivatedClientTypeEntry class with the given Type and application URL.

Properties

	Name	Description
	ApplicationUrl	Gets the URL of the application to activate the type in.
	AssemblyName	Gets the assembly name of the object type configured to be a remote-activated type.(Inherited from TypeEntry.)
	ContextAttributes	Gets or sets the context attributes for the client-activated type.
	ObjectType	Gets the Type of the client-activated type.
	TypeName	Gets the full type name of the object type configured to be a remote-activated type.(Inherited from TypeEntry.)

Methods

	Name	Description
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	Finalize()	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	MemberwiseClone()	Creates a shallow copy of the current Object.(Inherited from Object.)
	ToString()	Returns the type name, assembly name, and application URL of the client-activated type as a String.(Overrides Object::ToString().)

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>].

Examples

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:

C++

#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" ) );
   }
}

The following code example shows a server for this client:

C++

#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();
}

The following code example provides the remote object used by the client and the server:

C++

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 );
   }

};

Version Information

.NET Framework
Available since 1.1

Thread Safety

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.