ClientFormsAuthenticationMembershipProvider ClientFormsAuthenticationMembershipProvider ClientFormsAuthenticationMembershipProvider ClientFormsAuthenticationMembershipProvider Class

定義

クライアント アプリケーション サービスでフォーム認証を有効にします。Enables forms authentication with client application services.

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
継承
ClientFormsAuthenticationMembershipProviderClientFormsAuthenticationMembershipProviderClientFormsAuthenticationMembershipProviderClientFormsAuthenticationMembershipProvider

次のコード例は、このメソッドを使用して、 IClientFormsAuthenticationCredentialsProvider実装を使用してユーザーを検証する方法を示しています。The following example code demonstrates how to use this method to validate the user by using an IClientFormsAuthenticationCredentialsProvider implementation.

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

注釈

クライアントアプリケーションサービスを使用して、フォーム認証を使用してユーザーを検証できます。You can use client application services to validate users by using forms authentication. フォーム認証を有効にするには、 ClientFormsAuthenticationMembershipProviderクラスを使用するようにアプリケーションを構成します。To enable forms authentication, you configure your application to use the ClientFormsAuthenticationMembershipProvider class. 詳細については、「 How to: Configure Client Application Services」を参照してください。For more information, see How to: Configure Client Application Services.

構成後は、メソッドを呼び出すstatic Membership.ValidateUserことによってユーザーを検証できClientFormsAuthenticationMembershipProvider.ValidateUser(String, String)ます。メソッドは、内部的にメソッドを呼び出します。After configuration, you can validate users by calling the static Membership.ValidateUser method, which internally calls the ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) method.

フォーム認証では、ユーザーがアプリケーションによって提供されるログインコントロールを使用して資格情報を指定する必要があります。Forms authentication requires that the user specify their credentials through login controls provided by your application. 資格情報を取得し、 Membership.ValidateUserメソッドに渡すことができます。You can retrieve the credentials and pass them to the Membership.ValidateUser method. またnull 、空の文字列を渡すことも、資格情報プロバイダーを使用することもできます。You can also pass in empty strings or null to use a credentials provider. 資格情報プロバイダーはIClientFormsAuthenticationCredentialsProvider 、アプリケーション構成ファイルで指定された実装です。A credentials provider is an IClientFormsAuthenticationCredentialsProvider implementation specified in your application configuration file. 通常は、ログインダイアログIClientFormsAuthenticationCredentialsProvider.GetCredentialsボックスを表示し、設定ClientFormsAuthenticationCredentialsされたオブジェクトを返すメソッドを実装します。You will typically implement the IClientFormsAuthenticationCredentialsProvider.GetCredentials method to display a login dialog box and return a populated ClientFormsAuthenticationCredentials object. 資格情報プロバイダーを使用することにより、複数のアプリケーション間で同じログイン ダイアログ ボックスを共有できます。Using a credentials provider enables you to share a single login dialog box among multiple applications.

メソッドClientFormsAuthenticationMembershipProvider.ValidateUserは、 ServiceUriプロパティで指定されたログインサービスを介してユーザーを認証します。The ClientFormsAuthenticationMembershipProvider.ValidateUser method authenticates users through the login service indicated by the ServiceUri property. 通常、 ServiceUriプロパティの値は、アプリケーション構成ファイルから他の構成値と共に取得されます。The value of the ServiceUri property is typically retrieved from the application configuration file along with other configuration values. 詳細については、「 How to: Configure Client Application Services」を参照してください。For more information, see How to: Configure Client Application Services.

ユーザーが正常に認証されると、サービスプロバイダーはstatic 、ユーザー情報をClientRolePrincipal格納する新しいClientFormsIdentityオブジェクトを含む新しいオブジェクトにThread.CurrentPrincipalプロパティを設定します。If the user is successfully authenticated, the service provider sets the static Thread.CurrentPrincipal property to a new ClientRolePrincipal object that contains a new ClientFormsIdentity object that contains the user information. アプリケーション用にClientRolePrincipal が構成されている場合は、オブジェクトを使用して、ロールサービスからユーザーロール情報をClientRoleProvider取得できます。If a ClientRoleProvider is configured for your application, you can use the ClientRolePrincipal object to retrieve user role information from the roles service.

現在ClientFormsAuthenticationMembershipProviderのインスタンスへの参照を取得するにはstaticMembership.Providerプロパティを使用します。You can retrieve a reference to the current ClientFormsAuthenticationMembershipProvider instance through the static Membership.Provider property. メンバーシッププロバイダーの参照を使用して、 ClientFormsAuthenticationMembershipProvider.ValidateUserメソッドを直接呼び出すことができます。You can use the membership provider reference to call the ClientFormsAuthenticationMembershipProvider.ValidateUser method directly. また、 Logout MembershipProvider基本クラスでは使用できないメソッドを呼び出すために、メンバーシッププロバイダー参照が必要になります。Additionally, you will need the membership provider reference to call the Logout method, which is not available in the MembershipProvider base class.

クラスを使用しClientFormsAuthenticationMembershipProviderてメンバーシップ情報を作成、削除、または変更することはできません。You cannot use the ClientFormsAuthenticationMembershipProvider class to create, delete, or modify membership information. ユーザーを作成、削除、または変更するには、サーバーのログインサービスの構成を変更する必要があります。To create, delete, or modify users, you must change the configuration of the login service on the server.

コンストラクター

ClientFormsAuthenticationMembershipProvider() ClientFormsAuthenticationMembershipProvider() ClientFormsAuthenticationMembershipProvider() ClientFormsAuthenticationMembershipProvider()

ClientFormsAuthenticationMembershipProvider クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClientFormsAuthenticationMembershipProvider class.

プロパティ

ApplicationName ApplicationName ApplicationName ApplicationName

このプロパティは、このクラスでは使用されません。This property is not used by this class.

Description Description Description Description

管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
EnablePasswordReset EnablePasswordReset EnablePasswordReset EnablePasswordReset

このプロパティは、このクラスでは使用されません。This property is not used by this class.

EnablePasswordRetrieval EnablePasswordRetrieval EnablePasswordRetrieval EnablePasswordRetrieval

このプロパティは、このクラスでは使用されません。This property is not used by this class.

MaxInvalidPasswordAttempts MaxInvalidPasswordAttempts MaxInvalidPasswordAttempts MaxInvalidPasswordAttempts

このプロパティは、このクラスでは使用されません。This property is not used by this class.

MinRequiredNonAlphanumericCharacters MinRequiredNonAlphanumericCharacters MinRequiredNonAlphanumericCharacters MinRequiredNonAlphanumericCharacters

このプロパティは、このクラスでは使用されません。This property is not used by this class.

MinRequiredPasswordLength MinRequiredPasswordLength MinRequiredPasswordLength MinRequiredPasswordLength

このプロパティは、このクラスでは使用されません。This property is not used by this class.

Name Name Name Name

構成時にプロバイダーを参照するために使用される表示名を取得します。Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)
PasswordAttemptWindow PasswordAttemptWindow PasswordAttemptWindow PasswordAttemptWindow

このプロパティは、このクラスでは使用されません。This property is not used by this class.

PasswordFormat PasswordFormat PasswordFormat PasswordFormat

このプロパティは、このクラスでは使用されません。This property is not used by this class.

PasswordStrengthRegularExpression PasswordStrengthRegularExpression PasswordStrengthRegularExpression PasswordStrengthRegularExpression

このプロパティは、このクラスでは使用されません。This property is not used by this class.

RequiresQuestionAndAnswer RequiresQuestionAndAnswer RequiresQuestionAndAnswer RequiresQuestionAndAnswer

このプロパティは、このクラスでは使用されません。This property is not used by this class.

RequiresUniqueEmail RequiresUniqueEmail RequiresUniqueEmail RequiresUniqueEmail

このプロパティは、このクラスでは使用されません。This property is not used by this class.

ServiceUri ServiceUri ServiceUri ServiceUri

認証サービスの URI を取得または設定します。Gets or sets the URI of the authentication service.

メソッド

ChangePassword(String, String, String) ChangePassword(String, String, String) ChangePassword(String, String, String) ChangePassword(String, String, String)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

ChangePasswordQuestionAndAnswer(String, String, String, String) ChangePasswordQuestionAndAnswer(String, String, String, String) ChangePasswordQuestionAndAnswer(String, String, String, String) ChangePasswordQuestionAndAnswer(String, String, String, String)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

DecryptPassword(Byte[]) DecryptPassword(Byte[]) DecryptPassword(Byte[]) DecryptPassword(Byte[])

暗号化されたパスワードを復号化します。Decrypts an encrypted password.

(Inherited from MembershipProvider)
DeleteUser(String, Boolean) DeleteUser(String, Boolean) DeleteUser(String, Boolean) DeleteUser(String, Boolean)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

EncryptPassword(Byte[]) EncryptPassword(Byte[]) EncryptPassword(Byte[]) EncryptPassword(Byte[])

パスワードを暗号化します。Encrypts a password.

(Inherited from MembershipProvider)
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) EncryptPassword(Byte[], MembershipPasswordCompatibilityMode)

指定されたパスワード互換モードを使用して、指定されたパスワードを暗号化します。Encrypts the specified password using the specified password-compatibility mode.

(Inherited from MembershipProvider)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindUsersByEmail(String, Int32, Int32, Int32) FindUsersByEmail(String, Int32, Int32, Int32) FindUsersByEmail(String, Int32, Int32, Int32) FindUsersByEmail(String, Int32, Int32, Int32)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

FindUsersByName(String, Int32, Int32, Int32) FindUsersByName(String, Int32, Int32, Int32) FindUsersByName(String, Int32, Int32, Int32) FindUsersByName(String, Int32, Int32, Int32)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

GetAllUsers(Int32, Int32, Int32) GetAllUsers(Int32, Int32, Int32) GetAllUsers(Int32, Int32, Int32) GetAllUsers(Int32, Int32, Int32)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetNumberOfUsersOnline() GetNumberOfUsersOnline() GetNumberOfUsersOnline() GetNumberOfUsersOnline()

このメソッドは、このクラスでは使用されません。This method is not used by this class.

GetPassword(String, String) GetPassword(String, String) GetPassword(String, String) GetPassword(String, String)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
GetUser(Object, Boolean) GetUser(Object, Boolean) GetUser(Object, Boolean) GetUser(Object, Boolean)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

GetUser(String, Boolean) GetUser(String, Boolean) GetUser(String, Boolean) GetUser(String, Boolean)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

GetUserNameByEmail(String) GetUserNameByEmail(String) GetUserNameByEmail(String) GetUserNameByEmail(String)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

プロバイダーを初期化します。Initializes the provider.

Logout() Logout() Logout() Logout()

ユーザーをログアウトします。Logs out the user.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
OnValidatingPassword(ValidatePasswordEventArgs) OnValidatingPassword(ValidatePasswordEventArgs) OnValidatingPassword(ValidatePasswordEventArgs) OnValidatingPassword(ValidatePasswordEventArgs)

イベント ハンドラーが定義されている場合に ValidatingPassword イベントを発生させます。Raises the ValidatingPassword event if an event handler has been defined.

(Inherited from MembershipProvider)
ResetPassword(String, String) ResetPassword(String, String) ResetPassword(String, String) ResetPassword(String, String)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
UnlockUser(String) UnlockUser(String) UnlockUser(String) UnlockUser(String)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

UpdateUser(MembershipUser) UpdateUser(MembershipUser) UpdateUser(MembershipUser) UpdateUser(MembershipUser)

このメソッドは、このクラスでは使用されません。This method is not used by this class.

ValidateUser(String, String) ValidateUser(String, String) ValidateUser(String, String) ValidateUser(String, String)

指定したユーザー名とパスワードを使用してユーザーを認証します。Authenticates a user by using the specified user name and password.

ValidateUser(String, String, Boolean) ValidateUser(String, String, Boolean) ValidateUser(String, String, Boolean) ValidateUser(String, String, Boolean)

指定したユーザー名とパスワードを使用してユーザーを認証します。オプションでパスワードのハッシュをローカルのデータ キャッシュに格納することもできます。Authenticates a user by using the specified user name and password, optionally storing a hash of the password in the local data cache.

ValidateUser(String, String, String) ValidateUser(String, String, String) ValidateUser(String, String, String) ValidateUser(String, String, String)

指定したサービス URI で、指定したユーザー名とパスワードを使用してユーザーを認証します。Authenticates a user at the specified service URI by using the specified user name and password.

イベント

UserValidated UserValidated UserValidated UserValidated

ユーザーの検証時に発生します。Occurs when the user is validated.

ValidatingPassword ValidatingPassword ValidatingPassword ValidatingPassword

ユーザーが作成されるとき、パスワードが変更されるとき、またはパスワードがリセットされるときに発生します。Occurs when a user is created, a password is changed, or a password is reset.

(Inherited from MembershipProvider)

適用対象

こちらもご覧ください