RemotingConfiguration.Configure Method (String, Boolean) (System.Runtime.Remoting)

.NET Framework Class Library

RemotingConfiguration..::.Configure Method (String, Boolean)

Reads the configuration file and configures the remoting infrastructure.

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

Syntax

Visual Basic (Declaration)

<SecurityPermissionAttribute(SecurityAction.Demand, Flags := SecurityPermissionFlag.RemotingConfiguration)> _
Public Shared Sub Configure ( _
    filename As String, _
    ensureSecurity As Boolean _
)

Visual Basic (Usage)

Dim filename As String
Dim ensureSecurity As Boolean

RemotingConfiguration.Configure(filename, ensureSecurity)

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

Visual C++

[SecurityPermissionAttribute(SecurityAction::Demand, Flags = SecurityPermissionFlag::RemotingConfiguration)]
public:
static void Configure(
    String^ filename, 
    bool ensureSecurity
)

JScript

public static function Configure(
    filename : String, 
    ensureSecurity : boolean
)

Parameters

filename: Type: System..::.String
The name of the remoting configuration file. Can be nullNothingnullptra null reference (Nothing in Visual Basic).

ensureSecurity: Type: System..::.Boolean
If set to true security is required. If set to false, security is not required but still may be used.

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

Passing nullNothingnullptra null reference (Nothing in Visual Basic) 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 [<topic://gnconremotingsettingsschema>].

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.

.NET Framework Security

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

Platforms

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.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0

Reference

RemotingConfiguration Class

RemotingConfiguration Members

Configure Overload

System.Runtime.Remoting Namespace

Other Resources

[<topic://gnconremotingsettingsschema>]