ClientFormsAuthenticationMembershipProvider.ValidateUser ClientFormsAuthenticationMembershipProvider.ValidateUser ClientFormsAuthenticationMembershipProvider.ValidateUser ClientFormsAuthenticationMembershipProvider.ValidateUser Method

定義

指定した資格情報を使用してユーザーを認証します。Authenticates a user by using the specified credentials.

オーバーロード

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.

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

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

public:
 override bool ValidateUser(System::String ^ username, System::String ^ password);
public override bool ValidateUser (string username, string password);
override this.ValidateUser : string * string -> bool
Public Overrides Function ValidateUser (username As String, password As String) As Boolean

パラメーター

username
String String String String

認証するユーザーの名前。このアプリケーション構成で使用するように構成されている Empty の実装から資格情報を取得する場合は IClientFormsAuthenticationCredentialsProvider または nullThe name of the user to authenticate, or Empty or null to retrieve credentials from the IClientFormsAuthenticationCredentialsProvider implementation that this application is configured to use.

password
String String String String

認証するユーザーのパスワード。The password of the user to authenticate.

戻り値

ユーザーが認証されている場合は true。それ以外の場合は falsetrue if the user was authenticated; otherwise, false.

例外

IsOffline プロパティの値が false で、メンバーシップ プロバイダーが認証サービスにアクセスできません。The IsOffline property value is false and the membership provider is unable to access the authentication service.

次のコード例は、このメソッドを使用して、 IClientFormsAuthenticationCredentialsProvider実装を使用してユーザーを検証する方法を示しています。The following example code demonstrates how to use this method to validate the user by using an IClientFormsAuthenticationCredentialsProvider implementation. この例では、資格情報プロバイダーを使用するようにアプリケーションを構成する必要があります。This example requires that you to configure your application to use a credentials provider. 詳細については、「 How to: Configure Client Application Services」を参照してください。For more information, see How to: Configure Client Application Services.

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. ユーザーを検証するには、通常、 staticメソッドを呼び出しMembership.ValidateUserます。このClientFormsAuthenticationMembershipProvider.ValidateUserメソッドは、内部的にメソッドを呼び出します。To validate users, you will typically call the static Membership.ValidateUser method, which internally calls the ClientFormsAuthenticationMembershipProvider.ValidateUser method. または、「例」のセクションに示されているように、このメソッドを直接呼び出すこともできます。Alternatively, you can call this method directly, as shown in the Example section.

フォーム認証では、ユーザーがアプリケーションによって提供されるログインコントロールを使用して資格情報を指定する必要があります。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. 詳細については、「方法: クライアント アプリケーション サービスでユーザーのログインを実装する」を参照してください。For more information, see How to: Implement User Login with Client Application Services.

こちらもご覧ください

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.

public:
 bool ValidateUser(System::String ^ username, System::String ^ password, bool rememberMe);
public bool ValidateUser (string username, string password, bool rememberMe);
override this.ValidateUser : string * string * bool -> bool
Public Function ValidateUser (username As String, password As String, rememberMe As Boolean) As Boolean

パラメーター

username
String String String String

認証対象のユーザー名。The name of the user to authenticate.

password
String String String String

認証するユーザーのパスワード。The password of the user to authenticate.

rememberMe
Boolean Boolean Boolean Boolean

オフラインでの使用、および、ユーザーの認証クッキーの期限が切れたときの自動再認証のためにパスワードのハッシュをローカルのデータ キャッシュに格納する場合は、true。オフライン ログインを無効にする場合、または、クッキーの期限が切れた時に再認証を要求する場合は falsetrue to store a hash of the password in the local data cache for offline use and for automatic reauthentication when the user authentication cookie expires; false to disable offline login or to require users to reauthenticate when the cookie expires.

戻り値

ユーザーが認証されている場合は true。それ以外の場合は falsetrue if the user was authenticated; otherwise, false.

例外

IsOffline プロパティの値が false で、メンバーシップ プロバイダーが認証サービスにアクセスできません。The IsOffline property value is false and the membership provider is unable to access the authentication service.

次のコード例は、このメソッドを使用して、アプリケーションコードでログイン制御を使用してユーザーを検証する方法を示しています。The following example code demonstrates how to use this method to validate the user by using login controls in your application code. このTextBoxCheckBox rememberMeCheckBoxusernameTextBoxは、とpasswordTextBoxいう名前のコントロール、という名前のコントロール、およびという名前のコントロールが必要です。 TextBoxThis example requires a TextBox control named usernameTextBox, a TextBox control named passwordTextBox, and a CheckBox control named rememberMeCheckBox.

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

        // Call ValidateUser with credentials retrieved from login controls.
        isAuthorized = authProvider.ValidateUser(usernameTextBox.Text,
            passwordTextBox.Text, rememberMeCheckBox.Checked);
    }
    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 ValidateUsingLoginControls() As Boolean

    Dim isAuthorized As Boolean = False

    Try

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

        ' Call ValidateUser with credentials retrieved from login controls.
        isAuthorized = authProvider.ValidateUser(usernameTextBox.Text, _
            passwordTextBox.Text, rememberMeCheckBox.Checked)

    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. ユーザーを検証するには、通常、 staticメソッドを呼び出しMembership.ValidateUserます。このClientFormsAuthenticationMembershipProvider.ValidateUser(String, String)メソッドは、内部的にメソッドを呼び出します。To validate users, you will typically call the static Membership.ValidateUser method, which internally calls the ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) method. または、 ClientFormsAuthenticationMembershipProvider.ValidateUserメソッドを直接呼び出すこともできます。Alternatively, you can call the ClientFormsAuthenticationMembershipProvider.ValidateUser method directly. このオーバーロードを呼び出しrememberMe usernameて、値と値に加えてpassword値を渡すことができます。You can call this overload to pass in a rememberMe value in addition to the username and password values.

こちらもご覧ください

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.

public:
 static bool ValidateUser(System::String ^ username, System::String ^ password, System::String ^ serviceUri);
public static bool ValidateUser (string username, string password, string serviceUri);
static member ValidateUser : string * string * string -> bool
Public Shared Function ValidateUser (username As String, password As String, serviceUri As String) As Boolean

パラメーター

username
String String String String

認証対象のユーザー名。The name of the user to authenticate.

password
String String String String

認証するユーザーのパスワード。The password of the user to authenticate.

serviceUri
String String String String

使用する認証サービスの URI。The URI of the authentication service to use.

戻り値

ユーザーが認証されている場合は true。それ以外の場合は falsetrue if the user was authenticated; otherwise, false.

例外

IsOffline プロパティの値が false で、メンバーシップ プロバイダーが認証サービスにアクセスできません。The IsOffline property value is false and the membership provider is unable to access the authentication service.

次のコード例は、このメソッドを使用して、指定された場所で認証サービスを介してユーザーを検証する方法を示しています。The following example code demonstrates how to use this method to validate the user through an authentication service at a specified location. ユーザーの資格情報は、アプリケーションコードのログイン制御から取得されます。The user credentials are retrieved from login controls in your application code. この例usernameTextBoxではTextBox 、という名前TextBoxのコントロールpasswordTextBoxとという名前のコントロールが必要です。This example requires a TextBox control named usernameTextBox and a TextBox control named passwordTextBox.

private bool ValidateUsingServiceUri(String serviceUri)
{
    bool isAuthorized = false;
    try
    {
        // Call the static overload of ValidateUser. Specify credentials 
        // retrieved from login controls and the service location.
        isAuthorized = 
            ClientFormsAuthenticationMembershipProvider.ValidateUser(
            usernameTextBox.Text, passwordTextBox.Text, serviceUri);
    }
    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 ValidateUsingServiceUri(ByVal serviceUri As String) As Boolean

    Dim isAuthorized As Boolean = False

    Try

        ' Call the Shared overload of ValidateUser. Specify credentials 
        ' retrieved from login controls and the service location.
        isAuthorized = _
            ClientFormsAuthenticationMembershipProvider.ValidateUser( _
            usernameTextBox.Text, passwordTextBox.Text, serviceUri)

    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. ユーザーを検証するには、通常、 staticメソッドを呼び出しMembership.ValidateUserます。このClientFormsAuthenticationMembershipProvider.ValidateUserメソッドは、内部的にメソッドを呼び出します。To validate users, you will typically call the static Membership.ValidateUser method, which internally calls the ClientFormsAuthenticationMembershipProvider.ValidateUser method. または、 ClientFormsAuthenticationMembershipProvider.ValidateUserメソッドを直接呼び出すこともできます。Alternatively, you can call the ClientFormsAuthenticationMembershipProvider.ValidateUser method directly. このオーバーロードを呼び出して、 serviceUriパラメーターで指定した場所にある認証サービスにアクセスできます。You can call this overload to access an authentication service at the location specified by the serviceUri parameter. このオーバーロードは、 ServiceUriプロパティを設定し、 ValidateUser(String, String)オーバーロードを呼び出すための代替手段です。Using this overload is an alternative to setting the ServiceUri property and calling the ValidateUser(String, String) overload.

こちらもご覧ください

適用対象