ClientFormsAuthenticationMembershipProvider クラス

リファレンス

定義

名前空間:: System.Web.ClientServices.Providers

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

重要

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

クライアントアプリケーションサービスでフォーム認証を有効にします。

public ref class ClientFormsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider

public class ClientFormsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider

type ClientFormsAuthenticationMembershipProvider = class
    inherit MembershipProvider

Public Class ClientFormsAuthenticationMembershipProvider
Inherits MembershipProvider

継承: Object

ProviderBase

MembershipProvider
ClientFormsAuthenticationMembershipProvider

例

次のコード例は、このメソッドを使用して、IClientFormsAuthenticationCredentialsProvider 実装を使用してユーザーを検証する方法を示しています。

private bool ValidateUsingCredentialsProvider()
{
    bool isAuthorized = false;
    try
    {
        ClientFormsAuthenticationMembershipProvider authProvider =
            System.Web.Security.Membership.Provider as
            ClientFormsAuthenticationMembershipProvider;

        // Call ValidateUser with empty strings in order to display the 
        // login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty);
    }
    catch (System.Net.WebException)
    {
        MessageBox.Show("Unable to access the authentication service.",
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
    if (!isAuthorized)
    {
        MessageBox.Show("Unable to authenticate.", "Not logged in", 
            MessageBoxButtons.OK, MessageBoxIcon.Error);
        Application.Exit();
    }
    return isAuthorized;
}

Private Function ValidateUsingCredentialsProvider() As Boolean

    Dim isAuthorized As Boolean = False

    Try

        Dim authProvider As ClientFormsAuthenticationMembershipProvider = _
            CType(System.Web.Security.Membership.Provider,  _
            ClientFormsAuthenticationMembershipProvider)

        ' Call ValidateUser with empty strings in order to display the 
        ' login dialog box configured as a credentials provider.
        isAuthorized = authProvider.ValidateUser(String.Empty, String.Empty)

    Catch ex As System.Net.WebException

        MessageBox.Show("Unable to access the authentication service.", _
            "Warning", MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End Try

    If Not isAuthorized Then

        MessageBox.Show("Unable to authenticate.", "Not logged in", _
            MessageBoxButtons.OK, MessageBoxIcon.Error)
        Application.Exit()

    End If

    Return isAuthorized

End Function

注釈

クライアントアプリケーションサービスを使用して、フォーム認証を使用してユーザーを検証できます。フォーム認証を有効にするには、ClientFormsAuthenticationMembershipProvider クラスを使用するようにアプリケーションを構成します。

構成後、ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) メソッドを内部的に呼び出す staticMembership.ValidateUser メソッドを呼び出すことによって、ユーザーを検証できます。

フォーム認証では、ユーザーがアプリケーションによって提供されるログインコントロールを使用して資格情報を指定する必要があります。資格情報を取得し、Membership.ValidateUser メソッドに渡すことができます。空の文字列や null を渡して、資格情報プロバイダーを使用することもできます。資格情報プロバイダーは、アプリケーション構成ファイルで指定された IClientFormsAuthenticationCredentialsProvider 実装です。通常は、ログインダイアログボックスを表示し、設定された ClientFormsAuthenticationCredentials オブジェクトを返す IClientFormsAuthenticationCredentialsProvider.GetCredentials メソッドを実装します。資格情報プロバイダーを使用すると、複数のアプリケーション間で 1 つのログインダイアログボックスを共有できます。

ClientFormsAuthenticationMembershipProvider.ValidateUser メソッドは、ServiceUri プロパティによって示されるログインサービスを使用してユーザーを認証します。通常、ServiceUri プロパティの値は、他の構成値と共にアプリケーション構成ファイルから取得されます。

ユーザーが正常に認証されると、サービスプロバイダーは、staticThread.CurrentPrincipal プロパティを、ユーザー情報を含む新しい ClientFormsIdentity オブジェクトを含む新しい ClientRolePrincipal オブジェクトに設定します。 ClientRoleProvider がアプリケーション用に構成されている場合は、ClientRolePrincipal オブジェクトを使用してロールサービスからユーザーロール情報を取得できます。

static Membership.Provider プロパティを使用して、現在の ClientFormsAuthenticationMembershipProvider インスタンスへの参照を取得できます。メンバーシッププロバイダー参照を使用して、ClientFormsAuthenticationMembershipProvider.ValidateUser メソッドを直接呼び出すことができます。さらに、MembershipProvider 基底クラスでは使用できない Logout メソッドを呼び出すには、メンバーシッププロバイダー参照が必要です。

ClientFormsAuthenticationMembershipProvider クラスを使用してメンバーシップ情報を作成、削除、または変更することはできません。ユーザーを作成、削除、または変更するには、サーバー上のログインサービスの構成を変更する必要があります。

コンストラクター

ClientFormsAuthenticationMembershipProvider()

ClientFormsAuthenticationMembershipProvider クラスの新しいインスタンスを初期化します。

プロパティ

ApplicationName	このプロパティは、このクラスでは使用されません。
Description	管理ツールやその他のユーザーインターフェイス (UI) での表示に適した簡単でわかりやすい説明を取得します。 (継承元 ProviderBase)
EnablePasswordReset	このプロパティは、このクラスでは使用されません。
EnablePasswordRetrieval	このプロパティは、このクラスでは使用されません。
MaxInvalidPasswordAttempts	このプロパティは、このクラスでは使用されません。
MinRequiredNonAlphanumericCharacters	このプロパティは、このクラスでは使用されません。
MinRequiredPasswordLength	このプロパティは、このクラスでは使用されません。
Name	構成時にプロバイダーを参照するために使用されるフレンドリ名を取得します。 (継承元 ProviderBase)
PasswordAttemptWindow	このプロパティは、このクラスでは使用されません。
PasswordFormat	このプロパティは、このクラスでは使用されません。
PasswordStrengthRegularExpression	このプロパティは、このクラスでは使用されません。
RequiresQuestionAndAnswer	このプロパティは、このクラスでは使用されません。
RequiresUniqueEmail	このプロパティは、このクラスでは使用されません。
ServiceUri	認証サービスの URI を取得または設定します。

メソッド

ChangePassword(String, String, String)	このメソッドは、このクラスでは使用されません。
ChangePasswordQuestionAndAnswer(String, String, String, String)	このメソッドは、このクラスでは使用されません。
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)	このメソッドは、このクラスでは使用されません。
DecryptPassword(Byte[])	暗号化されたパスワードを復号化します。 (継承元 MembershipProvider)
DeleteUser(String, Boolean)	このメソッドは、このクラスでは使用されません。
EncryptPassword(Byte[])	パスワードを暗号化します。 (継承元 MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)	指定したパスワード互換モードを使用して、指定したパスワードを暗号化します。 (継承元 MembershipProvider)
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FindUsersByEmail(String, Int32, Int32, Int32)	このメソッドは、このクラスでは使用されません。
FindUsersByName(String, Int32, Int32, Int32)	このメソッドは、このクラスでは使用されません。
GetAllUsers(Int32, Int32, Int32)	このメソッドは、このクラスでは使用されません。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetNumberOfUsersOnline()	このメソッドは、このクラスでは使用されません。
GetPassword(String, String)	このメソッドは、このクラスでは使用されません。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetUser(Object, Boolean)	このメソッドは、このクラスでは使用されません。
GetUser(String, Boolean)	このメソッドは、このクラスでは使用されません。
GetUserNameByEmail(String)	このメソッドは、このクラスでは使用されません。
Initialize(String, NameValueCollection)	プロバイダーを初期化します。
Logout()	ユーザーをログアウトします。
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
OnValidatingPassword(ValidatePasswordEventArgs)	イベントハンドラーが定義されている場合は、ValidatingPassword イベントを発生させます。 (継承元 MembershipProvider)
ResetPassword(String, String)	このメソッドは、このクラスでは使用されません。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
UnlockUser(String)	このメソッドは、このクラスでは使用されません。
UpdateUser(MembershipUser)	このメソッドは、このクラスでは使用されません。
ValidateUser(String, String)	指定したユーザー名とパスワードを使用してユーザーを認証します。
ValidateUser(String, String, Boolean)	指定したユーザー名とパスワードを使用してユーザーを認証し、必要に応じてパスワードのハッシュをローカルデータキャッシュに格納します。
ValidateUser(String, String, String)	指定したユーザー名とパスワードを使用して、指定したサービス URI でユーザーを認証します。

イベント

UserValidated	ユーザーが検証されたときに発生します。
ValidatingPassword	ユーザーが作成されたとき、パスワードが変更されたとき、またはパスワードがリセットされたときに発生します。 (継承元 MembershipProvider)

適用対象

こちらもご覧ください

ValidateUser
ValidateUser(String, String)
クライアントアプリケーションサービスの
方法: クライアントアプリケーションサービスのを構成する
方法: クライアントアプリケーションサービスを使用してユーザーログインとログアウトを実装する

次の方法で共有