This documentation is archived and is not being maintained.

RemotingConfiguration::Configure Method (String)

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)

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

Parameters

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

ExceptionCondition
SecurityException

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

NoteNote

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

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

For configuration file syntax, see [<topic://gnconremotingsettingsschema>].

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.


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


.NET Framework

Supported in: 1.1, 1.0
Obsolete (compiler warning) in 4
Obsolete (compiler warning) in 3.5
Obsolete (compiler warning) in 3.5 SP1
Obsolete (compiler warning) in 3.0
Obsolete (compiler warning) in 3.0 SP1
Obsolete (compiler warning) in 3.0 SP2
Obsolete (compiler warning) in 2.0
Obsolete (compiler warning) in 2.0 SP1
Obsolete (compiler warning) in 2.0 SP2

.NET Framework Client Profile

Obsolete (compiler warning) in 4
Obsolete (compiler warning) in 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: