ClientFormsAuthenticationMembershipProvider.ValidateUser メソッド

リファレンス

定義

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

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

重要

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

指定した資格情報を使用してユーザーを認証します。

オーバーロード

ValidateUser(String, String)	指定したユーザー名とパスワードを使用してユーザーを認証します。
ValidateUser(String, String, Boolean)	指定したユーザー名とパスワードを使用してユーザーを認証し、必要に応じてパスワードのハッシュをローカルデータキャッシュに格納します。
ValidateUser(String, String, String)	指定したユーザー名とパスワードを使用して、指定したサービス URI でユーザーを認証します。

ValidateUser(String, String)

指定したユーザー名とパスワードを使用してユーザーを認証します。

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

認証するユーザーの名前。このアプリケーションが使用するように構成されている IClientFormsAuthenticationCredentialsProvider の実装から資格情報を取得するために Empty または null。

password: String

認証するユーザーのパスワード。

戻り値

Boolean

ユーザーが認証されたかどうかを true します。それ以外の場合は、falseします。

例外

WebException

IsOffline プロパティの値が false され、メンバーシッププロバイダーが認証サービスにアクセスできません。

例

次のコード例は、このメソッドを使用して、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

注釈

フォーム認証では、ユーザーがアプリケーションによって提供されるログインコントロールを使用して資格情報を指定する必要があります。資格情報を取得し、Membership.ValidateUser メソッドに渡すことができます。空の文字列や null を渡して、資格情報プロバイダーを使用することもできます。

こちらもご覧ください

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

適用対象

ValidateUser(String, String, Boolean)

指定したユーザー名とパスワードを使用してユーザーを認証し、必要に応じてパスワードのハッシュをローカルデータキャッシュに格納します。

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

認証するユーザーの名前。

password: String

認証するユーザーのパスワード。

rememberMe: Boolean

オフラインで使用するため、およびユーザー認証 Cookie の有効期限が切れたときの自動再認証のために、パスワードのハッシュをローカルデータキャッシュに格納する true。false、オフラインログインを無効にするか、Cookie の有効期限が切れたときにユーザーに再認証を要求します。

戻り値

Boolean

ユーザーが認証されたかどうかを true します。それ以外の場合は、falseします。

例外

WebException

IsOffline プロパティの値が false され、メンバーシッププロバイダーが認証サービスにアクセスできません。

例

次のコード例は、このメソッドを使用して、アプリケーションコードでログインコントロールを使用してユーザーを検証する方法を示しています。この例では、usernameTextBoxという名前の TextBox コントロール、passwordTextBoxという名前の TextBox コントロール、および rememberMeCheckBoxという名前の CheckBox コントロールが必要です。

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

注釈

クライアントアプリケーションサービスを使用して、フォーム認証を使用してユーザーを検証できます。ユーザーを検証するには、通常、ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) メソッドを内部的に呼び出す staticMembership.ValidateUser メソッドを呼び出します。または、ClientFormsAuthenticationMembershipProvider.ValidateUser メソッドを直接呼び出すことができます。このオーバーロードを呼び出して、username 値と password 値に加えて rememberMe 値を渡すことができます。

こちらもご覧ください

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

適用対象

ValidateUser(String, String, String)

指定したユーザー名とパスワードを使用して、指定したサービス URI でユーザーを認証します。

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

認証するユーザーの名前。

password: String

認証するユーザーのパスワード。

serviceUri: String

使用する認証サービスの URI。

戻り値

Boolean

ユーザーが認証されたかどうかを true します。それ以外の場合は、falseします。

例外

WebException

IsOffline プロパティの値が false され、メンバーシッププロバイダーが認証サービスにアクセスできません。

例

次のコード例は、このメソッドを使用して、指定した場所にある認証サービスを通じてユーザーを検証する方法を示しています。ユーザー資格情報は、アプリケーションコードのログインコントロールから取得されます。この例では、usernameTextBox という名前の TextBox コントロールと、passwordTextBoxという名前の TextBox コントロールが必要です。

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

注釈

クライアントアプリケーションサービスを使用して、フォーム認証を使用してユーザーを検証できます。ユーザーを検証するには、通常、ClientFormsAuthenticationMembershipProvider.ValidateUser メソッドを内部的に呼び出す staticMembership.ValidateUser メソッドを呼び出します。または、ClientFormsAuthenticationMembershipProvider.ValidateUser メソッドを直接呼び出すことができます。このオーバーロードを呼び出して、serviceUri パラメーターで指定された場所にある認証サービスにアクセスできます。このオーバーロードを使用することは、ServiceUri プロパティを設定し、ValidateUser(String, String) オーバーロードを呼び出す代わりに使用します。

こちらもご覧ください

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

適用対象

次の方法で共有

ClientFormsAuthenticationMembershipProvider.ValidateUser メソッド

定義

オーバーロード

ValidateUser(String, String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ValidateUser(String, String, Boolean)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

ValidateUser(String, String, String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース