Control.CausesValidation Property
Assembly: System.Windows.Forms (in system.windows.forms.dll)
/** @property */ public boolean get_CausesValidation () /** @property */ public void set_CausesValidation (boolean value)
public function get CausesValidation () : boolean public function set CausesValidation (value : boolean)
Property Value
true if the control causes validation to be performed on any controls requiring validation when it receives focus; otherwise, false. The default is true.If the CausesValidation property is set to false, the Validating and Validated events are suppressed.
The CausesValidation property value is typically set to false for controls such as a Help button.
The following code example creates a Windows form that adds numbers entered in text boxes. The text boxes are validated before showing the result.
private: void AddHandlers() { // Add the Validating and Validated handlers for textboxes. myTextBox1->Validating += gcnew System::ComponentModel::CancelEventHandler( this, &Form1::myTextBox1_Validating ); myTextBox1->Validated += gcnew System::EventHandler( this, &Form1::myTextBox1_Validated ); myTextBox2->Validating += gcnew System::ComponentModel::CancelEventHandler( this, &Form1::myTextBox2_Validating ); myTextBox2->Validated += gcnew System::EventHandler( this, &Form1::myTextBox2_Validated ); myTextBox1->CausesValidationChanged += gcnew System::EventHandler( this, &Form1::myTextBox1_CausesValidationChanged ); myTextBox2->CausesValidationChanged += gcnew System::EventHandler( this, &Form1::myTextBox2_CausesValidationChanged ); if ( myTextBox1->CausesValidation == true && myTextBox2->CausesValidation == true ) { button1->Text = "Disable Validation"; myLabel->Text = "Validation Enabled"; this->Focus(); } } void myTextBox1_Validating( Object^ /*sender*/, System::ComponentModel::CancelEventArgs^ e ) { if ( !CheckIfTextBoxNumeric( myTextBox1 ) ) { myLabel->Text = "Has to be numeric"; e->Cancel = true; } } void myTextBox1_Validated( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { myLabel->Text = "Validated first control"; } void myTextBox2_Validating( Object^ /*sender*/, System::ComponentModel::CancelEventArgs^ e ) { if ( !CheckIfTextBoxNumeric( myTextBox2 ) ) { myLabel->Text = "Has to be numeric"; e->Cancel = true; } } void myTextBox2_Validated( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { myLabel->Text = "Validated second control"; } void myTextBox1_CausesValidationChanged( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { myLabel->Text = "CausesValidation property was changed for First Textbox"; } void myTextBox2_CausesValidationChanged( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { myLabel->Text = "CausesValidation property was changed for Second Textbox"; } bool CheckIfTextBoxNumeric( TextBox^ myTextBox1 ) { bool isValid = true; if ( myTextBox1->Text->Equals( "" ) ) { isValid = false; } else { for ( int i = 0; i < myTextBox1->Text->Length; i++ ) { if ( !(System::Char::IsNumber( myTextBox1->Text[ i ] )) ) { myTextBox1->Text = ""; isValid = false; break; } } } return isValid; } void myButtonAdd_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { try { int result = Convert::ToInt32( myTextBox1->Text ) + Convert::ToInt32( myTextBox2->Text ); myLabel->Text = result.ToString(); } catch ( Exception^ myException ) { myLabel->Text = "Exception : ",myException->Message; } } void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ ) { if ( myTextBox1->CausesValidation == false && myTextBox2->CausesValidation == false ) { myTextBox1->CausesValidation = true; myTextBox2->CausesValidation = true; button1->Text = "Disable Validation"; myLabel->Text = "Validation Enabled"; } else if ( myTextBox1->CausesValidation == true && myTextBox2->CausesValidation == true ) { myTextBox1->CausesValidation = false; myTextBox2->CausesValidation = false; button1->Text = "Enable Validation"; myLabel->Text = "Validation Disabled"; } }
private void AddHandlers()
{
// Add the Validating and Validated handlers for textboxes.
myTextBox1.add_Validating(new System.ComponentModel.
CancelEventHandler(myTextBox1_Validating));
myTextBox1.add_Validated(new System.EventHandler(myTextBox1_Validated));
myTextBox2.add_Validating(new System.ComponentModel.
CancelEventHandler(myTextBox2_Validating));
myTextBox2.add_Validated(new System.EventHandler(myTextBox2_Validated));
myTextBox1.add_CausesValidationChanged(new System.
EventHandler(myTextBox1_CausesValidationChanged));
myTextBox2.add_CausesValidationChanged(new System.
EventHandler(myTextBox2_CausesValidationChanged));
if (myTextBox1.get_CausesValidation() == true && myTextBox2.
get_CausesValidation() == true) {
button1.set_Text("Disable Validation");
myLabel.set_Text("Validation Enabled");
this.Focus();
}
} //AddHandlers
private void myTextBox1_Validating(Object sender,
System.ComponentModel.CancelEventArgs e)
{
if (!(CheckIfTextBoxNumeric(myTextBox1))) {
myLabel.set_Text("Has to be numeric");
e.set_Cancel(true);
}
} //myTextBox1_Validating
private void myTextBox1_Validated(Object sender,
System.EventArgs e)
{
myLabel.set_Text("Validated first control");
} //myTextBox1_Validated
private void myTextBox2_Validating(Object sender,
System.ComponentModel.CancelEventArgs e)
{
if (!(CheckIfTextBoxNumeric(myTextBox2))) {
myLabel.set_Text("Has to be numeric");
e.set_Cancel(true);
}
} //myTextBox2_Validating
private void myTextBox2_Validated(Object sender, System.EventArgs e)
{
myLabel.set_Text("Validated second control");
} //myTextBox2_Validated
private void myTextBox1_CausesValidationChanged(Object sender,
System.EventArgs e)
{
myLabel.set_Text("CausesValidation property was changed for "
+ "First Textbox");
} //myTextBox1_CausesValidationChanged
private void myTextBox2_CausesValidationChanged(Object sender,
System.EventArgs e)
{
myLabel.set_Text("CausesValidation property was changed for "
+ "Second Textbox");
} //myTextBox2_CausesValidationChanged
private boolean CheckIfTextBoxNumeric(TextBox myTextBox1)
{
boolean isValid = true;
if (myTextBox1.get_Text().Equals("")) {
isValid = false;
}
else {
for (int i = 0; i < myTextBox1.get_Text().get_Length(); i++) {
if (!(System.Char.IsNumber(myTextBox1.get_Text().
get_Chars(i)))) {
myTextBox1.set_Text("");
isValid = false;
break;
}
}
}
return isValid;
} //CheckIfTextBoxNumeric
private void myButtonAdd_Click(Object sender, System.EventArgs e)
{
try {
int result = Convert.ToInt32(myTextBox1.get_Text())
+ Convert.ToInt32(myTextBox2.get_Text());
myLabel.set_Text(System.Convert.ToString(result));
}
catch (System.Exception myException) {
myLabel.set_Text("Exception : " + myException.get_Message());
}
} //myButtonAdd_Click
private void button1_Click(Object sender, System.EventArgs e)
{
if (myTextBox1.get_CausesValidation() == false && myTextBox2.
get_CausesValidation() == false) {
myTextBox1.set_CausesValidation(true);
myTextBox2.set_CausesValidation(true);
button1.set_Text("Disable Validation");
myLabel.set_Text("Validation Enabled");
}
else {
if (myTextBox1.get_CausesValidation() == true && myTextBox2.
get_CausesValidation() == true) {
myTextBox1.set_CausesValidation(false);
myTextBox2.set_CausesValidation(false);
button1.set_Text("Enable Validation");
myLabel.set_Text("Validation Disabled");
}
}
} //button1_Click
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.