RemotingConfiguration.RegisterActivatedClientType Method (ActivatedClientTypeEntry)

 

Registers an object Type recorded in the provided ActivatedClientTypeEntry on the client end as a type that can be activated on the server.

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

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.RemotingConfiguration)]
public static void RegisterActivatedClientType(
	ActivatedClientTypeEntry entry
)

Parameters

entry
Type: System.Runtime.Remoting.ActivatedClientTypeEntry

Configuration settings for the client-activated type.

Exception Condition
SecurityException

At least one of the callers higher in the callstack does not have permission to configure remoting types and channels.

To create an instance of a client-activated object on the server, you must know its Type and it must be registered on the server end by using the RegisterActivatedServiceType 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 end using the RegisterActivatedClientType method. Calling the RegisterActivatedClientType method gives 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 where 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, see [<topic://cpconClientActivation>].

SecurityPermission

for configuration of the remoting infrastructure. Demand value: SecurityAction.Demand; Permission value: SecurityPermissionFlag.RemotingConfiguration

.NET Framework
Available since 1.1
Return to top
Show: