This documentation is archived and is not being maintained.

Context.RegisterDynamicProperty Method

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

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

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

'Declaration
<SecurityPermissionAttribute(SecurityAction.Demand, Flags := SecurityPermissionFlag.Infrastructure)> _
Public Shared Function RegisterDynamicProperty ( _
	prop As IDynamicProperty, _
	obj As ContextBoundObject, _
	ctx As Context _
) As Boolean
'Usage
Dim prop As IDynamicProperty 
Dim obj As ContextBoundObject 
Dim ctx As Context 
Dim returnValue As Boolean 

returnValue = Context.RegisterDynamicProperty(prop, _
	obj, ctx)

Parameters

prop
Type: System.Runtime.Remoting.Contexts.IDynamicProperty

The dynamic property to register.

obj
Type: System.ContextBoundObject

The object/proxy for which the property is registered.

ctx
Type: System.Runtime.Remoting.Contexts.Context

The context for which the property is registered.

Return Value

Type: System.Boolean
true if the property was successfully registered; otherwise, false.

ExceptionCondition
ArgumentNullException

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

ArgumentException

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

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 Nothing, 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 Nothing.

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

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

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Show: