Membership.Providers Property
Definition
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.
Gets a collection of the membership providers for the ASP.NET application.
public:
static property System::Web::Security::MembershipProviderCollection ^ Providers { System::Web::Security::MembershipProviderCollection ^ get(); };
public static System.Web.Security.MembershipProviderCollection Providers { get; }
static member Providers : System.Web.Security.MembershipProviderCollection
Public Shared ReadOnly Property Providers As MembershipProviderCollection
Property Value
A MembershipProviderCollection of the membership providers configured for the ASP.NET application.
Examples
The following code example lists the providers enabled for an application and their respective types.
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Configuration.Provider" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>List Enabled Providers</title>
</head>
<body>
<%
foreach (ProviderBase p in Membership.Providers)
Response.Write(p.Name + ", " + p.GetType() + "<br />");
%>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Configuration.Provider" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>List Enabled Providers</title>
</head>
<body>
<%
For Each p As ProviderBase In Membership.Providers
Response.Write(p.Name & ", " & p.GetType().ToString() & "<br />")
Next
%>
</body>
</html>
Remarks
The Providers property references all of the membership providers enabled for an application, including providers added in the Web.config file for the application and the Machine.config file for all applications. You can control which membership providers are available for an application using the providers element of the membership section in the configuration for your application. For example, the following sample shows the membership section in the Web.config file for an application that removes the SqlMembershipProvider instance (AspNetSqlProvider
) specified in the machine configuration file and adds a SqlMembershipProvider instance named SqlProvider
as the default membership provider for the application.
<configuration>
<connectionStrings>
<add name="SqlServices" connectionString="Data Source=MySqlServer;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />
</connectionStrings>
<system.web>
<membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="20">
<providers>
<remove name="AspNetSqlProvider" />
<add name="SqlProvider"
type="System.Web.Security.SqlMembershipProvider"
connectionStringName="SqlServices"
enablePasswordRetrieval="false"
enablePasswordReset="true"
requiresQuestionAndAnswer="true"
passwordFormat="Hashed"
applicationName="/" />
</providers>
</membership>
</system.web>
</configuration>
When specifying the membership Element (ASP.NET Settings Schema) section, you must specify the defaultProvider
attribute. If you do not specify a membership Element (ASP.NET Settings Schema) section in your Web.config, the values from the machine configuration are used and the SqlMembershipProvider instance named AspNetSqlProvider
is established as the defaultProvider
.
You can obtain a strongly typed reference to a provider from the Providers collection by indexing the membership provider by name and casting it as the desired type.