ClientFormsAuthenticationMembershipProvider.ValidateUser Methode

Definition

Namespace:

System.Web.ClientServices.Providers

Assembly:

System.Web.Extensions.dll

Authentifiziert einen Benutzer mithilfe der angegebenen Anmeldeinformationen.

Überlädt

ValidateUser(String, String)	Authentifiziert einen Benutzer mithilfe des angegebenen Benutzernamens und Kennworts.
ValidateUser(String, String, Boolean)	Authentifiziert einen Benutzer mithilfe des angegebenen Benutzernamens und Kennworts und speichert optional einen Hash des Kennworts im lokalen Datencache.
ValidateUser(String, String, String)	Authentifiziert einen Benutzer am angegebenen Dienst-URI mithilfe des angegebenen Benutzernamens und Kennworts.

ValidateUser(String, String)

Authentifiziert einen Benutzer mithilfe des angegebenen Benutzernamens und Kennworts.

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 zu authentifizierenden Benutzers oder Empty oder null, um Anmeldeinformationen aus der IClientFormsAuthenticationCredentialsProvider Implementierung abzurufen, die diese Anwendung für die Verwendung konfiguriert ist.

password

String

Das Kennwort des Zu authentifizierenden Benutzers.

Gibt zurück

Boolean

true, wenn der Benutzer authentifiziert wurde; andernfalls false.

Ausnahmen

WebException

Der wert der IsOffline Eigenschaft 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 ein Anmeldeinformationsanbieter verwendet wird.

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. Um Benutzer zu überprüfen, rufen Sie in der Regel die staticMembership.ValidateUser-Methode auf, die intern die ClientFormsAuthenticationMembershipProvider.ValidateUser-Methode aufruft. Alternativ können Sie diese Methode direkt aufrufen, wie im Beispielabschnitt gezeigt.

Für die Formularauthentifizierung muss der Benutzer seine Anmeldeinformationen über Anmeldesteuerelemente angeben, die von Ihrer Anwendung bereitgestellt werden. Sie können die Anmeldeinformationen abrufen und an die Membership.ValidateUser-Methode übergeben. Sie können auch leere Zeichenfolgen oder null übergeben, um einen Anmeldeinformationsanbieter zu verwenden.

Weitere Informationen

• IClientFormsAuthenticationCredentialsProvider
• ValidateUser(String, String)
• Clientanwendungsdienste
• How to: Configure Client Application Services
• How to: Implement User Login and Logout with Client Application Services

ValidateUser(String, String, Boolean)

Authentifiziert einen Benutzer mithilfe des angegebenen Benutzernamens und Kennworts und speichert optional einen Hash des Kennworts 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 des Zu authentifizierenden Benutzers.

rememberMe

Boolean

true, einen Hash des Kennworts im lokalen Datencache für die Offlineverwendung und für die automatische erneute Authentifizierung zu speichern, wenn das Benutzerauthentifizierungscookies abläuft; false, die Offlineanmeldung zu deaktivieren oder die erneute Authentifizierung durch Benutzer zu verlangen, wenn das Cookie abläuft.

Gibt zurück

Boolean

true, wenn der Benutzer authentifiziert wurde; andernfalls false.

Ausnahmen

WebException

Der wert der IsOffline Eigenschaft 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 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. Um Benutzer zu überprüfen, 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 direkt aufrufen. Sie können diese Überladung aufrufen, um zusätzlich zu den werten username und password einen rememberMe Wert zu übergeben.

Weitere Informationen

• ValidateUser(String, String)
• Clientanwendungsdienste
• How to: Configure Client Application Services
• How to: Implement User Login and Logout with Client Application Services

ValidateUser(String, String, String)

Authentifiziert einen Benutzer am angegebenen Dienst-URI mithilfe des angegebenen Benutzernamens und Kennworts.

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 des Zu authentifizierenden Benutzers.

serviceUri

String

Der URI des zu verwendenden Authentifizierungsdiensts.

Gibt zurück

Boolean

true, wenn der Benutzer authentifiziert wurde; andernfalls false.

Ausnahmen

WebException

Der wert der IsOffline Eigenschaft 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 über einen Authentifizierungsdienst an einem bestimmten 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. Um Benutzer zu überprüfen, 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 direkt aufrufen. Sie können diese Überladung aufrufen, um an dem durch den parameter serviceUri angegebenen Speicherort auf einen Authentifizierungsdienst 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
• How to: Configure Client Application Services
• How to: Implement User Login and Logout with Client Application Services