FormErrorCollection クラス

定義

public ref class FormErrorCollection abstract : System::Collections::IEnumerable

public abstract class FormErrorCollection : System.Collections.IEnumerable

type FormErrorCollection = class
    interface IEnumerable

Public MustInherit Class FormErrorCollection
Implements IEnumerable

継承

Object

FormErrorCollection

実装

IEnumerable

例

次の例では、まず、エラーを関連付けるフィールドに XPathNavigator オブジェクトを配置します。 次に、XPathNavigator とエラー メッセージの詳細が FormErrorCollection クラスの Add メソッドに渡され、フォームのエラー コレクションにエラーが追加されます。

XPathNavigator root, txtbox;
// Create XPathNavigator for main data source.
root = this.MainDataSource.CreateNavigator();

// Create XPathNavigator positioned at field to associate with error.
txtbox = root.SelectSingleNode("//my:field1", this.NamespaceManager);

// Get form's collection of errors and add error.
this.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless);

Dim root, txtbox As XPathNavigator
' Create XPathNavigator for main data source.
root = Me.MainDataSource.CreateNavigator()

' Create XPathNavigator positioned at field to add error.
txtbox = root.SelectSingleNode("//my:field1", Me.NamespaceManager)

' Get form's collection of errors and add error.
Me.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless)

注釈

FormErrorCollection オブジェクトは、関連付けられたフォームで発生したすべてのエラーを表す FormError オブジェクトのコレクションを含みます。 エラーのコレクションには、入力規則エラー、システムが生成したエラー、およびユーザー定義 (カスタム) エラーが含まれます。 FormErrorCollection クラスには、含んでいる FormError オブジェクトの追加、削除、およびアクセス獲得のためのプロパティとメソッドが用意されています。 入力規則エラーまたはシステムが生成したエラーは、このコレクションから削除できません。

InfoPath によって生成されるエラーを管理するだけでなく、 FormErrorCollection クラスを使用して、 Add メソッドを使用してカスタム エラーを作成することもできます。

注: カスタム エラーは、XmlValidatingEventArgs クラスの ReportError メソッドを使用して作成することもできます。

フォームに関連付けられている FormErrorCollection オブジェクトにアクセスするには、XmlForm クラスの Errors プロパティを使用します。

FormErrorCollection myErrors = this.Errors; Dim myErrors As FormErrorCollection = Me.Errors

コンストラクター

プロパティ

メソッド

適用対象