Membership クラス

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ユーザーの資格情報を検証し、ユーザー設定を管理します。このクラスは継承できません。

public ref class Membership abstract sealed

public static class Membership

type Membership = class

Public Class Membership

継承: Object
Membership

例

次のコード例は、フォーム認証と ASP.NET メンバーシップを使用するように構成された ASP.NET アプリケーションのログインページを示しています。指定されたユーザー資格情報が無効な場合は、ユーザーにメッセージが表示されます。それ以外の場合、ユーザーはメソッドを使用して RedirectFromLoginPage 最初に要求された URL にリダイレクトされます。

注意

ASP.NET ログインコントロール (Login、、LoginName、PasswordRecovery) は、LoginView LoginStatusユーザーに資格情報の入力を求め、メンバーシップシステムの資格情報を検証するために必要なすべてのロジックをカプセル化し、クラスを使用してプログラムによるチェックの代わりに使用Membershipできます。

重要

この例には、潜在的なセキュリティ上の脅威であるユーザー入力を受け入れるテキストボックスが含まれています。既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。詳細については、「スクリプトによる攻略の概要」を参照してください。

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

public void Login_OnClick(object sender, EventArgs args)
{
   if (Membership.ValidateUser(UsernameTextbox.Text, PasswordTextbox.Text))
      FormsAuthentication.RedirectFromLoginPage(UsernameTextbox.Text, NotPublicCheckBox.Checked);
   else
     Msg.Text = "Login failed. Please check your user name and password and try again.";
}


</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
  <title>Login</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Login</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

  Username: <asp:Textbox id="UsernameTextbox" runat="server" /><br />
  Password: <asp:Textbox id="PasswordTextbox" runat="server" TextMode="Password" /><br />
 
  <asp:Button id="LoginButton" Text="Login" OnClick="Login_OnClick" runat="server" />
  <asp:CheckBox id="NotPublicCheckBox" runat="server" /> 
  Check here if this is <span style="text-decoration:underline">not</span> a public computer.

</form>

</body>
</html>

<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

Public Sub Login_OnClick(sender As Object, args As  EventArgs)

   If (Membership.ValidateUser(UsernameTextbox.Text, PasswordTextbox.Text)) Then
      FormsAuthentication.RedirectFromLoginPage(UsernameTextbox.Text, NotPublicCheckBox.Checked)
   Else
     Msg.Text = "Login failed. Please check your user name and password and try again."
   End If

End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
  <title>Login</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>Login</h3>

  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />

  Username: <asp:Textbox id="UsernameTextbox" runat="server" /><br />
  Password: <asp:Textbox id="PasswordTextbox" runat="server" TextMode="Password" /><br />
 
  <asp:Button id="LoginButton" Text="Login" OnClick="Login_OnClick" runat="server" />
  <asp:CheckBox id="NotPublicCheckBox" runat="server" /> 
  Check here if this is <span style="text-decoration:underline">not</span> a public computer.

</form>

</body>
</html>

注釈

このMembershipクラスは、ASP.NET アプリケーションでユーザー資格情報を検証し、パスワードや電子メールアドレスなどのユーザー設定を管理するために使用されます。このクラスは Membership 、単独で使用することも、Web アプリケーションまたはサイトの FormsAuthentication ユーザーを認証するための完全なシステムを作成するために組み合わせて使用することもできます。コントロールは Login 、ユーザーを Membership 検証するための便利なメカニズムを提供するために、クラスをカプセル化します。

注意

ASP.NET のメンバーシップ機能に慣れていない場合は、続行する前にメンバーシップの概要を参照してください。メンバーシップに関連するその他のトピックの一覧については、「メンバーシップを使用したユーザーの管理」を参照してください。

クラスには Membership 、次の機能が用意されています。

新しいユーザーを作成する。
メンバーシップ情報 (ユーザー名、パスワード、電子メールアドレス、およびサポートデータ) をMicrosoft SQL Serverまたは別のデータストアに格納する。
サイトにアクセスするユーザーを認証する。ユーザーをプログラムで認証することも、コントロールを Login 使用して、コードをほとんど必要としない完全な認証システムを作成することもできます。
パスワードの管理。パスワードの作成、変更、取得、リセットなどが含まれます。必要に応じて、パスワードを忘れたユーザーに対してパスワードのリセット要求または取得要求を認証するためにパスワードの質問と回答を要求するように、ASP.NET メンバーシップを構成できます。

ASP.NET メンバーシップは認証用 ASP.NET の自己完結型機能ですが、ASP.NET ロール管理と統合して、サイトの承認サービスを提供できます。メンバーシップは、ASP.NET ユーザーと統合して、個々のユーザーSystem.Web.Profileに合わせてカスタマイズできるアプリケーション固有のカスタマイズを提供することもできます。詳細については、「ロール管理と ASP.NET プロファイルのプロパティの概要」を参照してください。

このクラスは Membership 、メンバーシッププロバイダーに依存してデータソースと通信します。 .NET Frameworkには、Microsoft SQL Server データベースにユーザー情報を格納する機能とActiveDirectoryMembershipProvider、Active Directory または Active Directory アプリケーションモード (ADAM) サーバーにユーザー情報を格納できるユーザー情報が含まれますSqlMembershipProvider。カスタムメンバーシッププロバイダーを実装して、クラスで Membership 使用できる代替データソースと通信することもできます。カスタムメンバーシッププロバイダーは抽象クラスを MembershipProvider 継承します。詳細については、「メンバーシッププロバイダーの実装」を参照してください。

既定では、ASP.NET メンバーシップはすべての ASP.NET アプリケーションで有効になっています。既定のメンバーシッププロバイダーは、名前AspNetSqlProviderをSqlMembershipProvider持つコンピューター構成で指定されています。既定のSqlMembershipProviderインスタンスは、Microsoft SQL Serverのローカルインスタンスに接続するように構成されます。

既定の設定を変更して、インスタンス以外のインスタンスをSqlMembershipProvider既定のAspNetSqlProviderプロバイダーとして指定するか、Web.config ファイルを使用して、ASP.NET アプリケーションの既定のプロバイダーとしてカスタムプロバイダーのインスタンスを指定できます。 Web.config ファイルのメンバーシップ構成セクションを使用して、Web アプリケーションの ASP.NET メンバーシップ構成を指定できます。メンバーシップセクションのプロバイダーサブセクションを使用して、既定のプロバイダー以外のメンバーシッププロバイダーを指定できます。たとえば、次のメンバーシップセクションでは、現在のアプリケーション構成から既定のメンバーシッププロバイダーを削除し、その名前を持つ新しいプロバイダーを、その名前AspSqlServerのSqlProviderSQL Serverインスタンスに追加します。

<configuration>  
  <connectionStrings>  
    <add name="SqlServices" connectionString="Data Source=AspSqlServer;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>

プロパティ

ApplicationName	アプリケーションの名前を取得または設定します。
EnablePasswordReset	現在のメンバーシッププロバイダーによってユーザーにパスワードのリセットが許可されているかどうかを示す値を取得します。
EnablePasswordRetrieval	現在のメンバーシッププロバイダーによってユーザーにパスワードの取得が許可されているかどうかを示す値を取得します。
HashAlgorithmType	パスワードをハッシュするために使用するアルゴリズムの識別子。
MaxInvalidPasswordAttempts	メンバーシップユーザーがロックアウトされるまでの無効なパスワードまたはパスワード解答の試行回数を取得します。
MinRequiredNonAlphanumericCharacters	有効なパスワードに存在する必要がある特殊文字の最小数を取得します。
MinRequiredPasswordLength	パスワードに最低限必要な長さを取得します。
PasswordAttemptWindow	有効なパスワードまたはパスワードの解答の指定までに、連続して失敗した試行を追跡する時間枠を取得します。
PasswordStrengthRegularExpression	パスワードの評価に使用される正規表現を取得します。
Provider	アプリケーションの既定のメンバーシッププロバイダーへの参照を取得します。
Providers	ASP.NET アプリケーションのメンバーシッププロバイダーのコレクションを取得します。
RequiresQuestionAndAnswer	ユーザーがパスワードをリセットおよび取得する際にパスワードの質問に答えなければならないように、既定のメンバーシッププロバイダーが構成されているかどうかを示す値を取得します。
UserIsOnlineTimeWindow	それ以降ユーザーがもはやオンラインでないと見なされる、ユーザーの最終利用日時スタンプからの時間を分単位で指定します。

メソッド

CreateUser(String, String)	新しいユーザーをデータストアに追加します。
CreateUser(String, String, String)	電子メールアドレスを指定して新しいユーザーをデータストアに追加します。
CreateUser(String, String, String, String, String, Boolean, MembershipCreateStatus)	プロパティ値を指定して新しいユーザーをデータストアに追加し、ユーザーの作成に成功したかどうか、または失敗の理由を示すステータスパラメーターを返します。
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	指定したプロパティ値と一意の ID で新しいユーザーをデータストアに追加し、ユーザーの作成に成功したかどうか、または失敗の理由を示すステータスパラメーターを返します。
DeleteUser(String)	データベースからユーザーと関連するユーザーデータを削除します。
DeleteUser(String, Boolean)	データベースからユーザーを削除します。
FindUsersByEmail(String)	指定したメールアドレスと一致するメールアドレスを持つメンバーシップユーザーのコレクションを取得します。
FindUsersByEmail(String, Int32, Int32, Int32)	電子メールアドレスが指定内容と一致するメンバーシップユーザーのコレクションをページで取得します。
FindUsersByName(String)	ユーザー名が指定内容と一致するメンバーシップユーザーのコレクションを取得します。
FindUsersByName(String, Int32, Int32, Int32)	ユーザー名が指定内容と一致するメンバーシップユーザーのコレクションをページで取得します。
GeneratePassword(Int32, Int32)	指定した長さのランダムパスワードを生成します。
GetAllUsers()	データベース内のすべてのユーザーのコレクションを取得します。
GetAllUsers(Int32, Int32, Int32)	データベース内のすべてのユーザーのコレクションをページで取得します。
GetNumberOfUsersOnline()	アプリケーションに現在アクセスしているユーザーの数を取得します。
GetUser()	データソースから情報を取得し、現在ログオンしているメンバーシップユーザーの最終利用日時スタンプを更新します。
GetUser(Boolean)	現在ログオンしているメンバーシップユーザーの情報をデータソースから取得します。現在ログオンしているメンバーシップユーザーの最終利用日時スタンプを更新するように指定することもできます。
GetUser(Object)	指定した一意の ID と関連付けられているメンバーシップユーザーの情報をデータソースから取得します。
GetUser(Object, Boolean)	指定した一意の ID と関連付けられているメンバーシップユーザーの情報をデータソースから取得します。そのユーザーの最終利用日時スタンプを更新するように指定することもできます。
GetUser(String)	指定したメンバーシップユーザーの情報をデータソースから取得します。
GetUser(String, Boolean)	指定したメンバーシップユーザーの情報をデータソースから取得します。そのユーザーの最終利用日時スタンプを更新するように指定することもできます。
GetUserNameByEmail(String)	電子メールアドレスが指定内容と一致するユーザー名を取得します。
UpdateUser(MembershipUser)	指定したユーザーの情報でデータベースを更新します。
ValidateUser(String, String)	指定されたユーザー名とパスワードが有効かどうかを検証します。

events

ValidatingPassword

ユーザーが作成されるとき、パスワードが変更されるとき、またはリセットされるときに発生します。

適用対象

こちらもご覧ください

メンバーシップの概要