Legger til et Error-objekt i Errors-samlingen og returnerer en referanse til det nye Error-objektet.
expression.Add(ByVal varNode As Variant, ByVal bstrConditionName As String, ByVal bstrShortErrorMessage As String, [ByVal bstrDetailedErrorMessage As String], [ByVal lErrorCode As Long], [ByVal bstrType As String = "modeless"]) As Error
expression Obligatorisk. Et uttrykk som returnerer en referanse til Errors-samlingen.
varNode Obligatorisk Variant. XML-noden som feilen knyttes til.
bstrConditionName Obligatorisk String. Navnet på feilen.
bstrShortErrorMessage Obligatorisk String. Kortmeldingen for feilen.
bstrDetailedErrorMessage Valgfritt String. Den detaljerte meldingen for feilen.
lErrorCode Valgfritt Long Integer. Standardverdien er 0. Feilkoden for feilen.
bstrType Valgfritt String. Standardverdien er "uten modus". Type feilbehandling. Den andre verdien som støttes er "modal".
returns En referanse til Error-objektet som nettopp er opprettet.
Sikkerhetsnivå
2: Kan åpnes bare av skjemaer som kjører på samme domene som skjemaet som i øyeblikket er åpent, eller av skjemaer som har fått tillatelser på tvers av domener.
Merknader
Add-metoden brukes til å opprette egendefinerte feilmeldinger i et Microsoft Office InfoPath 2003-skjema. Du kan opprette to typer feil med Add-metoden:
- ikke-modal Brukeren blir varslet om feilen med et innlagt varsel og kan velge å returnere til forrige verdi med en angreoperasjon.
- modal Brukeren blir varslet om feilen med et dialogboksvarsel. Brukeren kan klikke OK i dialogboksen for å vise feilen som et innlagt varsel, og deretter velge å returnere til forrige verdi med en angreoperasjon.
Obs! Egendefinerte feil kan også opprettes ved hjelp av ReportError-metoden for DataDOMEvent-objektet.
Eksempel
I eksemplet nedenfor brukes Add-metoden for Errors-samlingen til å opprette en egendefinert feilmelding:
var objErrors;
var objError;
objErrors = XDocument.Errors;
objError = objErrors.Add(MyXMLNode, "ValidationError", "The data is invalid.");