FormErrorCollection Classe

Definição

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 a seguir, primeiro um objeto XPathNavigator é posicionado no campo com o qual associar um erro. Em seguida, os detalhes da mensagem XPathNavigator e de erro são passados para o 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 coleção de erros inclui erros de validação, erros gerados pelo sistema e erros definidos pelo usuário (personalizados). A classe FormErrorCollection fornece propriedades e métodos para adicionar, excluir e obter acesso aos objetos FormError que ele contém. Você não pode excluir erros de validação ou gerados pelo sistema desta coleção.

Além de gerenciar os erros gerados pelo InfoPath, a classe FormErrorCollection também pode ser usada para criar erros personalizados usando o Add método.

Observação: erros personalizados também podem ser criados usando o ReportError método da XmlValidatingEventArgs classe.

Para acessar o objeto FormErrorCollection associado a um formulário, use a Errors propriedade da XmlForm classe.

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

Construtores

Propriedades

Métodos

Aplica-se a