Classe FormErrorCollection

Articolo
04/27/2010

Contiene un oggetto FormError per ogni errore nel modulo corrente.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

<DefaultMemberAttribute("Item")> _
Public MustInherit Class FormErrorCollection
    Implements IEnumerable

Dim instance As FormErrorCollection

[DefaultMemberAttribute("Item")] 
public abstract class FormErrorCollection : IEnumerable

Osservazioni

Un oggetto FormErrorCollection contiene un insieme di oggetti FormError che rappresentano tutti gli errori che si verificano nel modulo associato. L'insieme include errori di convalida, errori generati dal sistema e errori definiti dall'utente, o personalizzati. La classe FormErrorCollection implementa proprietà e metodi per l'aggiunta e l'eliminazione degli oggetti FormError in essa contenuti, nonché l'accesso a tali oggetti. Non è possibile eliminare dall'insieme gli errori di convalida o quelli generati dal sistema.

Oltre che per gestire gli errori generati da InfoPath, la classe FormErrorCollection può essere utilizzata per creare errori personalizzati tramite il metodo Add.

Nota:
Gli errori personalizzati possono inoltre essere creati utilizzando il metodo ReportError della classe XmlValidatingEventArgs.

Per accedere all'oggetto FormErrorCollection associato a un modulo, utilizzare la proprietà Errors della classe XmlForm.

FormErrorCollection myErrors = this.Errors;

Dim myErrors As FormErrorCollection = Me.Errors

Esempio

Nell'esempio seguente viene innanzitutto posizionato un oggetto XPathNavigator nel campo a cui si desidera associare un errore e quindi l'oggetto XPathNavigator e i dettagli del messaggio di errore vengono passati al metodo Add della classe FormErrorCollection per aggiungere l'errore all'insieme di errori del modulo.

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)

Gerarchia di ereditarietà

System.Object
Microsoft.Office.InfoPath.FormErrorCollection

Thread Safety

Tutti i membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Membri FormErrorCollection
Spazio dei nomi Microsoft.Office.InfoPath

Condividi tramite