Context.RegisterDynamicProperty(IDynamicProperty, ContextBoundObject, Context) Method

Definition

Registers a dynamic property implementing the IDynamicProperty interface with the remoting service.

This API supports the product infrastructure and is not intended to be used directly from your code.

public:
 static bool RegisterDynamicProperty(System::Runtime::Remoting::Contexts::IDynamicProperty ^ prop, ContextBoundObject ^ obj, System::Runtime::Remoting::Contexts::Context ^ ctx);
public static bool RegisterDynamicProperty (System.Runtime.Remoting.Contexts.IDynamicProperty prop, ContextBoundObject obj, System.Runtime.Remoting.Contexts.Context ctx);
static member RegisterDynamicProperty : System.Runtime.Remoting.Contexts.IDynamicProperty * ContextBoundObject * System.Runtime.Remoting.Contexts.Context -> bool
Public Shared Function RegisterDynamicProperty (prop As IDynamicProperty, obj As ContextBoundObject, ctx As Context) As Boolean

Parameters

prop
IDynamicProperty

The dynamic property to register.

obj
ContextBoundObject

The object/proxy for which the property is registered.

ctx
Context

The context for which the property is registered.

Returns

true if the property was successfully registered; otherwise, false.

Exceptions

Either prop or its name is null, or it is not dynamic (it does not implement IDynamicProperty).

Both an object as well as a context are specified (both obj and ctx are not null).

Remarks

Based on obj and ctx, prop is asked to contribute a sink that is placed at some location in the path of remoting calls. If multiple properties are registered, their sinks will be called in an arbitrary order that can change between calls.

If obj is not null, and then if it is a proxy, all calls made on the proxy are intercepted. Otherwise, if obj is a real object, all calls on the object are intercepted. The ctx parameter must be null.

If ctx is not null, obj must be null and all calls entering and leaving the context are intercepted.

If both ctx and obj are null, all calls entering and leaving all contexts are intercepted.

Security

SecurityPermission
for plugging code into the CLR infrastructure. Associated enumeration: Infrastructure.

Applies to