ClientFormsAuthenticationMembershipProvider.UserValidated Ereignis

Definition

Namespace:

System.Web.ClientServices.Providers

Assembly:

System.Web.Extensions.dll

Tritt ein, wenn der Benutzer überprüft wird.

public:
 event EventHandler<System::Web::ClientServices::Providers::UserValidatedEventArgs ^> ^ UserValidated;

public event EventHandler<System.Web.ClientServices.Providers.UserValidatedEventArgs> UserValidated;

member this.UserValidated : EventHandler<System.Web.ClientServices.Providers.UserValidatedEventArgs> 

Public Event UserValidated As EventHandler(Of UserValidatedEventArgs) 

Ereignistyp

EventHandler<UserValidatedEventArgs>

Beispiele

Der folgende Beispielcode veranschaulicht, wie Sie dieses Ereignis verwenden, um den Benutzernamen in der Titelleiste eines Formulars anzuzeigen.

private ClientFormsAuthenticationMembershipProvider formsMembershipProvider =
    (ClientFormsAuthenticationMembershipProvider)
    System.Web.Security.Membership.Provider;
private String appName = "ClientAppServicesDemo";

private void AttachUserValidatedEventHandler()
{
    formsMembershipProvider.UserValidated += 
        new EventHandler<UserValidatedEventArgs>(Form1_UserValidated);
}

private void Form1_UserValidated(object sender, UserValidatedEventArgs e)
{
    // Set the form's title bar to the application name and the user name.
    this.Text = String.Format("{0} ({1})", appName, e.UserName);
}

Private WithEvents formsMembershipProvider As  _
    ClientFormsAuthenticationMembershipProvider = _
    System.Web.Security.Membership.Provider

Private appName As String = "ClientAppServicesDemo"

Private Sub Form1_UserValidated(ByVal sender As Object, _
    ByVal e As UserValidatedEventArgs) _
    Handles formsMembershipProvider.UserValidated

    ' Set the form's title bar to the application name and the user name.
    Me.Text = String.Format("{0} ({1})", appName, e.UserName)

End Sub

Hinweise

Dieses Ereignis tritt erst auf, nachdem der Benutzer erfolgreich überprüft wurde. Sie können dieses Ereignis verwenden, um Ihre Anwendung so zu aktualisieren, dass sie den aktuellen Benutzer widerspiegelt. Beispielsweise können Sie die UserValidatedEventArgs.UserName -Eigenschaft verwenden, um den Benutzernamen in der Benutzeroberfläche (UI) Ihrer Anwendung anzuzeigen.

Sie können Benutzer im Hintergrund erneut überprüfen, indem Sie die ClientFormsIdentity.RevalidateUser -Methode aufrufen. Daher sollten Sie die Verwendung des UserValidated -Ereignisses vermeiden, um eine aufdringliche Benutzeroberfläche anzuzeigen. Beispielsweise sollten Sie das UserValidated Ereignis nicht verwenden, um ein Willkommensdialogfeld anzuzeigen.

Weitere Informationen

• UserValidatedEventArgs
• UserName
• RevalidateUser()
• Clientanwendungsdienste