Oppretter et Error-objekt og legger det til i Errors-samlingen.
expression.ReportError(ByVal varNode As Variant, ByVal bstrShortErrorMessage As String, ByVal fSiteIndependent As Boolean, [ByVal bstrDetailedErrorMessage As String], [ByVal lErrorCode As Long], [ByVal bstrType As String = "modeless"]) As Error
expression Obligatorisk. Returnerer en referanse til DataDOMEvent-objektet.
varNode Obligatorisk Variant. XML Document Object Model (DOM)-noden som feilen er tilknyttet.
bstrShortErrorMessage Obligatorisk String. Teksten som skal brukes for den korte feilmeldingen.
fSiteIndependent Valgfritt Boolean. Angir betingelsen for automatisk sletting av Error-objektet. Hvis True, slettes Error-objektet når noder som samsvarte med XPath-uttrykket som tilsvarte Error-objektet, endres. Hvis False, slettes Error-objektet når noden som returneres av Site-egenskapen for et gitt hendelsesobjekt, er endret.
bstrDetailedErrorMessage Valgfritt String. Teksten som skal brukes for den detaljerte feilmeldingen.
lErrorCode Valgfritt Long. Nummeret som skal brukes som feilkode.
bstrType Valgfritt String. Standardverdien er "uten modus". Avgjør om endringen i verdien skal avvises automatisk, eller om brukeren skal bli bedt om å godta eller avvise endringen. Den andre verdien er "modal".
returns En referanse til et Error-objekt.
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
Når ReportError-metoden for DataDOMEvent-objektet kalles, oppretter Microsoft Office InfoPath 2003 et Error-objekt og legger det til i Errors-samlingen. Feil fjernes fra samlingen når valideringsbegrensningen ikke lenger er gyldig eller når de fjernes eksplisitt med Delete- eller DeleteAll-metoden for Errors-samlingen.
Feil kan også opprettes med Add-metoden for Errors-samlingen.
Obs! Du bør bruke områdeuavhengige feil hvis du vil at feilene skal gjelde for alle XML DOM-noder av samme type. Hvis du vil at feilen skal gjelde for en spesifikk XML DOM-node, bruker du områdeavhengige feil.
Eksempel
I eksemplet fra eksempelskjemaet Data Validation nedenfor brukes ReportError-metoden for DataDOMEvent-objektet til å opprette en egendefinert feil og legge den til i Errors-samlingen:
function msoxd__total::OnValidate(eventObj)
{
if (parseInt(eventObj.Site.nodeTypedValue, 10) > 75)
eventObj.ReportError(eventObj.Site, "The total is too high. " +
"The total number of blocks cannot be greater than 75.", false);
if (parseInt(eventObj.Site.nodeTypedValue, 10) < 0)
eventObj.ReportError(eventObj.Site, "The total is too low. " +
The total number of blocks cannot be less than 0.", false);
}