共用方式為

FormError 類別

  • 發行項

代表表單之 FormErrorCollection 中的錯誤。

**命名空間：**Microsoft.Office.InfoPath
**組件：**Microsoft.Office.InfoPath (於 microsoft.office.infopath.dll 中)

語法

'宣告
Public MustInherit Class FormError
'用途
Dim instance As FormError

public abstract class FormError

備註

InfoPath 表單中每一個 FormError 物件都會與該表單之基礎 XML 文件內的節點有關聯。當特定節點的資料驗證失敗時，InfoPath 會建立 FormError 物件，並將它放在與該表單有關聯的 FormErrorCollection 中。

在 InfoPath 表單中，可能發生三種型別的資料驗證錯誤。您可以使用 FormError 類別的 FormErrorType 屬性來判斷這些錯誤型別：

  • FormErrorType.SchemaValidation 由於 XML 結構描述定義的條件約束而造成資料驗證失敗。

  • FormErrorType.SystemGenerated 由於表單定義 (.xsf) 檔案中定義的條件約束，或是因為表單程式碼呼叫 XmlValidatingEventArgs 類別的 ReportError 方法，而造成資料驗證失敗。

  • FormErrorType.UserDefined 由於使用 FormErrorsCollection 類別的 Add 方法定義自訂錯誤，而造成資料驗證失敗。

範例

在下列範例中，按一下 [按鈕] 控制項會在表單之 FormErrorCollection 中取得第一個錯誤，然後會顯示 FormError 物件的所有屬性值。

public void ErrorBtn_Clicked(object sender, ClickedEventArgs e)
{
   FormError er = this.Errors[0];
   MessageBox.Show("Short message: " + er.Message);
   MessageBox.Show("Detailed message: " + er.DetailedMessage); 
   MessageBox.Show("Error code: " + er.ErrorCode);
   MessageBox.Show("Error name: " + er.Name);
   MessageBox.Show("Error type: " + er.FormErrorType.ToString());
   MessageBox.Show("Error site XML: " + er.Site.OuterXml.ToString());
}

Public Sub ErrorBtn_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   FormError er = Me.Errors(0)
   MessageBox.Show("Short message: " & er.Message)
   MessageBox.Show("Detailed message: " & er.DetailedMessage) 
   MessageBox.Show("Error code: " & er.ErrorCode)
   MessageBox.Show("Error name: " & er.Name);
   MessageBox.Show("Error type: " & er.FormErrorType.ToString())
   MessageBox.Show("Error site XML: " & er.Site.OuterXml.ToString())
End Sub

繼承階層

System.Object
  Microsoft.Office.InfoPath.FormError

執行緒安全

此型別的所有公用靜態 (於 Visual Basic 共用) 成員都是執行緒安全。但並不保證所有執行個體成員為執行緒安全。

請參閱

參考

FormError 成員
Microsoft.Office.InfoPath 命名空間