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

更新：2007 年 11 月

您可以使用 Windows Form ErrorProvider 元件，在使用者輸入無效資料時顯示錯誤圖示。表單中至少需要有兩個控制項，才能在它們之間按 TAB 鍵切換，以及叫用 (Invoke) 驗證程式碼。

若要在控制項值無效時顯示錯誤圖示

1. 在 Windows Form 中加入兩個控制項，例如，文字方塊。

2. 將 ErrorProvider 元件加入至表單中。

3. 選取第一個控制項，並將程式碼加入它的 Validating 事件處理常式。為了讓這段程式碼正確地執行，必須將此程序連接至事件。如需詳細資訊，請參閱 HOW TO：建立 Windows Form 的執行階段事件處理常式。

   下列程式碼測試使用者輸入的資料之有效性；如果資料無效，則呼叫 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 e)
      {
         errorProvider1.SetError(textBox1, "Not an integer value.");
      }
   }
   

   protected void textBox1_Validating(Object sender, CancelEventArgs e) 
   {
      try 
      {
         int x = Int32.Parse(textBox1.get_Text());
         errorProvider1.SetError(textBox1, "");
      }
      catch(Exception exp)
      {
         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. 執行專案。在第一個控制項中輸入無效 (在這個例子中，輸入非數字) 資料，接著按下 Tab 鍵切換至第二個控制項。當錯誤圖示顯示後，將滑鼠指標指向圖示來查看錯誤文字。

請參閱

工作

HOW TO：使用 Windows Form ErrorProvider 元件檢視資料集錯誤

參考

SetError

ErrorProvider 元件概觀 (Windows Form)