Classe FormError

Articolo
04/27/2010

Rappresenta un errore nell'insieme FormErrorCollection di un modulo.

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

Sintassi

Public MustInherit Class FormError

Dim instance As FormError

public abstract class FormError

Osservazioni

Ogni oggetto FormError di un modulo di InfoPath è associato a un nodo nel documento XML sottostante del modulo. Quando per un nodo particolare la convalida dei dati ha esito negativo, in InfoPath viene creato un oggetto FormError, che viene posizionato nell'insieme FormErrorCollection associato al modulo.

In un modulo di InfoPath possono verificarsi tre tipi di errore di convalida dei dati, che possono essere determinati utilizzando la proprietà FormErrorType della classe FormError:

FormErrorType.SchemaValidation La convalida dei dati non è riuscita a causa di un vincolo definito nello schema XML.
FormErrorType.SystemGenerated La convalida dei dati non è riuscita a causa di vincoli definiti nel file di definizione del modulo, con estensione xsf, o in seguito alla chiamata del metodo ReportError della classe XmlValidatingEventArgs.
FormErrorType.UserDefined La convalida dei dati non è riuscita a causa di un errore personalizzato definito utilizzando il metodo Add della classe FormErrorsCollection.

Esempio

Nell'esempio seguente viene ottenuto, facendo clic sul controllo Pulsante, il primo errore nell'insieme FormErrorCollection del modulo e quindi vengono visualizzati i valori di tutte le proprietà dell'oggetto FormError.

public void ErrorBtn_Clicked(object sender, ClickedEventArgs e)
{
   FormError er = this.Errors[0];
   MessageBox.Show("Short message: " + er.Message);
   MessageBox.Show("Detailed message: " + er.DetailedMessage); 
   MessageBox.Show("Error code: " + er.ErrorCode);
   MessageBox.Show("Error name: " + er.Name);
   MessageBox.Show("Error type: " + er.FormErrorType.ToString());
   MessageBox.Show("Error site XML: " + er.Site.OuterXml.ToString());
}

Public Sub ErrorBtn_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   FormError er = Me.Errors(0)
   MessageBox.Show("Short message: " & er.Message)
   MessageBox.Show("Detailed message: " & er.DetailedMessage) 
   MessageBox.Show("Error code: " & er.ErrorCode)
   MessageBox.Show("Error name: " & er.Name);
   MessageBox.Show("Error type: " & er.FormErrorType.ToString())
   MessageBox.Show("Error site XML: " & er.Site.OuterXml.ToString())
End Sub

Gerarchia di ereditarietà

System.Object
Microsoft.Office.InfoPath.FormError

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 FormError
Spazio dei nomi Microsoft.Office.InfoPath

Condividi tramite