ClientRoleProvider.Initialize(String, NameValueCollection) Method

Definition

Namespace:

System.Web.ClientServices.Providers

Assembly:

System.Web.Extensions.dll

Initializes the provider.

public:
 override void Initialize(System::String ^ name, System::Collections::Specialized::NameValueCollection ^ config);

public override void Initialize (string name, System.Collections.Specialized.NameValueCollection config);

override this.Initialize : string * System.Collections.Specialized.NameValueCollection -> unit

Public Overrides Sub Initialize (name As String, config As NameValueCollection)

Parameters

name

String

The friendly name of the provider.

config

NameValueCollection

A collection of name/value pairs representing the provider-specific attributes specified in the configuration for this provider.

Exceptions

ArgumentNullException

name is null.

-or-

config is null.

ArgumentException

name is empty.

-or-

config contains an unrecognized value.

InvalidOperationException

This ClientRoleProvider has already been initialized.

FormatException

config contains a cacheTimeout value that is not in the correct format for conversion to an Int32 value.

OverflowException

config contains a cacheTimeout value that represents a number less than Int32.MinValue or greater than Int32.MaxValue.

Remarks

The ASP.NET extensibility model calls the Initialize method to initialize the ClientRoleProvider using information in your application configuration file. This method recognizes the following role service configuration attributes:

• name
• description
• cacheTimeout
• connectionStringName
• serviceUri
• honorCookieExpiry

See also

• Client Application Services
• How to: Configure Client Application Services