共用方式為

如何：使用 Windows Form ErrorProvider 元件顯示表單驗證的錯誤圖示

  • 發行項

您可以使用 Windows Forms ErrorProvider 元件，在使用者輸入無效的資料時顯示錯誤圖示。 您必須在表單上至少有兩個控件，才能在表單之間索引標籤，藉此叫用驗證碼。

當控件的值無效時顯示錯誤圖示

  1. 例如，新增兩個控件 (例如文字輸入框) 至 Windows Form。

  2. 新增一個 ErrorProvider 元件至表單。

  3. 選取第一個控件，並將程式碼新增至其 Validating 事件處理常式。 為了讓此程式碼正常執行，程序必須連線到事件。 如需更多資訊，請參閱如何在執行階段建立 Windows Forms 事件處理常式。

    下列程式碼會測試使用者輸入的資料有效性；如果資料無效，則會呼叫 SetError 方法。 SetError 方法的第一個引數會指定要顯示旁邊圖示的控件。 第二個引數是要顯示的錯誤文字。

    Private Sub TextBox1_Validating(ByVal Sender As Object, _  
   ByVal e As System.ComponentModel.CancelEventArgs) Handles _  
   TextBox1.Validating  
      If Not IsNumeric(TextBox1.Text) Then  
         ErrorProvider1.SetError(TextBox1, "Not a numeric value.")  
      Else  
         ' Clear the error.  
         ErrorProvider1.SetError(TextBox1, "")  
      End If  
End Sub  

    protected void textBox1_Validating (object sender,  
   System.ComponentModel.CancelEventArgs e)  
{  
   try  
   {  
      int x = Int32.Parse(textBox1.Text);  
      errorProvider1.SetError(textBox1, "");  
   }  
   catch (Exception ex)  
   {  
      errorProvider1.SetError(textBox1, "Not an integer value.");  
   }  
}  

    private:  
   System::Void textBox1_Validating(System::Object ^  sender,  
      System::ComponentModel::CancelEventArgs ^  e)  
   {  
      try  
      {  
         int x = Int32::Parse(textBox1->Text);  
         errorProvider1->SetError(textBox1, "");  
      }  
      catch (System::Exception ^ ex)  
      {  
         errorProvider1->SetError(textBox1, "Not an integer value.");  
      }  
   }

    (Visual C#、Visual C++) 請將下列程式碼置於表單的建構函式中，以登錄事件處理常式。

    this.textBox1.Validating += new  
System.ComponentModel.CancelEventHandler(this.textBox1_Validating);  

    this->textBox1->Validating += gcnew  
   System::ComponentModel::CancelEventHandler  
   (this, &Form1::textBox1_Validating);

  4. 執行專案。 在第一個控件中輸入無效的 (在此範例中為非數值) 資料，然後將索引標籤移至第二個控件。 顯示錯誤圖示時，請使用滑鼠指標指向，以查看錯誤文字。

另請參閱