FormErrorCollection Classe

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Contém um FormError objeto para cada erro no formulário atual.

public ref class FormErrorCollection abstract : System::Collections::IEnumerable

public abstract class FormErrorCollection : System.Collections.IEnumerable

type FormErrorCollection = class
    interface IEnumerable

Public MustInherit Class FormErrorCollection
Implements IEnumerable

Herança

Object

FormErrorCollection

Implementações

IEnumerable

Exemplos

No exemplo seguinte, primeiro um objeto XPathNavigator é posicionado no campo com o qual pretende associar um erro. Em seguida, os detalhes do XPathNavigator e da mensagem de erro são transmitidos ao Add método da classe FormErrorCollection para adicionar o erro à coleção de erros do formulário.

XPathNavigator root, txtbox;
// Create XPathNavigator for main data source.
root = this.MainDataSource.CreateNavigator();

// Create XPathNavigator positioned at field to associate with error.
txtbox = root.SelectSingleNode("//my:field1", this.NamespaceManager);

// Get form's collection of errors and add error.
this.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless);

Dim root, txtbox As XPathNavigator
' Create XPathNavigator for main data source.
root = Me.MainDataSource.CreateNavigator()

' Create XPathNavigator positioned at field to add error.
txtbox = root.SelectSingleNode("//my:field1", Me.NamespaceManager)

' Get form's collection of errors and add error.
Me.Errors.Add(txtbox, "Field1Error", "Short error message.", 
   "Detailed error description.", 102057, ErrorMode.Modeless)

Comentários

Um objeto FormErrorCollection contém uma coleção de objetos FormError que representam todos os erros que ocorrem no formulário associado. A recolha de erros inclui erros de validação, erros gerados pelo sistema e erros definidos pelo utilizador (personalizado). A classe FormErrorCollection fornece propriedades e métodos para adicionar, eliminar e obter acesso aos objetos FormError que contém. Não é possível eliminar erros de validação ou gerados pelo sistema desta coleção.

Além de gerir os erros gerados pelo InfoPath, a classe FormErrorCollection também pode ser utilizada para criar erros personalizados com o Add método .

Nota: os erros personalizados também podem ser criados com o ReportError método da XmlValidatingEventArgs classe .

Para aceder ao objeto FormErrorCollection associado a um formulário, utilize a Errors propriedade da XmlForm classe .

FormErrorCollection myErrors = this.Errors; Dim myErrors As FormErrorCollection = Me.Errors

Construtores

FormErrorCollection()

Contém um FormError objeto para cada erro no formulário atual.

Propriedades

Count	Obtém o número de FormError objetos no FormErrorCollection objeto associado ao formulário atual.
Item[Int32]	Obtém um FormError objeto do FormErrorCollection objeto associado ao formulário atual por valor de índice.

Métodos

Add(XPathNavigator, String, String, String, Int32, ErrorMode)	Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.
Add(XPathNavigator, String, String, String, Int32)	Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.
Add(XPathNavigator, String, String, String)	Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.
Add(XPathNavigator, String, String)	Cria e adiciona um novo FormError ao FormErrorCollection objeto associado ao formulário atual.
Delete(FormError)	Elimina o especificado FormError do FormErrorCollection objeto associado ao formulário atual.
Delete(String)	Elimina todos os FormError objetos do nome especificado do FormErrorCollection objeto associado ao formulário atual.
DeleteAll()	Elimina todos os FormError objetos contidos no FormErrorCollection objeto associado ao formulário atual.
GetEnumerator()	Obtém um IEnumerator objeto que itera todas as entradas na coleção.
GetErrors(FormErrorType)	Devolve todos os FormError objetos do tipo especificado do FormErrorCollection objeto associado ao formulário atual.
GetErrors(String)	Devolve todos os FormError objetos do nome especificado do FormErrorCollection objeto associado ao formulário atual.