ClientFormsAuthenticationMembershipProvider.ValidateUser 方法

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

参数

返回

如果用户已经过验证，则为 true；否则为 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

注解

可以使用客户端应用程序服务通过表单身份验证来验证用户。 若要验证用户，通常会调用 staticMembership.ValidateUser 方法，该方法在内部调用 ClientFormsAuthenticationMembershipProvider.ValidateUser 方法。 或者，可以直接调用此方法，如示例部分所示。

表单身份验证要求用户通过应用程序提供的登录控件指定其凭据。 可以检索凭据并将其传递给 Membership.ValidateUser 方法。 还可以传入空字符串或使用 null 凭据提供程序。

另请参阅

• IClientFormsAuthenticationCredentialsProvider
• ValidateUser(String, String)
• 客户端应用程序服务
• 如何：配置客户端应用程序服务
• 如何：使用客户端应用程序服务实现用户登录和注销

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

参数

返回

如果用户已经过验证，则为 true；否则为 false。

例外

示例

以下示例代码演示如何使用此方法在应用程序代码中使用登录控件来验证用户。 此示例需要名为 TextBox 的控件、TextBox名为 usernameTextBox的passwordTextBox控件和名为 CheckBox 的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

注解

可以使用客户端应用程序服务通过表单身份验证来验证用户。 若要验证用户，通常会调用 staticMembership.ValidateUser 方法，该方法在内部调用 ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) 方法。 或者，可以直接调用 ClientFormsAuthenticationMembershipProvider.ValidateUser 方法。 可以调用此重载来传入 rememberMe 除 和 password 值外username的值。

另请参阅

• ValidateUser(String, String)
• 客户端应用程序服务
• 如何：配置客户端应用程序服务
• 如何：使用客户端应用程序服务实现用户登录和注销

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

参数

返回

如果用户已经过验证，则为 true；否则为 false。

例外

示例

以下示例代码演示如何使用此方法通过指定位置的身份验证服务验证用户。 从应用程序代码中的登录控件检索用户凭据。 此示例需要名为 TextBox 的 usernameTextBox 控件和 TextBox 名为 的 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

注解

可以使用客户端应用程序服务通过表单身份验证来验证用户。 若要验证用户，通常会调用 staticMembership.ValidateUser 方法，该方法在内部调用 ClientFormsAuthenticationMembershipProvider.ValidateUser 方法。 或者，可以直接调用 ClientFormsAuthenticationMembershipProvider.ValidateUser 方法。 可以调用此重载来访问参数指定 serviceUri 位置的身份验证服务。 使用此重载是设置 ServiceUri 属性和调用重载的 ValidateUser(String, String) 替代方法。

另请参阅

• ValidateUser(String, String)
• 客户端应用程序服务
• 如何：配置客户端应用程序服务
• 如何：使用客户端应用程序服务实现用户登录和注销