Compartilhar via


XmlValidatingEventArgs.ReportError Método

Definição

Sobrecargas

ReportError(XPathNavigator, Boolean, String)

Cria um FormError objeto que contém informações de erro personalizadas com os valores especificados e o adiciona ao FormErrorCollection objeto do formulário.

ReportError(XPathNavigator, Boolean, String, String)

Cria um FormError objeto que contém informações de erro personalizadas com os valores especificados e o adiciona ao FormErrorCollection objeto do formulário.

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

Cria um FormError objeto que contém informações de erro personalizadas com os valores especificados e o adiciona ao FormErrorCollection objeto do formulário.

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

Cria um FormError objeto que contém informações de erro personalizadas com os valores especificados e o adiciona ao FormErrorCollection objeto do formulário.

ReportError(XPathNavigator, Boolean, String)

Cria um FormError objeto que contém informações de erro personalizadas com os valores especificados e o adiciona ao FormErrorCollection objeto do formulário.

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)

Parâmetros

node
XPathNavigator

Um XPathNavigator posicionado no nó que contém os dados aos quais o erro está associado.

siteIndependent
Boolean

Define a condição para exclusão automática do objeto FormError . Se definido como true, o objeto FormError será excluído para alterações em quaisquer nós que correspondam à expressão XPath retornada pela Match propriedade deste objeto de evento. Se definido como false, o objeto FormError será excluído na próxima vez que o formulário for validado somente quando o nó retornado pela Site propriedade desse objeto de evento tiver sido alterado.

message
String

O texto a ser usado para a mensagem de erro curta.

Exceções

Os parâmetros passados para esse método não são válidos.

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Exemplos

No exemplo a seguir, a Site propriedade que a XmlValidatingEventArgs classe herda da XmlEventArgs classe é usada para marcar o valor do nó que levantou o evento Validando. Se a validação de dados falhar, o método ReportError será usado para criar um erro personalizado.

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

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

      if (fieldValue < 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 <> String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

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

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

Comentários

O método ReportError é usado para criar um erro personalizado para um erro ocorrido durante o Validating evento.

Quando o método ReportError é chamado, o InfoPath cria um objeto FormError e o adiciona ao FormErrorCollection do formulário atual. Os objetos FormError são removidos da coleção quando a restrição de validação não é mais inválida. Em determinados casos, eles podem ser removidos explicitamente usando os Delete(FormError) métodos ou DeleteAll() .

Objetos FormError também podem ser criados usando o Add(XPathNavigator, String, String, String) método da classe FormErrorCollection.

Observação: erros independentes do site devem ser usados quando você deseja que os erros sejam aplicados a todos os nós do mesmo tipo. Se você quiser que o erro se aplique a um nó específico, use erros dependentes do site.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a

ReportError(XPathNavigator, Boolean, String, String)

Cria um FormError objeto que contém informações de erro personalizadas com os valores especificados e o adiciona ao FormErrorCollection objeto do formulário.

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)

Parâmetros

node
XPathNavigator

Um XPathNavigator posicionado no nó que contém os dados aos quais o erro está associado.

siteIndependent
Boolean

Define a condição para exclusão automática do objeto FormError . Se definido como true, o objeto FormError será excluído para alterações em quaisquer nós que correspondam à expressão XPath retornada pela Match propriedade deste objeto de evento. Se definido como false, o objeto FormError será excluído na próxima vez que o formulário for validado somente quando o nó retornado pela Site propriedade desse objeto de evento tiver sido alterado.

message
String

O texto a ser usado para a mensagem de erro curta.

messageDetails
String

O texto a ser usado para a mensagem de erro detalhada.

Exceções

Os parâmetros passados para esse método não são válidos.

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Exemplos

No exemplo a seguir, a Site propriedade que a XmlValidatingEventArgs classe herda da XmlEventArgs classe é usada para marcar o valor do nó que levantou o evento Validando. Se a validação de dados falhar, o método ReportError será usado para criar um erro personalizado.

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

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

      if (fieldValue < 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 <> String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

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

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

Comentários

O método ReportError é usado para criar um erro personalizado para um erro ocorrido durante o Validating evento.

Quando o método ReportError é chamado, o InfoPath cria um objeto FormError e o adiciona ao FormErrorCollection do formulário atual. Os objetos FormError são removidos da coleção quando a restrição de validação não é mais inválida. Em determinados casos, eles podem ser removidos explicitamente usando os Delete(FormError) métodos ou DeleteAll() .

Objetos FormError também podem ser criados usando o Add(XPathNavigator, String, String, String) método da classe FormErrorCollection.

Observação: erros independentes do site devem ser usados quando você deseja que os erros sejam aplicados a todos os nós do mesmo tipo. Se você quiser que o erro se aplique a um nó específico, use erros dependentes do site.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a

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

Cria um FormError objeto que contém informações de erro personalizadas com os valores especificados e o adiciona ao FormErrorCollection objeto do formulário.

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)

Parâmetros

node
XPathNavigator

Um XPathNavigator posicionado no nó que contém os dados aos quais o erro está associado.

siteIndependent
Boolean

Define a condição para exclusão automática do objeto FormError . Se definido como true, o objeto FormError será excluído para alterações em quaisquer nós que correspondam à expressão XPath retornada pela Match propriedade deste objeto de evento. Se definido como false, o objeto FormError será excluído na próxima vez que o formulário for validado somente quando o nó retornado pela Site propriedade desse objeto de evento tiver sido alterado.

message
String

O texto a ser usado para a mensagem de erro curta.

messageDetails
String

O texto a ser usado para a mensagem de erro detalhada.

errorCode
Int32

O número a ser usado como o código de erro.

Exceções

Os parâmetros passados para esse método não são válidos.

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Exemplos

No exemplo a seguir, a Site propriedade que a XmlValidatingEventArgs classe herda da XmlEventArgs classe é usada para marcar o valor do nó que levantou o evento Validando. Se a validação de dados falhar, o método ReportError será usado para criar um erro personalizado.

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

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

      }

      if (fieldValue < 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 <> String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

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

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

Comentários

O método ReportError é usado para criar um erro personalizado para um erro ocorrido durante o Validating evento.

Quando o método ReportError é chamado, o InfoPath cria um objeto FormError e o adiciona ao FormErrorCollection do formulário atual. Os objetos FormError são removidos da coleção quando a restrição de validação não é mais inválida. Em determinados casos, eles podem ser removidos explicitamente usando os Delete(FormError) métodos ou DeleteAll() .

Objetos FormError também podem ser criados usando o Add(XPathNavigator, String, String, String) método da classe FormErrorCollection.

Observação: erros independentes do site devem ser usados quando você deseja que os erros sejam aplicados a todos os nós do mesmo tipo. Se você quiser que o erro se aplique a um nó específico, use erros dependentes do site.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.

Aplica-se a

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

Cria um FormError objeto que contém informações de erro personalizadas com os valores especificados e o adiciona ao FormErrorCollection objeto do formulário.

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

Parâmetros

node
XPathNavigator

Um XPathNavigator posicionado no nó que contém os dados aos quais o erro está associado.

siteIndependent
Boolean

Define a condição para exclusão automática do objeto FormError . Se definido como true, o objeto FormError será excluído para alterações em quaisquer nós que correspondam à expressão XPath retornada pela Match propriedade deste objeto de evento. Se definido como false, o objeto FormError será excluído na próxima vez que o formulário for validado somente quando o nó retornado pela Site propriedade desse objeto de evento tiver sido alterado.

message
String

O texto a ser usado para a mensagem de erro curta.

messageDetails
String

O texto a ser usado para a mensagem de erro detalhada.

errorCode
Int32

O número a ser usado como o código de erro.

errorMode
ErrorMode

Um ErrorMode que especifica se o erro será exibido em uma caixa de diálogo modal ou modeladamente com um sublinhado ondulado no controle afetado.

Exceções

Os parâmetros passados para esse método não são válidos.

Os parâmetros passados para esse método são uma referência nula (Nada no Visual Basic).

Exemplos

No exemplo a seguir, a Site propriedade que a XmlValidatingEventArgs classe herda da XmlEventArgs classe é usada para marcar o valor do nó que levantou o evento Validando. Se a validação de dados falhar, o método ReportError será usado para criar um erro personalizado.

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

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

      if (fieldValue < 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 <> String.Empty) Then
      Integer fieldValue = Integer.Parse((e.Site.InnerXml))

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

      If (fieldValue < 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

Comentários

O método ReportError é usado para criar um erro personalizado para um erro ocorrido durante o Validating evento.

Quando o método ReportError é chamado, o InfoPath cria um objeto FormError e o adiciona ao FormErrorCollection do formulário atual. Os objetos FormError são removidos da coleção quando a restrição de validação não é mais inválida. Em determinados casos, eles podem ser removidos explicitamente usando os Delete(FormError) métodos ou DeleteAll() .

Objetos FormError também podem ser criados usando o Add(XPathNavigator, String, String, String) método da classe FormErrorCollection.

Observação: erros independentes do site devem ser usados quando você deseja que os erros sejam aplicados a todos os nós do mesmo tipo. Se você quiser que o erro se aplique a um nó específico, use erros dependentes do site.

This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

This type or member can be accessed only from code running in forms opened in Microsoft InfoPath Filler.

Aplica-se a