DataDOMEvent.ReportError Método

Definição

Namespace:

Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

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

public:
 Microsoft::Office::Interop::InfoPath::SemiTrust::ErrorObject ^ ReportError(System::Object ^ varNode, System::String ^ bstrShortErrorMessage, bool fSiteIndependent, System::String ^ bstrDetailedErrorMessage, int lErrorCode, System::String ^ bstrType);

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

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

Public Function ReportError (varNode As Object, bstrShortErrorMessage As String, fSiteIndependent As Boolean, bstrDetailedErrorMessage As String, lErrorCode As Integer, bstrType As String) 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.

[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnValidate)]
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 InfoPath cria um objeto Error e adiciona-o à 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.

Importante: esse membro só pode ser acessado por formulários em execução no mesmo domínio que o formulário aberto atualmente ou por formulários que receberam permissões entre domínios.