ClientFormsAuthenticationMembershipProvider クラス

定義

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 構成します。

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

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

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

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

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

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

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

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