FormErrorCollection.Add メソッド

リファレンス

定義

名前空間:: Microsoft.Office.InfoPath

アセンブリ:: Microsoft.Office.InfoPath.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

Add(XPathNavigator, String, String)	現在のフォームに関連付けられているオブジェクトにFormErrorCollection新しい FormError を作成して追加します。
Add(XPathNavigator, String, String, String)	現在のフォームに関連付けられているオブジェクトにFormErrorCollection新しい FormError を作成して追加します。
Add(XPathNavigator, String, String, String, Int32)	現在のフォームに関連付けられているオブジェクトにFormErrorCollection新しい FormError を作成して追加します。
Add(XPathNavigator, String, String, String, Int32, ErrorMode)	現在のフォームに関連付けられているオブジェクトにFormErrorCollection新しい FormError を作成して追加します。

Add(XPathNavigator, String, String)

現在のフォームに関連付けられているオブジェクトにFormErrorCollection新しい FormError を作成して追加します。

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message);

public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message);

abstract member Add : System.Xml.XPath.XPathNavigator * string * string -> Microsoft.Office.InfoPath.FormError

Public MustOverride Function Add (context As XPathNavigator, name As String, message As String) As FormError

パラメーター

context: XPathNavigator

XPathNavigatorエラーが関連付けられるノードに配置されるオブジェクト。

name: String

エラーの名前 (空白は不可)。

message: String

エラーの短いメッセージ。

戻り値

FormError

コレクションに追加された新しい FormError への参照。

例外

ArgumentNullException

このメソッドに渡されるパラメーターは null 参照です (Visual Basic では Nothing)。

ArgumentException

このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。

例

次の例では、まず、エラーを関連付けるフィールドに XPathNavigator オブジェクトを配置します。次に、XPathNavigator、name、およびメッセージが 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.");

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.")

注釈

FormErrorType新しい FormError のはにUserDefined設定されます。

注: 同じ name パラメーター値を持つ複数のエラーを異なる context ノードに追加できます。ただし、同じ名前のエラーを同じ context ノードに 2 回追加すると、追加された 2 番目のエラーによって最初のエラーが上書きされます。

このメンバは、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームだけがアクセスできます。

この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開いたフォームで実行されるコードからアクセスできます。

適用対象

Add(XPathNavigator, String, String, String)

現在のフォームに関連付けられているオブジェクトにFormErrorCollection新しい FormError を作成して追加します。

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails);

public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails);

abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string -> Microsoft.Office.InfoPath.FormError

Public MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String) As FormError

パラメーター

context: XPathNavigator

XPathNavigatorエラーが関連付けられるノードに配置されるオブジェクト。

name: String

エラーの名前 (空白は不可)。

message: String

エラーの短いメッセージ。

messageDetails: String

エラーの詳細なメッセージ。

戻り値

FormError

コレクションに追加された新しい FormError への参照。

例外

ArgumentException

このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。

ArgumentNullException

このメソッドに渡されるパラメーターは null 参照です (Visual Basic では Nothing)。

例

次の例では、まず、エラーを関連付けるフィールドに XPathNavigator オブジェクトを配置します。次に、XPathNavigator、name、message、および詳細メッセージが 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)

注釈

FormErrorType新しい FormError のはにUserDefined設定されます。

この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開いたフォームで実行されるコードからアクセスできます。

適用対象

Add(XPathNavigator, String, String, String, Int32)

現在のフォームに関連付けられているオブジェクトにFormErrorCollection新しい FormError を作成して追加します。

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode);

public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode);

abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int -> Microsoft.Office.InfoPath.FormError

Public MustOverride Function Add (context As XPathNavigator, name As String, message As String, messageDetails As String, errorCode As Integer) As FormError

パラメーター

context: XPathNavigator

XPathNavigatorエラーが関連付けられるノードに配置されるオブジェクト。

name: String

エラーの名前 (空白は不可)。

message: String

エラーの短いメッセージ。

messageDetails: String

エラーの詳細なメッセージ。

errorCode: Int32

エラーのエラーコード。

戻り値

FormError

コレクションに追加された新しい FormError への参照。

例外

ArgumentException

このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。

ArgumentNullException

このメソッドに渡されるパラメーターは null 参照です (Visual Basic では Nothing)。

例

次の例では、まず、エラーを関連付けるフィールドに 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);

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)

注釈

FormErrorType新しい FormError のはにUserDefined設定されます。

この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開いたフォームで実行されるコードからアクセスできます。

適用対象

Add(XPathNavigator, String, String, String, Int32, ErrorMode)

現在のフォームに関連付けられているオブジェクトにFormErrorCollection新しい FormError を作成して追加します。

public:
 abstract Microsoft::Office::InfoPath::FormError ^ Add(System::Xml::XPath::XPathNavigator ^ context, System::String ^ name, System::String ^ message, System::String ^ messageDetails, int errorCode, Microsoft::Office::InfoPath::ErrorMode errorMode);

public abstract Microsoft.Office.InfoPath.FormError Add (System.Xml.XPath.XPathNavigator context, string name, string message, string messageDetails, int errorCode, Microsoft.Office.InfoPath.ErrorMode errorMode);

abstract member Add : System.Xml.XPath.XPathNavigator * string * string * string * int * Microsoft.Office.InfoPath.ErrorMode -> Microsoft.Office.InfoPath.FormError

パラメーター

context: XPathNavigator

XPathNavigatorエラーが関連付けられるノードに配置されるオブジェクト。

name: String

エラーの名前 (空白は不可)。

message: String

エラーの短いメッセージ。

messageDetails: String

エラーの詳細なメッセージ。

errorCode: Int32

エラーのエラーコード。

errorMode: ErrorMode

ErrorModeエラーメッセージを表示するモードを指定する。

戻り値

FormError

コレクションに追加された新しい FormError への参照。

例外

ArgumentException

このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。

ArgumentNullException

このメソッドに渡されるパラメーターは null 参照です (Visual Basic では Nothing)。

例

次の例では、まず、エラーを関連付けるフィールドに 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)

注釈

FormErrorType新しい FormError のはにUserDefined設定されます。

この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開いたフォームで実行されるコードからアクセスできます。

適用対象

次の方法で共有

FormErrorCollection.Add メソッド

定義

オーバーロード

Add(XPathNavigator, String, String)

パラメーター

戻り値

例外

例

注釈

適用対象

Add(XPathNavigator, String, String, String)

パラメーター

戻り値

例外

例

注釈

適用対象

Add(XPathNavigator, String, String, String, Int32)

パラメーター

戻り値

例外

例

注釈

適用対象

Add(XPathNavigator, String, String, String, Int32, ErrorMode)

パラメーター

戻り値

例外

例

注釈

適用対象

フィードバック

その他のリソース