ClientRoleProvider.Initialize(String, NameValueCollection) Method

Reference

Definition

Namespace:: System.Web.ClientServices.Providers

Assembly:: System.Web.Extensions.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Applies to

Jaa