LoginCancelEventArgs LoginCancelEventArgs LoginCancelEventArgs LoginCancelEventArgs Class

Definizione

Fornisce dati per un evento annullabile.Provides data for a cancelable event.

public ref class LoginCancelEventArgs : EventArgs
public class LoginCancelEventArgs : EventArgs
type LoginCancelEventArgs = class
    inherit EventArgs
Public Class LoginCancelEventArgs
Inherits EventArgs
Ereditarietà
LoginCancelEventArgsLoginCancelEventArgsLoginCancelEventArgsLoginCancelEventArgs
Derivato

Esempi

Nell'esempio di codice seguente viene LoggingIn usato l'evento per assicurarsi che l'utente abbia immesso un indirizzo UserName di posta elettronica corretto nella proprietà.The following code example uses the LoggingIn event to ensure that the user has entered a well-formed email address in the UserName property. In caso contrario, LoggingIn il gestore dell'evento annulla il tentativo di accesso impostando la Cancel proprietà LoginCancelEventArgs dell'oggetto truesu. Viene visualizzato il messaggio di errore specificato InstructionText nella proprietà.If not, the LoggingIn event handler cancels the logon attempt by setting the Cancel property of the LoginCancelEventArgs object to true.Then the error message specified in the InstructionText property is displayed.

public partial class LoginCancelEventArgscs_aspx : System.Web.UI.Page
{

    bool IsValidEmail(string strIn)
    {
        // Return true if strIn is in valid email format.
        return System.Text.RegularExpressions.Regex.IsMatch(strIn, 
            @"^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$");
    }
    
    protected void OnLoggingIn(object sender, System.Web.UI.WebControls.LoginCancelEventArgs e)
    {
        if (!IsValidEmail(Login1.UserName))
        {
            Login1.InstructionText = "You must enter a valid email address.";
            e.Cancel = true;
        }
        else
        {
            Login1.InstructionText = String.Empty;
        }
    }
}
Partial Class LoginCancelEventArgsvb_aspx
    Inherits System.Web.UI.Page

    Function IsValidEmail(ByVal strIn As String) As Boolean
        ' Return true if strIn is in valid email format.
        Return Regex.IsMatch(strIn, _
            ("^([\w-\.]+)@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.)|(([\w-]+\.)+))([a-zA-Z]{2,4}|[0-9]{1,3})(\]?)$"))
    End Function

    Protected Sub OnLoggingIn(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LoginCancelEventArgs)
        If Not IsValidEmail(Login1.UserName) Then
            Login1.InstructionText = "You must enter a valid email address."
            e.Cancel = True
        Else
            Login1.InstructionText = String.Empty
        End If
    End Sub

End Class

Di seguito è riportato il file aspx che può essere utilizzato per eseguire l'esempio precedente.The following is the .aspx file that can be used to run the preceding example.

<%@ Page Language="C#" CodeFile="LoginCancelEventArgs.cs" Inherits="LoginCancelEventArgscs_aspx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="Form1" runat="server">
            <asp:Login id="Login1" 
              runat="server" 
              onloggingin="OnLoggingIn">
            </asp:Login>
        </form>
    </body>
</html>
<%@ Page Language="VB" AutoEventWireup="false" CodeFile="LoginCancelEventArgs.vb" Inherits="LoginCancelEventArgsvb_aspx" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="Form1" runat="server">
            <asp:Login id="Login1" 
              runat="server" 
              onloggingin="OnLoggingIn">
            </asp:Login>
        </form>
    </body>
</html>

Commenti

Un evento annullabile viene generato quando un componente sta per eseguire un'azione che può essere annullata, ad esempio l'accesso a un sito Web.A cancelable event is raised when a component is about to perform an action that can be canceled, such as logging on to a Web site.

La LoginCancelEventArgs classe fornisce la Cancel proprietà per indicare se l'evento deve essere annullato.The LoginCancelEventArgs class provides the Cancel property to indicate whether the event should be canceled. Un LoginCancelEventArgs oggetto viene usato con i controlli che hanno azioni annullabili, ad Login esempio il controllo CreateUserWizard , il controllo e PasswordRecovery il controllo.A LoginCancelEventArgs object is used with controls that have cancelable actions, such as the Login control, the CreateUserWizard control, and the PasswordRecovery control.

Costruttori

LoginCancelEventArgs() LoginCancelEventArgs() LoginCancelEventArgs() LoginCancelEventArgs()

Consente di inizializzare una nuova istanza della classe LoginCancelEventArgs con la proprietà Cancel impostata su false.Initializes a new instance of the LoginCancelEventArgs class with the Cancel property set to false.

LoginCancelEventArgs(Boolean) LoginCancelEventArgs(Boolean) LoginCancelEventArgs(Boolean) LoginCancelEventArgs(Boolean)

Inizializza una nuova istanza della classe LoginCancelEventArgs con la proprietà Cancel impostata sul valore specificato.Initializes a new instance of the LoginCancelEventArgs class with the Cancel property set to the specified value.

Proprietà

Cancel Cancel Cancel Cancel

Ottiene o imposta un valore che indica se l'evento debba essere annullato.Gets or sets a value indicating whether the event should be canceled.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche