ClientFormsAuthenticationMembershipProvider.ValidateUser Methode

Definition

Namespace:

System.Web.ClientServices.Providers

Assembly:

System.Web.Extensions.dll

Authentifiziert einen Benutzer mit den angegebenen Anmeldeinformationen.

Überlädt

ValidateUser(String, String)	Authentifiziert einen Benutzer mit dem angegebenen Benutzernamen und dem angegebenen Kennwort.
ValidateUser(String, String, Boolean)	Authentifiziert einen Benutzer mit dem angegebenen Benutzernamen und dem angegebenen Kennwort und speichert optional einen Hashcode für das Kennwort im lokalen Datencache.
ValidateUser(String, String, String)	Authentifiziert einen Benutzer am angegebenen Dienst-URI mit dem angegebenen Benutzernamen und dem angegebenen Kennwort.

ValidateUser(String, String)

Authentifiziert einen Benutzer mit dem angegebenen Benutzernamen und dem angegebenen Kennwort.

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

Parameter

username

String

Der Name des Benutzers, der authentifiziert werden soll, oder Empty oder null, um die Anmeldeinformationen von der IClientFormsAuthenticationCredentialsProvider-Implementierung abzurufen, für die diese Anwendung konfiguriert wurde.

password

String

Das Kennwort für den Benutzer, der authentifiziert werden soll.

Gibt zurück

Boolean

true, wenn der Benutzer authentifiziert wurde, andernfalls false.

Ausnahmen

WebException

Der IsOffline-Eigenschaftswert ist false, und der Mitgliedschaftsanbieter kann nicht auf den Authentifizierungsdienst zugreifen.

Beispiele

Im folgenden Beispielcode wird veranschaulicht, wie Sie diese Methode verwenden, um den Benutzer mithilfe einer IClientFormsAuthenticationCredentialsProvider Implementierung zu überprüfen. In diesem Beispiel müssen Sie Ihre Anwendung so konfigurieren, dass sie einen Anmeldeinformationsanbieter verwendet.

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

Hinweise

Sie können Clientanwendungsdienste verwenden, um Benutzer mithilfe der Formularauthentifizierung zu überprüfen. Zum Überprüfen von Benutzern rufen Sie in der Regel die staticMembership.ValidateUser -Methode auf, die intern die ClientFormsAuthenticationMembershipProvider.ValidateUser -Methode aufruft. Alternativ können Sie diese Methode auch direkt aufrufen, wie im Abschnitt Beispiel gezeigt.

Die Formularauthentifizierung erfordert, dass der Benutzer seine Anmeldeinformationen über von Ihrer Anwendung bereitgestellte Anmeldesteuerelemente angibt. Sie können die Anmeldeinformationen abrufen und an die Membership.ValidateUser -Methode übergeben. Sie können auch leere Zeichenfolgen übergeben oder null einen Anmeldeinformationsanbieter verwenden.

Weitere Informationen

• IClientFormsAuthenticationCredentialsProvider
• ValidateUser(String, String)
• Clientanwendungsdienste
• Gewusst wie: Konfigurieren von Clientanwendungsdiensten
• Vorgehensweise: Implementieren der Benutzeranmeldung und -abmeldung mit Client Application Services

ValidateUser(String, String, Boolean)

Authentifiziert einen Benutzer mit dem angegebenen Benutzernamen und dem angegebenen Kennwort und speichert optional einen Hashcode für das Kennwort im lokalen Datencache.

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

Parameter

username

String

Der Name des zu authentifizierenden Benutzers.

password

String

Das Kennwort für den Benutzer, der authentifiziert werden soll.

rememberMe

Boolean

true, um einen Hashcode für das Kennwort im lokalen Datencache zu speichern, der auch offline verwendet werden kann und mit dem der Benutzer bei Ablauf des Authentifizierungscookies automatisch erneut authentifiziert werden kann, andernfalls false.

Gibt zurück

Boolean

true, wenn der Benutzer authentifiziert wurde, andernfalls false.

Ausnahmen

WebException

Der IsOffline-Eigenschaftswert ist false, und der Mitgliedschaftsanbieter kann nicht auf den Authentifizierungsdienst zugreifen.

Beispiele

Der folgende Beispielcode veranschaulicht, wie Sie diese Methode verwenden, um den Benutzer mithilfe von Anmeldesteuerelementen in Ihrem Anwendungscode zu überprüfen. In diesem Beispiel ist ein TextBox Steuerelement mit dem Namen usernameTextBox, ein TextBox Steuerelement mit dem Namen passwordTextBoxund ein CheckBox Steuerelement mit dem Namen rememberMeCheckBoxerforderlich.

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

Hinweise

Sie können Clientanwendungsdienste verwenden, um Benutzer mithilfe der Formularauthentifizierung zu überprüfen. Zum Überprüfen von Benutzern rufen Sie in der Regel die staticMembership.ValidateUser -Methode auf, die intern die ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) -Methode aufruft. Alternativ können Sie die ClientFormsAuthenticationMembershipProvider.ValidateUser -Methode auch direkt aufrufen. Sie können diese Überladung aufrufen, um einen rememberMe Wert zusätzlich zu den username Werten und password zu übergeben.

Weitere Informationen

• ValidateUser(String, String)
• Clientanwendungsdienste
• Gewusst wie: Konfigurieren von Clientanwendungsdiensten
• Vorgehensweise: Implementieren der Benutzeranmeldung und -abmeldung mit Client Application Services

ValidateUser(String, String, String)

Authentifiziert einen Benutzer am angegebenen Dienst-URI mit dem angegebenen Benutzernamen und dem angegebenen Kennwort.

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

Parameter

username

String

Der Name des zu authentifizierenden Benutzers.

password

String

Das Kennwort für den Benutzer, der authentifiziert werden soll.

serviceUri

String

Der URI des Authentifizierungsdiensts, der verwendet werden soll.

Gibt zurück

Boolean

true, wenn der Benutzer authentifiziert wurde, andernfalls false.

Ausnahmen

WebException

Der IsOffline-Eigenschaftswert ist false, und der Mitgliedschaftsanbieter kann nicht auf den Authentifizierungsdienst zugreifen.

Beispiele

Der folgende Beispielcode veranschaulicht, wie Sie diese Methode verwenden, um den Benutzer über einen Authentifizierungsdienst an einem angegebenen Speicherort zu überprüfen. Die Benutzeranmeldeinformationen werden aus Anmeldesteuerelementen in Ihrem Anwendungscode abgerufen. In diesem Beispiel ist ein TextBox Steuerelement mit dem Namen usernameTextBox und ein TextBox Steuerelement mit dem Namen passwordTextBoxerforderlich.

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

Hinweise

Sie können Clientanwendungsdienste verwenden, um Benutzer mithilfe der Formularauthentifizierung zu überprüfen. Zum Überprüfen von Benutzern rufen Sie in der Regel die staticMembership.ValidateUser -Methode auf, die intern die ClientFormsAuthenticationMembershipProvider.ValidateUser -Methode aufruft. Alternativ können Sie die ClientFormsAuthenticationMembershipProvider.ValidateUser -Methode auch direkt aufrufen. Sie können diese Überladung aufrufen, um auf einen Authentifizierungsdienst an der im serviceUri Parameter angegebenen Position zuzugreifen. Die Verwendung dieser Überladung ist eine Alternative zum Festlegen der ServiceUri Eigenschaft und aufrufen der ValidateUser(String, String) Überladung.

Weitere Informationen

• ValidateUser(String, String)
• Clientanwendungsdienste
• Gewusst wie: Konfigurieren von Clientanwendungsdiensten
• Vorgehensweise: Implementieren der Benutzeranmeldung und -abmeldung mit Client Application Services