XmlValidatingEventArgs.ReportError メソッド

リファレンス

定義

名前空間:: Microsoft.Office.InfoPath

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

重要

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

オーバーロード

ReportError(XPathNavigator, Boolean, String)	指定した値を FormError 持つカスタムエラー情報を含むオブジェクトを作成し、フォームのオブジェクトに FormErrorCollection 追加します。
ReportError(XPathNavigator, Boolean, String, String)	指定した値を FormError 持つカスタムエラー情報を含むオブジェクトを作成し、フォームのオブジェクトに FormErrorCollection 追加します。
ReportError(XPathNavigator, Boolean, String, String, Int32)	指定した値を FormError 持つカスタムエラー情報を含むオブジェクトを作成し、フォームのオブジェクトに FormErrorCollection 追加します。
ReportError(XPathNavigator, Boolean, String, String, Int32, ErrorMode)	指定した値を FormError 持つカスタムエラー情報を含むオブジェクトを作成し、フォームのオブジェクトに FormErrorCollection 追加します。

ReportError(XPathNavigator, Boolean, String)

指定した値を FormError 持つカスタムエラー情報を含むオブジェクトを作成し、フォームのオブジェクトに FormErrorCollection 追加します。

public:
 abstract void ReportError(System::Xml::XPath::XPathNavigator ^ node, bool siteIndependent, System::String ^ message);

public abstract void ReportError (System.Xml.XPath.XPathNavigator node, bool siteIndependent, string message);

abstract member ReportError : System.Xml.XPath.XPathNavigator * bool * string -> unit

Public MustOverride Sub ReportError (node As XPathNavigator, siteIndependent As Boolean, message As String)

パラメーター

node: XPathNavigator

XPathNavigatorエラーが関連付けられているデータを含むノードに位置する。

siteIndependent: Boolean

FormError オブジェクトの自動削除の条件を設定します。 true に設定すると、このイベントオブジェクトのプロパティによって返される XPath 式に一致するすべてのノードに対する変更に対して FormError オブジェクトがMatch削除されます。 false に設定すると、このイベントオブジェクトのプロパティによってSite返されるノードが変更された場合にのみ、フォームが次回検証されるときに FormError オブジェクトが削除されます。

message: String

短いエラーメッセージに使用されるテキスト。

例外

ArgumentException

このメソッドに渡されたパラメーターは有効ではありません。

ArgumentNullException

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

例

次の例では、SiteクラスからXmlEventArgs継承するプロパティをXmlValidatingEventArgs使用して、Validate イベントを発生させたノードの値をチェックします。データ検証に失敗した場合は、ReportError メソッドを使用してカスタムエラーを作成します。

public void field1_Validating(object sender, XmlValidatingEventArgs e)
{
   if (e.Site.InnerXml != String.Empty)
   {
      int fieldValue = int.Parse((e.Site.InnerXml));

      if (fieldValue &gt; 50)
      {
         e.ReportError(e.Site,
            false,
            "Quantity cannot exceed 50.");
      }

      if (fieldValue &lt; 0)
      {
         e.ReportError(e.Site,
            false,
            "Quantity cannot be less than 0.");
      }
   }
}

Public Sub field1_Validating(ByVal sender As Object , _
   ByVal e As XmlValidatingEventArgs)
   If (e.Site.InnerXml &lt;&gt; String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

      If (fieldValue &gt; 50) Then
         e.ReportError(e.Site,
            false,
            "Quantity cannot exceed 50.")
      End If

      If (fieldValue &lt; 0) Then
         e.ReportError(e.Site,
            false,
            "Quantity cannot be less than 0.")
      End If
   End If
End Sub

注釈

ReportError メソッドは、イベント中に発生したエラーのカスタムエラーをValidating作成するために使用されます。

ReportError メソッドが呼び出されると、InfoPath により FormError オブジェクトが作成され、それが現在のフォームの FormErrorCollection に追加されます。 FormError オブジェクトは、その検証制約が有効ではなくなったときにコレクションから削除されます。場合によっては、メソッドまたは DeleteAll() メソッドを使用してDelete(FormError)明示的に削除できます。

FormError オブジェクトは、FormErrorCollection クラスのメソッドを使用してAdd(XPathNavigator, String, String, String)作成することもできます。

注: サイトに依存しないエラーは、同じ種類のすべてのノードにエラーを適用する場合に使用する必要があります。特定のノードに対してのみエラーを適用する場合は、サイトに依存するエラーを使用します。

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

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

適用対象

ReportError(XPathNavigator, Boolean, String, String)

指定した値を FormError 持つカスタムエラー情報を含むオブジェクトを作成し、フォームのオブジェクトに FormErrorCollection 追加します。

public:
 abstract void ReportError(System::Xml::XPath::XPathNavigator ^ node, bool siteIndependent, System::String ^ message, System::String ^ messageDetails);

public abstract void ReportError (System.Xml.XPath.XPathNavigator node, bool siteIndependent, string message, string messageDetails);

abstract member ReportError : System.Xml.XPath.XPathNavigator * bool * string * string -> unit

Public MustOverride Sub ReportError (node As XPathNavigator, siteIndependent As Boolean, message As String, messageDetails As String)

パラメーター

node: XPathNavigator

XPathNavigatorエラーが関連付けられているデータを含むノードに位置する。

siteIndependent: Boolean

message: String

短いエラーメッセージに使用されるテキスト。

messageDetails: String

詳細なエラーメッセージに使用されるテキスト。

例外

ArgumentException

このメソッドに渡されたパラメーターは有効ではありません。

ArgumentNullException

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

例

public void field1_Validating(object sender, XmlValidatingEventArgs e)
{
   if (e.Site.InnerXml != String.Empty)
   {
      int fieldValue = int.Parse((e.Site.InnerXml));

      if (fieldValue &gt; 50)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.");
      }

      if (fieldValue &lt; 0)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.");
      }
   }
}

Public Sub field1_Validating(ByVal sender As Object , _
   ByVal e As XmlValidatingEventArgs)
   If (e.Site.InnerXml &lt;&gt; String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

      If (fieldValue &gt; 50) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.")
      End If

      If (fieldValue &lt; 0) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.")
      End If
   End If
End Sub

注釈

ReportError メソッドは、イベント中に発生したエラーのカスタムエラーをValidating作成するために使用されます。

FormError オブジェクトは、FormErrorCollection クラスのメソッドを使用してAdd(XPathNavigator, String, String, String)作成することもできます。

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

適用対象

ReportError(XPathNavigator, Boolean, String, String, Int32)

指定した値を FormError 持つカスタムエラー情報を含むオブジェクトを作成し、フォームのオブジェクトに FormErrorCollection 追加します。

public:
 abstract void ReportError(System::Xml::XPath::XPathNavigator ^ node, bool siteIndependent, System::String ^ message, System::String ^ messageDetails, int errorCode);

public abstract void ReportError (System.Xml.XPath.XPathNavigator node, bool siteIndependent, string message, string messageDetails, int errorCode);

abstract member ReportError : System.Xml.XPath.XPathNavigator * bool * string * string * int -> unit

Public MustOverride Sub ReportError (node As XPathNavigator, siteIndependent As Boolean, message As String, messageDetails As String, errorCode As Integer)

パラメーター

node: XPathNavigator

XPathNavigatorエラーが関連付けられているデータを含むノードに位置する。

siteIndependent: Boolean

message: String

短いエラーメッセージに使用されるテキスト。

messageDetails: String

詳細なエラーメッセージに使用されるテキスト。

errorCode: Int32

エラーコードとして使用される数字。

例外

ArgumentException

このメソッドに渡されたパラメーターは有効ではありません。

ArgumentNullException

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

例

public void field1_Validating(object sender, XmlValidatingEventArgs e)
{
   if (e.Site.InnerXml != String.Empty)
   {
      int fieldValue = int.Parse((e.Site.InnerXml));

      if (fieldValue &gt; 50)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.",
            12345);

      }

      if (fieldValue &lt; 0)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.",
            12346);
      }
   }
}

Public Sub field1_Validating(ByVal sender As Object , _
   ByVal e As XmlValidatingEventArgs)
   If (e.Site.InnerXml &lt;&gt; String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

      If (fieldValue &gt; 50) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.",
            12345)
      End If

      If (fieldValue &lt; 0) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.",
            12346)
      End If
   End If
End Sub

注釈

ReportError メソッドは、イベント中に発生したエラーのカスタムエラーをValidating作成するために使用されます。

FormError オブジェクトは、FormErrorCollection クラスのメソッドを使用してAdd(XPathNavigator, String, String, String)作成することもできます。

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

適用対象

ReportError(XPathNavigator, Boolean, String, String, Int32, ErrorMode)

指定した値を FormError 持つカスタムエラー情報を含むオブジェクトを作成し、フォームのオブジェクトに FormErrorCollection 追加します。

public:
 abstract void ReportError(System::Xml::XPath::XPathNavigator ^ node, bool siteIndependent, System::String ^ message, System::String ^ messageDetails, int errorCode, Microsoft::Office::InfoPath::ErrorMode errorMode);

public abstract void ReportError (System.Xml.XPath.XPathNavigator node, bool siteIndependent, string message, string messageDetails, int errorCode, Microsoft.Office.InfoPath.ErrorMode errorMode);

abstract member ReportError : System.Xml.XPath.XPathNavigator * bool * string * string * int * Microsoft.Office.InfoPath.ErrorMode -> unit

パラメーター

node: XPathNavigator

XPathNavigatorエラーが関連付けられているデータを含むノードに位置する。

siteIndependent: Boolean

message: String

短いエラーメッセージに使用されるテキスト。

messageDetails: String

詳細なエラーメッセージに使用されるテキスト。

errorCode: Int32

エラーコードとして使用される数字。

errorMode: ErrorMode

ErrorModeエラーをモーダルダイアログボックスに表示するか、影響を受けるコントロールに波線の下線を使用してモードレスに表示するかを指定する。

例外

ArgumentException

このメソッドに渡されたパラメーターは有効ではありません。

ArgumentNullException

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

例

public void field1_Validating(object sender, XmlValidatingEventArgs e)
{
   if (e.Site.InnerXml != String.Empty)
   {
      int fieldValue = int.Parse((e.Site.InnerXml));

      if (fieldValue &gt; 50)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.",
            12345,
            ErrorMode.Modeless);
      }

      if (fieldValue &lt; 0)
      {
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.",
            12346,
            ErrorMode.Modeless);
      }
   }
}

Public Sub field1_Validating(ByVal sender As Object , _
   ByVal e As XmlValidatingEventArgs)
   If (e.Site.InnerXml &lt;&gt; String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

      If (fieldValue &gt; 50) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot exceed 50.",
            12345,
            ErrorMode.Modeless)
      End If

      If (fieldValue &lt; 0) Then
         e.ReportError(e.Site,
            false,
            "Invalid quantity",
            "The total number cannot be less than 0.",
            12346,
            ErrorMode.Modeless)
      End If
   End If
End Sub

注釈

ReportError メソッドは、イベント中に発生したエラーのカスタムエラーをValidating作成するために使用されます。

FormError オブジェクトは、FormErrorCollection クラスのメソッドを使用してAdd(XPathNavigator, String, String, String)作成することもできます。

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

適用対象

次の方法で共有

XmlValidatingEventArgs.ReportError メソッド

定義

オーバーロード

ReportError(XPathNavigator, Boolean, String)

パラメーター

例外

例

注釈

適用対象

ReportError(XPathNavigator, Boolean, String, String)

パラメーター

例外

例

注釈

適用対象

ReportError(XPathNavigator, Boolean, String, String, Int32)

パラメーター

例外

例

注釈

適用対象

ReportError(XPathNavigator, Boolean, String, String, Int32, ErrorMode)

パラメーター

例外

例

注釈

適用対象

フィードバック

その他のリソース