Control.Validating Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce cuando el control se está validando.
public:
event System::ComponentModel::CancelEventHandler ^ Validating;public event System.ComponentModel.CancelEventHandler Validating;public event System.ComponentModel.CancelEventHandler? Validating;member this.Validating : System.ComponentModel.CancelEventHandler Public Custom Event Validating As CancelEventHandler Tipo de evento
Ejemplos
En el ejemplo de código siguiente se usa la clase TextBox derivada y se valida una dirección de correo electrónico que el usuario escribe. Si la dirección de correo electrónico no está en el formato estándar (que contiene "@" y "."), se produce un error en la validación, se muestra un ErrorProvider icono y se cancela el evento. En este ejemplo se requiere que se haya creado un TextBox control y ErrorProvider en un formulario.
private:
void textBox1_Validating( Object^ sender, System::ComponentModel::CancelEventArgs^ e )
{
String^ errorMsg;
if ( !ValidEmailAddress( textBox1->Text, &errorMsg ) )
{
// Cancel the event and select the text to be corrected by the user.
e->Cancel = true;
textBox1->Select( 0, textBox1->Text->Length );
// Set the ErrorProvider error with the text to display.
this->errorProvider1->SetError( textBox1, errorMsg );
}
}
void textBox1_Validated( Object^ sender, System::EventArgs^ e )
{
// If all conditions have been met, clear the ErrorProvider of errors.
errorProvider1->SetError( textBox1, "" );
}
public:
bool ValidEmailAddress( String^ emailAddress, [Out]interior_ptr<String^> errorMessage )
{
// Confirm that the email address String* is not empty.
if ( emailAddress->Length == 0 )
{
*errorMessage = "email address is required.";
return false;
}
// Confirm that there is an "@" and a "." in the email address, and in the correct order.
if ( emailAddress->IndexOf( "@" ) > -1 )
{
if ( emailAddress->IndexOf( ".", emailAddress->IndexOf( "@" ) ) > emailAddress->IndexOf( "@" ) )
{
*errorMessage = "";
return true;
}
}
*errorMessage = "email address must be valid email address format.\n" +
"For example 'someone@example.com' ";
return false;
}
private void textBox1_Validating(object sender,
System.ComponentModel.CancelEventArgs e)
{
string errorMsg;
if(!ValidEmailAddress(textBox1.Text, out errorMsg))
{
// Cancel the event and select the text to be corrected by the user.
e.Cancel = true;
textBox1.Select(0, textBox1.Text.Length);
// Set the ErrorProvider error with the text to display.
this.errorProvider1.SetError(textBox1, errorMsg);
}
}
private void textBox1_Validated(object sender, System.EventArgs e)
{
// If all conditions have been met, clear the ErrorProvider of errors.
errorProvider1.SetError(textBox1, "");
}
public bool ValidEmailAddress(string emailAddress, out string errorMessage)
{
// Confirm that the email address string is not empty.
if(emailAddress.Length == 0)
{
errorMessage = "email address is required.";
return false;
}
// Confirm that there is an "@" and a "." in the email address, and in the correct order.
if(emailAddress.IndexOf("@") > -1)
{
if(emailAddress.IndexOf(".", emailAddress.IndexOf("@") ) > emailAddress.IndexOf("@") )
{
errorMessage = "";
return true;
}
}
errorMessage = "email address must be valid email address format.\n" +
"For example 'someone@example.com' ";
return false;
}
Private Function ValidEmailAddress(ByVal emailAddress As String, ByRef errorMessage As String) As Boolean
' Confirm there is text in the control.
If textBox1.Text.Length = 0 Then
errorMessage = "Email address is required."
Return False
End If
' Confirm that there is an "@" and a "." in the email address, and in the correct order.
If emailAddress.IndexOf("@") > -1 Then
If (emailAddress.IndexOf(".", emailAddress.IndexOf("@")) > emailAddress.IndexOf("@")) Then
errorMessage = ""
Return True
End If
End If
errorMessage = "Email address must be valid email address format." + ControlChars.Cr + _
"For example 'someone@example.com' "
Return False
End Function
Private Sub textBox1_Validating(ByVal sender As Object, _
ByVal e As System.ComponentModel.CancelEventArgs) Handles textBox1.Validating
Dim errorMsg As String
If Not ValidEmailAddress(textBox1.Text, errorMsg) Then
' Cancel the event and select the text to be corrected by the user.
e.Cancel = True
textBox1.Select(0, textBox1.Text.Length)
' Set the ErrorProvider error with the text to display.
Me.errorProvider1.SetError(textBox1, errorMsg)
End If
End Sub
Private Sub textBox1_Validated(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles textBox1.Validated
' If all conditions have been met, clear the error provider of errors.
errorProvider1.SetError(textBox1, "")
End Sub
Comentarios
Al cambiar el foco mediante el teclado (TAB, MAYÚS+TAB, etc.), llamando a los Select métodos o SelectNextControl , o estableciendo la ContainerControl.ActiveControl propiedad en el formulario actual, los eventos de foco se producen en el orden siguiente:
Al cambiar el foco mediante el mouse o llamando al Focus método , los eventos de foco se producen en el orden siguiente:
Si la CausesValidation propiedad se establece falseen , se suprimen los Validating eventos y Validated .
Si la Cancel propiedad de CancelEventArgs se establece true en en en el delegado de Validating eventos, todos los eventos que normalmente se producirían después de suprimir el Validating evento.
Precaución
No intente establecer el foco desde los Entercontroladores de eventos , , LostFocusGotFocusLeave, , Validatingo Validated . Si lo hace, la aplicación o el sistema operativo dejarán de responder. Para obtener más información, vea el WM_KILLFOCUS tema de la sección "Referencia de entrada de teclado" y la sección "Interbloqueos de mensajes" del artículo Acerca de mensajes y colas de mensajes .
Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.
