DataDOMEventObject Interface

Definição

Namespace:

Microsoft.Office.Interop.InfoPath

Assembly:

Microsoft.Office.Interop.InfoPath.dll

Um objeto de evento que é usado durante eventos de validação de dados do Microsoft InfoPath.

public interface class DataDOMEventObject : Microsoft::Office::Interop::InfoPath::DataDOMEvent

[System.Runtime.InteropServices.Guid("096CD5E5-0786-11D1-95FA-0080C78EE3BB")]
public interface DataDOMEventObject : Microsoft.Office.Interop.InfoPath.DataDOMEvent

type DataDOMEventObject = interface
    interface DataDOMEvent

Public Interface DataDOMEventObject
Implements DataDOMEvent

Derivado

Microsoft.Office.Interop.InfoPath.DataDOMEventObjectClass

Atributos

GuidAttribute

Implementações

DataDOMEvent

Exemplos

No exemplo a seguir, o objeto DataDOMEvent é usado para marcar o valor do nó usando a Site propriedade. Se a validação de dados falhar, o ReportError(Object, String, Boolean, String, Int32, String) método será usado para criar um erro personalizado.

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

This type is a wrapper for a coclass that is required by managed code for COM interoperability. Use this type to access the members of the COM interface implemented by this coclass. Para obter informações sobre a interface COM, incluindo um link para descrições de seus membros, consulteDataDOMEvent.

O objeto DataDOMEvent fornece várias propriedades e um método que pode ser usado em um evento de validação de dados para interagir programaticamente com os dados que estão sendo validados e fornecer uma resposta se os dados não forem válidos.

O objeto DataDOMEvent é passado como um parâmetro para o OnBeforeChange, o OnValidatee os OnAfterChange eventos

Observação: o evento OnValidate pode ocorrer sem uma alteração no documento XML subjacente do formulário.

O objeto DataDOMEvent é usado para obter informações sobre o nó DOM (Modelo de Objeto de Documento XML) que está sendo alterado e também fornece uma propriedade para obter uma referência ao documento XML subjacente de um formulário. Além disso, ele fornece propriedades para lidar com a alteração de dados, incluindo rejeitar a alteração e criar uma mensagem de erro.

Observação: o objeto DataDOMEvent é passado como um argumento para um dos manipuladores de eventos de validação de dados. Suas propriedades e métodos só estão disponíveis durante o evento para o qual ele é passado.

Propriedades

IsUndoRedo	Obtém um valor que indica se o evento de validação de dados ocorre durante uma operação de desfazer ou uma operação de refazer. (Herdado de DataDOMEvent)
MatchExpression	Obtém a expressão XPath para o nó DOM (Modelo de Objeto de Documento XML) para o qual o evento está sendo processado no momento. (Herdado de DataDOMEvent)
NewValue	Obtém o valor de um nó DOM (Modelo de Objeto de Documento XML) que está sendo atualizado ou inserido durante um evento de validação de dados. (Herdado de DataDOMEvent)
OldValue	Obtém o valor original de um nó DOM (Modelo de Objeto de Documento XML) que está sendo atualizado ou excluído durante um evento de validação de dados. (Herdado de DataDOMEvent)
Operation	Obtém o tipo de ação que é aplicada a um nó DOM (Modelo de Objeto de Documento XML) durante um evento de validação de dados. (Herdado de DataDOMEvent)
Parent	Obtém uma referência ao nó DOM (Modelo de Objeto de Documento XML) do pai do nó XML DOM que está sendo alterado durante um evento de validação de dados. (Herdado de DataDOMEvent)
ReturnMessage	Obtém ou define a mensagem de erro que será retornada se o evento de validação de dados não for bem-sucedido. (Herdado de DataDOMEvent)
ReturnStatus	Obtém ou define um valor que indica o retorno status do evento de validação de dados. (Herdado de DataDOMEvent)
Site	Obtém uma referência ao nó DOM (Modelo de Objeto de Documento XML) em que o evento de validação de dados está sendo processado no momento. (Herdado de DataDOMEvent)
Source	Obtém uma referência ao DOM (Modelo de Objeto de Documento XML) em que o evento de validação de dados está ocorrendo. (Herdado de DataDOMEvent)
XDocument	Obtém uma referência ao XDocument objeto associado ao DataDOMEventObject objeto durante um evento de validação de dados. (Herdado de DataDOMEvent)

Métodos

ReportError(Object, String, Boolean, String, Int32, String)

Cria um ErrorObject objeto e adiciona-o à ErrorsCollection coleção. (Herdado de DataDOMEvent)