RemotingConfiguration::Configure Method (String^)

.NET Framework (current version)

Note: This API is now obsolete.

Reads the configuration file and configures the remoting infrastructure. Configure(String^) is obsolete. Please use Configure(String^, Boolean) instead.

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

Syntax

C++

public:
[ObsoleteAttribute("Use System.Runtime.Remoting.RemotingConfiguration.Configure(string fileName, bool ensureSecurity) instead.", 
	false)]
[SecurityPermissionAttribute(SecurityAction::Demand, Flags = SecurityPermissionFlag::RemotingConfiguration)]
static void Configure(
	String^ filename
)

Parameters

filename: Type: System::String^
The name of the remoting configuration file. Can be null.

Exceptions

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

Remarks

Note
Configure(String^) is obsolete. Please use Configure(String^, Boolean) instead.

Passing null as the filename parameter will cause default remoting initialization without requiring the existence of a configuration file.

For configuration file syntax, see Remoting Settings Schema.

Note
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.

Examples

C++

// Configure the remoting structure.
RemotingConfiguration::Configure( "server.config" );

Security

SecurityPermission

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

Version Information

.NET Framework
Available since 1.1