DataDOMEvent.ReportError Método

Definição

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Cria um ErrorObject objeto e adiciona-o à ErrorsCollection coleção.

public Microsoft.Office.Interop.InfoPath.ErrorObject ReportError (object varNode, string bstrShortErrorMessage, bool fSiteIndependent, string bstrDetailedErrorMessage = "", int lErrorCode = 0, string bstrType = "modeless");

abstract member ReportError : obj * string * bool * string * int * string -> Microsoft.Office.Interop.InfoPath.ErrorObject

Public Function ReportError (varNode As Object, bstrShortErrorMessage As String, fSiteIndependent As Boolean, Optional bstrDetailedErrorMessage As String = "", Optional lErrorCode As Integer = 0, Optional bstrType As String = "modeless") As ErrorObject

Parâmetros

varNode

Object

O nó DOM (Modelo de Objeto de Documento XML) ao qual o erro está associado.

bstrShortErrorMessage

String

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

fSiteIndependent

Boolean

Define a condição para exclusão automática do objeto Error . Se for true, o objeto Error será excluído na alteração para quaisquer nós que correspondam à expressão XPath correspondente ao objeto Error . Se for falso, o objeto Error será excluído quando o nó retornado pela Site propriedade de um determinado objeto de evento for alterado.

bstrDetailedErrorMessage

String

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

lErrorCode

Int32

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

bstrType

String

O valor padrão é "modeless". Determina se a alteração no valor será rejeitada automaticamente ou se o usuário será solicitado a aceitar ou rejeitar a alteração. O outro valor é "modal".

Retornos

ErrorObject

O ErrorObject objeto que representa o erro recém-criado.

Exemplos

No exemplo a seguir, a Site propriedade do DataDOMEventObject objeto é usada para marcar o valor do nó. Se a validação de dados falhar, o método ReportError será usado para criar um erro personalizado.

public void field1_OnValidate(DataDOMEvent e)
{
 if (int.Parse(e.Site.text) > 50)
 {
  e.<span class="label">ReportError</span>(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot exceed 50.", 
   false,
   "",
   2,
   "modeless");
 }

 if (int.Parse(e.Site.text) &lt; 0)
 {
  e.ReportError(
   e.Site, 
   "Invalid quantity. The total number of each type of block cannot be less than 0.", 
   false,
   "",
   2,
   "modeless");
 }
}

Comentários

Quando o método ReportError é chamado, o Microsoft Office InfoPath 2003 cria um objeto Error e o adiciona à coleção Errors . Erros 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(Object, String) métodos ou DeleteAll() .

Erros também podem ser criados usando o Add(Object, String, String, String, Int32, String) método.

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

Observação: o método ReportError só pode ser usado durante o OnValidate evento.