ClientFormsAuthenticationMembershipProvider Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ermöglicht die Formularauthentifizierung mit Clientanwendungsdiensten.
public ref class ClientFormsAuthenticationMembershipProvider : System::Web::Security::MembershipProvider
public class ClientFormsAuthenticationMembershipProvider : System.Web.Security.MembershipProvider
type ClientFormsAuthenticationMembershipProvider = class
inherit MembershipProvider
Public Class ClientFormsAuthenticationMembershipProvider
Inherits MembershipProvider
- Vererbung
Beispiele
Im folgenden Beispielcode wird veranschaulicht, wie Sie diese Methode verwenden, um den Benutzer mithilfe einer IClientFormsAuthenticationCredentialsProvider Implementierung zu überprüfen.
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 die Formularauthentifizierung zu aktivieren, konfigurieren Sie Ihre Anwendung für die Verwendung der ClientFormsAuthenticationMembershipProvider -Klasse.
Nach der Konfiguration können Sie Benutzer überprüfen, indem Sie die static
Membership.ValidateUser -Methode aufrufen, die intern die ClientFormsAuthenticationMembershipProvider.ValidateUser(String, String) -Methode aufruft.
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. Ein Anmeldeinformationsanbieter ist eine Implementierung, die in Ihrer Anwendungskonfigurationsdatei IClientFormsAuthenticationCredentialsProvider angegeben ist. In der Regel implementieren Sie die IClientFormsAuthenticationCredentialsProvider.GetCredentials Methode, um ein Anmeldedialogfeld anzuzeigen und ein aufgefülltes ClientFormsAuthenticationCredentials Objekt zurückzugeben. Die Verwendung eines Anmeldeinformationsanbieters ermöglicht es Ihnen, ein einziges Anmeldedialogfeld für mehrere Anwendungen zu verwenden.
Die ClientFormsAuthenticationMembershipProvider.ValidateUser -Methode authentifiziert Benutzer über den Anmeldedienst, der von der ServiceUri -Eigenschaft angegeben wird. Der Wert der -Eigenschaft wird in der ServiceUri Regel aus der Anwendungskonfigurationsdatei zusammen mit anderen Konfigurationswerten abgerufen.
Wenn der Benutzer erfolgreich authentifiziert wurde, legt der Dienstanbieter die static
Thread.CurrentPrincipal Eigenschaft auf ein neues ClientRolePrincipal Objekt fest, das ein neues ClientFormsIdentity Objekt enthält, das die Benutzerinformationen enthält. Wenn ein ClientRoleProvider für Ihre Anwendung konfiguriert ist, können Sie das ClientRolePrincipal -Objekt verwenden, um Benutzerrolleninformationen aus dem Rollendienst abzurufen.
Sie können einen Verweis auf den aktuellen ClientFormsAuthenticationMembershipProvider instance über die static
Membership.Provider -Eigenschaft abrufen. Sie können den Verweis auf den Mitgliedschaftsanbieter verwenden, um die ClientFormsAuthenticationMembershipProvider.ValidateUser -Methode direkt aufzurufen. Darüber hinaus benötigen Sie den Verweis auf den Mitgliedschaftsanbieter, um die Logout -Methode aufzurufen, die in der MembershipProvider Basisklasse nicht verfügbar ist.
Sie können die ClientFormsAuthenticationMembershipProvider -Klasse nicht verwenden, um Mitgliedschaftsinformationen zu erstellen, zu löschen oder zu ändern. Zum Erstellen, Löschen oder Ändern von Benutzern müssen Sie die Konfiguration des Anmeldediensts auf dem Server ändern.
Konstruktoren
ClientFormsAuthenticationMembershipProvider() |
Initialisiert eine neue Instanz der ClientFormsAuthenticationMembershipProvider-Klasse. |
Eigenschaften
ApplicationName |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
Description |
Ruft eine kurze, benutzerfreundliche Beschreibung ab, die für die Anzeige in Verwaltungstools oder anderen Benutzeroberflächen geeignet ist. (Geerbt von ProviderBase) |
EnablePasswordReset |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
EnablePasswordRetrieval |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
MaxInvalidPasswordAttempts |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
MinRequiredNonAlphanumericCharacters |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
MinRequiredPasswordLength |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
Name |
Ruft den Anzeigennamen ab, der verwendet wird, um während der Konfiguration auf den Anbieter zu verweisen. (Geerbt von ProviderBase) |
PasswordAttemptWindow |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
PasswordFormat |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
PasswordStrengthRegularExpression |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
RequiresQuestionAndAnswer |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
RequiresUniqueEmail |
Diese Eigenschaft wird von dieser Klasse nicht verwendet. |
ServiceUri |
Ruft den URI des Authentifizierungsdiensts ab oder legt diesen fest. |
Methoden
ChangePassword(String, String, String) |
Diese Methode wird von dieser Klasse nicht verwendet. |
ChangePasswordQuestionAndAnswer(String, String, String, String) |
Diese Methode wird von dieser Klasse nicht verwendet. |
CreateUser(String, String, String, String, String, Boolean, Object, MembershipCreateStatus) |
Diese Methode wird von dieser Klasse nicht verwendet. |
DecryptPassword(Byte[]) |
Entschlüsselt ein verschlüsseltes Kennwort. (Geerbt von MembershipProvider) |
DeleteUser(String, Boolean) |
Diese Methode wird von dieser Klasse nicht verwendet. |
EncryptPassword(Byte[]) |
Verschlüsselt ein Kennwort. (Geerbt von MembershipProvider) |
EncryptPassword(Byte[], MembershipPasswordCompatibilityMode) |
Verschlüsselt das angegebene Kennwort mithilfe des angegebenen Kennwortkompatibilitätsmodus. (Geerbt von MembershipProvider) |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
FindUsersByEmail(String, Int32, Int32, Int32) |
Diese Methode wird von dieser Klasse nicht verwendet. |
FindUsersByName(String, Int32, Int32, Int32) |
Diese Methode wird von dieser Klasse nicht verwendet. |
GetAllUsers(Int32, Int32, Int32) |
Diese Methode wird von dieser Klasse nicht verwendet. |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetNumberOfUsersOnline() |
Diese Methode wird von dieser Klasse nicht verwendet. |
GetPassword(String, String) |
Diese Methode wird von dieser Klasse nicht verwendet. |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
GetUser(Object, Boolean) |
Diese Methode wird von dieser Klasse nicht verwendet. |
GetUser(String, Boolean) |
Diese Methode wird von dieser Klasse nicht verwendet. |
GetUserNameByEmail(String) |
Diese Methode wird von dieser Klasse nicht verwendet. |
Initialize(String, NameValueCollection) |
Initialisiert den Anbieter. |
Logout() |
Meldet den Benutzer ab. |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
OnValidatingPassword(ValidatePasswordEventArgs) |
Löst das ValidatingPassword-Ereignis aus, wenn ein Ereignishandler definiert wurde. (Geerbt von MembershipProvider) |
ResetPassword(String, String) |
Diese Methode wird von dieser Klasse nicht verwendet. |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
UnlockUser(String) |
Diese Methode wird von dieser Klasse nicht verwendet. |
UpdateUser(MembershipUser) |
Diese Methode wird von dieser Klasse nicht verwendet. |
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. |
Ereignisse
UserValidated |
Tritt ein, wenn der Benutzer überprüft wird. |
ValidatingPassword |
Tritt auf, wenn ein Benutzer erstellt, ein Kennwort geändert oder ein Kennwort zurückgesetzt wird. (Geerbt von MembershipProvider) |
Gilt für:
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für