Configure Method (String, Boolean)
Collapse the table of content
Expand the table of content

RemotingConfiguration.Configure Method (String, Boolean)

 

Reads the configuration file and configures the remoting infrastructure.

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

[SecurityPermissionAttribute(SecurityAction.Demand, Flags = SecurityPermissionFlag.RemotingConfiguration)]
public static void Configure(
	string filename,
	bool ensureSecurity
)

Parameters

filename
Type: System.String

The name of the remoting configuration file. Can be null.

ensureSecurity
Type: System.Boolean

If set to true security is required. If set to false, security is not required but still may be used.

Exception Condition
SecurityException

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

Passing null as the filename parameter will cause default remoting initialization without requiring the existence of a configuration file. For more information about remoting and security see Security in Remoting.

For configuration file syntax, see Remoting Settings Schema.

System_CAPS_noteNote

Marshal-by-reference objects (MBRs) do not reside in memory forever. Instead, unless the type overrides MarshalByRefObject.InitializeLifetimeService to control its own lifetime policies, each MBR has a finite lifetime before the .NET Framework remoting system begins the process of deleting it and reclaiming the memory. For more information, see Lifetime Leases.

SecurityPermission

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

.NET Framework
Available since 2.0
Return to top
Show:
© 2016 Microsoft