Membership.Providers プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

Membership.Providers プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ASP.NET アプリケーションのメンバシッププロバイダのコレクションを取得します。

名前空間: System.Web.Security
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Shared ReadOnly Property
 Providers As MembershipProviderCollection

Visual Basic (使用法)

Dim value As MembershipProviderCollection

value = Membership.Providers

public static MembershipProviderCollection
 Providers { get; }

C++

public:
static property MembershipProviderCollection^ Providers {
    MembershipProviderCollection^ get ();
}

/** @property */
public static MembershipProviderCollection
 get_Providers ()

JScript

public static function get
 Providers () : MembershipProviderCollection

プロパティ値
ASP.NET アプリケーション用に構成されたメンバシッププロバイダの MembershipProviderCollection。

解説

Providers プロパティは、そのアプリケーションに対する Web.config ファイルおよび複数のアプリケーションに対する Machine.config ファイルに追加されたプロバイダを含む、そのアプリケーションに対して有効になっているすべてのメンバシッププロバイダを参照します。アプリケーションで使用可能にするメンバシッププロバイダは、アプリケーションの構成ファイルの membership 要素 (ASP.NET 設定スキーマ) セクションの providers 要素を使用して制御できます。たとえば、次の例では、コンピュータ構成ファイルで指定されている SqlMembershipProvider インスタンス (AspNetSqlProvider) を削除して、アプリケーションの既定のメンバシッププロバイダとして SqlProvider という名前の SqlMembershipProvider インスタンスを追加する、アプリケーションの Web.config ファイル内の membership 要素 (ASP.NET 設定スキーマ) セクションが示されています。

<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>

membership 要素 (ASP.NET 設定スキーマ) セクションを指定する場合、defaultProvider 属性を指定する必要があります。Web.config ファイルの membership 要素 (ASP.NET 設定スキーマ) セクションを指定しない場合、コンピュータ構成からの値が使用され、AspNetSqlProvider という名前の SqlMembershipProvider インスタンスが defaultProvider として確立されます。

厳密に型指定されたプロバイダへの参照を Providers コレクションから取得するには、名前のインデックスによってメンバシッププロバイダを参照し、そのプロバイダを目的の型にキャストします。

使用例

アプリケーションに対して有効にされたプロバイダとそれらの種類をリストするコードの例を次に示します。

Visual Basic

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security"
 %>
<%@ Import Namespace="System.Configuration.Provider"
 %>
<html>
<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>

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Configuration.Provider" %>
<html>
<head>
<title>List Enabled Providers</title>
</head>
<body>

<%
foreach (ProviderBase p in Membership.Providers)
  Response.Write(p.Name + ", " + p.GetType() + "<BR>");
%>

</body>
</html>