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 전달하여 자격 증명 공급자를 사용할 수도 있습니다.

추가 정보

적용 대상

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

true 사용자 인증 쿠키가 만료되면 오프라인 사용 및 자동 재인증에 대한 로컬 데이터 캐시에 암호 해시를 저장합니다. 오프라인 로그인을 사용하지 않도록 설정하거나 쿠키가 만료되면 사용자가 다시 인증하도록 요구하는 false.

반환

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, 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) 오버로드를 호출할 수 있습니다.

추가 정보

적용 대상

다음을 통해 공유

ClientFormsAuthenticationMembershipProvider.ValidateUser 메서드

정의

오버로드

ValidateUser(String, String)

매개 변수

반환

예외

예제

설명

추가 정보

적용 대상

ValidateUser(String, String, Boolean)

매개 변수

반환

예외

예제

설명

추가 정보

적용 대상

ValidateUser(String, String, String)

매개 변수

반환

예외

예제

설명

추가 정보

적용 대상

추가 리소스