System.Runtime.Remoting.Activation.IConstructionCallMessage Interface

Summary

Represents the construction call request of an object.

C# Syntax:

public interface IConstructionCallMessage : IMethodCallMessage, IMethodMessage, IMessage

When the user creates an instance of a new client-activated object by calling new or Activator.CreateInstance and before the thread returns to the user code, an IConstructionCallMessage is sent to the remote application. When the construction message arrives at the remote application, it is processed by a remoting Activator (either the default one, or one that is specified in the IConstructionCallMessage.Activator property) and a new object is created. The remoting application then returns an IConstructionReturnMessage to the local application. The IConstructionReturnMessage contains an instance of ObjRef which is a package of information about the remote object. The remoting infrastructure converts the ObjRef instance into a proxy to the remote object which is returned to the user code.

System.Runtime.Remoting.Activation Namespace

System.Runtime.Remoting.Activation.IConstructionCallMessage Member List:

Public Properties

ActivationType	Read-only Gets the type of the remote object to activate.
ActivationTypeName	Read-only Gets the full type name of the remote type to activate.
Activator	Read-write Gets or sets the activator that activates the remote object.
CallSiteActivationAttributes	Read-only Gets the call site activation attributes.
ContextProperties	Read-only Gets a list of context properties that define the context in which the object is to be created.

Hierarchy:

• System.Runtime.Remoting.Messaging.IMethodCallMessage
• System.Runtime.Remoting.Messaging.IMethodMessage
• System.Runtime.Remoting.Messaging.IMessage
• System.Runtime.Remoting.Activation.IConstructionCallMessage

System.Runtime.Remoting.Activation.IConstructionCallMessage Member Details

Summary

Gets the type of the remote object to activate.

C# Syntax:

Type ActivationType {get;}

Return to top

Summary

Gets the full type name of the remote type to activate.

C# Syntax:

string ActivationTypeName {get;}

Return to top

Summary

Gets or sets the activator that activates the remote object.

C# Syntax:

IActivator Activator {get; set;}

A chain of activators arranged in a hierarchy typically complete the various tasks involved in the activation process. If you intend to plug in a custom activator then you should traverse the activator hierarchy and plug in your activator at the appropriate location. Use the IActivator.NextActivator property on the activator returned by the current property to traverse the chain of activators.

If you add your own activator in the activator chain in the message on the client side, if deemed necessary the activator will be serialized and transported to the server side. For this reason, custom activators should be fairly lightweight in terms of serialization requirements.

Return to top

Summary

Gets the call site activation attributes.

C# Syntax:

object[] CallSiteActivationAttributes {get;}

The IConstructionCallMessage.CallSiteActivationAttributes indexer allows you to specify additional attributes to use during object activation. The user specifies the IConstructionCallMessage.CallSiteActivationAttributes in the activationAttributes parameter to Activator.CreateInstance.

Return to top

Summary

Gets a list of context properties that define the context in which the object is to be created.

C# Syntax:

IList ContextProperties {get;}

A new object's context is generally chosen based on metadata attributes of the class. The context selection mechanism is extensible through custom attributes, also known as static context properties, which are compiled into the class metadata. When activating an object remotely the IConstructionCallMessage.ContextProperties contain the list of properties that were contributed by various attributes in the construction call message. These properties are used to create the context in which the server object is activated.

Return to top

Top of page