System.Runtime.Remoting.ActivatedClientTypeEntry Class

Assembly: Mscorlib.dll
Namespace: System.Runtime.Remoting
Summary
Holds values for an object type registered on the client end as a type that can be activated on the server.
C# Syntax:
public class ActivatedClientTypeEntry : TypeEntry
Remarks
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 RemotingConfiguration.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 end using the method RemotingConfiguration.RegisterActivatedClientType. By calling the RemotingConfiguration.RegisterActivatedClientType method 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 an 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 the conceptual topic at MSDN: activation.

See also:
System.Runtime.Remoting Namespace | RemotingConfiguration.RegisterActivatedClientType | MSDN: clientactivation

System.Runtime.Remoting.ActivatedClientTypeEntry Member List:

Public Constructors
ctor #1 Overloaded:
.ctor(Type type, string appUrl)

Initializes a new instance of the ActivatedClientTypeEntry class with the given Type and application URL.
ctor #2 Overloaded:
.ctor(string typeName, string assemblyName, string appUrl)

Initializes a new instance of the ActivatedClientTypeEntry class with the given type name, assembly name, and application URL.
Public Properties
ApplicationUrl Read-only

Gets the URL of the application to activate the type in.
AssemblyName
(inherited from System.Runtime.Remoting.TypeEntry)
Read-write

See base class member description: System.Runtime.Remoting.TypeEntry.AssemblyName


Gets the assembly name of the object type configured to be a remote activated type.
ContextAttributes Read-write

Gets or sets the context attributes for the client activated type.
ObjectType Read-only

Gets the Type of the client activated type.
TypeName
(inherited from System.Runtime.Remoting.TypeEntry)
Read-write

See base class member description: System.Runtime.Remoting.TypeEntry.TypeName


Gets the full type name of the object type configured to be a remote activated type.
Public Methods
Equals
(inherited from System.Object)
See base class member description: System.Object.Equals

Derived from System.Object, the primary base class for all objects.
GetHashCode
(inherited from System.Object)
See base class member description: System.Object.GetHashCode

Derived from System.Object, the primary base class for all objects.
GetType
(inherited from System.Object)
See base class member description: System.Object.GetType

Derived from System.Object, the primary base class for all objects.
ToString Overridden:
Returns the type name, assembly name, and application URL of the client activated type as a String.
Protected Methods
Finalize
(inherited from System.Object)
See base class member description: System.Object.Finalize

Derived from System.Object, the primary base class for all objects.
MemberwiseClone
(inherited from System.Object)
See base class member description: System.Object.MemberwiseClone

Derived from System.Object, the primary base class for all objects.

Hierarchy:


System.Runtime.Remoting.ActivatedClientTypeEntry Member Details

Overloaded ctor #1
Summary
Initializes a new instance of the ActivatedClientTypeEntry class with the given Type and application URL.
C# Syntax:
public ActivatedClientTypeEntry(
   Type type,
   string appUrl
);
Parameters:

type

The Type of the client activated type.

appUrl

The URL of the application to activate the type in.

Remarks
The assembly name of the type is derived from the type parameter.

Return to top


Overloaded ctor #2
Summary
Initializes a new instance of the ActivatedClientTypeEntry class with the given type name, assembly name, and application URL.
C# Syntax:
public ActivatedClientTypeEntry(
   string typeName,
   string assemblyName,
   string appUrl
);
Parameters:

typeName

The type name of the client activated type.

assemblyName

The assembly name of the client activated type.

appUrl

The URL of the application to activate the type in.

Return to top


Property: ApplicationUrl (read-only)
Summary
Gets the URL of the application to activate the type in.
C# Syntax:
public string ApplicationUrl {get;}

Return to top


Property: AssemblyName (read-write)
Inherited
See base class member description: System.Runtime.Remoting.TypeEntry.AssemblyName

Summary
Gets the assembly name of the object type configured to be a remote activated type.
C# Syntax:
public string AssemblyName {get; set;}

Return to top


Property: ContextAttributes (read-write)
Summary
Gets or sets the context attributes for the client activated type.
C# Syntax:
public IContextAttribute[] ContextAttributes {get; set;}
Remarks
Context attributes provide context properties which when added to a Context can enforce policies such as Synchronization or Transactions.

Note At the moment this indexer is not implemented and operations on it will not produce any results.
See also:
Context | ContextAttribute | ContextProperty | IContextAttribute

Return to top


Property: ObjectType (read-only)
Summary
Gets the Type of the client activated type.
C# Syntax:
public Type ObjectType {get;}

Return to top


Property: TypeName (read-write)
Inherited
See base class member description: System.Runtime.Remoting.TypeEntry.TypeName

Summary
Gets the full type name of the object type configured to be a remote activated type.
C# Syntax:
public string TypeName {get; set;}

Return to top


Method: Equals(
   object obj
)
Inherited
See base class member description: System.Object.Equals
C# Syntax:
public virtual bool Equals(
   object obj
);

For more information on members inherited from System.Object click on the link above.

Return to top


Method: Finalize()
Inherited
See base class member description: System.Object.Finalize
C# Syntax:
~ActivatedClientTypeEntry();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: GetHashCode()
Inherited
See base class member description: System.Object.GetHashCode
C# Syntax:
public virtual int GetHashCode();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: GetType()
Inherited
See base class member description: System.Object.GetType
C# Syntax:
public Type GetType();

For more information on members inherited from System.Object click on the link above.

Return to top


Method: MemberwiseClone()
Inherited
See base class member description: System.Object.MemberwiseClone
C# Syntax:
protected object MemberwiseClone();

For more information on members inherited from System.Object click on the link above.

Return to top


Overridden Method: ToString()
Summary
Returns the type name, assembly name, and application URL of the client activated type as a String.
C# Syntax:
public override string ToString();
Return Value:
The type name, assembly name, and application URL of the client activated type as a String.

Return to top


Top of page

Copyright (c) 2002 Microsoft Corporation. All rights reserved.