Providers

 

Applies To: Windows Server 2012 R2, Windows Server 2012

Use the Providers feature page to manage a list of ASP.NET data providers.

Sort the list by clicking one of the feature page column headings or select a value from the Group by drop-down list to group similar items.

Related scenarios

In this document

UI Elements for Providers

The following tables describe the UI elements that are available on the feature page and in the Actions pane.

Feature Page Elements

Element Name

Description

Feature

Select a feature from the list to display providers for that feature: .NET Roles, .NET Users, and .NET Profile.

Name

Displays the name of the provider. This is a friendly name that is assigned to the provider for easy identification and recognition.

Type

Displays the managed code type for the provider. All providers are implemented in managed code.

Entry Type

Displays whether the item is local or inherited. Local items are read from the current configuration file, and inherited items are read from a parent configuration file.

Actions Pane Elements

Element Name

Description

Add

Opens the Add Provider dialog box in which you can add a provider for the selected feature.

Edit

Opens the Edit Provider dialog box in which you can edit the selected provider.

Rename

Enables the Name field of the selected provider so that you can rename the provider.

Remove

Removes the item that is selected from the list on the feature page.

Connection Strings

Opens the Connection Strings feature page from which you can add a connection string that can be used by a provider.

Add or Edit Provider Dialog Box

Use the Add Provider and Edit Provider dialog boxes to add or modify a provider in IIS when you have an application that uses a provider-based service to store data in a database or other data store. The properties that are displayed in the dialog box depend on which type of provider you choose to add or edit.

The 3 different types of providers you can add or edit are:

  • Roles - provides an interface between the ASP.NET role management service (the "role manager") and role data sources.

  • Users - provides an interface between the ASP.NET membership service and membership data sources.

  • Profile - provides an interface between the ASP.NET profile service and profile data sources.

Note

The Add Provider and Edit Provider dialog boxes enable you to add or edit most of the properties for a provider, but not all of them. You can configure additional properties for each provider in the Web.config file of your web application. For more information about providers see ASP.NET 2.0 Provider Model: Introduction to the Provider Model.

Element Name

Description

Type

Sets the provider type.

Name

Defines the name of the provider.

Behavior

Sets some of the behaviors for Membership User providers. Setting the value of one or more of the following behaviors to True enables that behavior:

  • EnablePasswordReset - indicates whether passwords can be reset using the provider's ResetPassword method. The default setting is False.

  • EnablePasswordRetrieval - indicates whether passwords can be retrieved using the provider's GetPassword method. The default setting is False.

  • RequiresQuestionAndAnswer - indicates whether a password answer must be supplied when calling the provider's GetPassword and ResetPassword methods. The default setting is False.

  • RequiresUniqueEmail - indicates whether each registered user must have a unique e-mail address. The default setting is False.

  • StorePasswordInSecureFormat - indicates whether passwords should be hashed. The default setting is False.

Data

Configures the name of the connection string used to connect to the database. Enter the name of the connection string in the ConnectionStringName check box.

General

Defines general settings for the provider. These settings are optional and include:

  • ApplicationName - specifies the virtual path of the application in the ApplicationName box. If you do not specify a value in the ApplicationName box, the membership API defaults to HttpContext.Current.Request.ApplicationPath. This value can be determined only at runtime.

  • Description - gives a description of the provider.

Misc

Enables you to configure name and value pairs that are specific to the provider. To add and remove name and value pairs, click the button next to the Provider Specific Settings field in the Misc section.