OnSaveRequest-hendelsen

Inntreffer når lagreoperasjonen aktiveres fra Microsoft Office InfoPath 2003-brukergrensesnittet eller ved hjelp av Save- eller SaveAs-metoden for XDocument-objektet i InfoPath-objektmodellen.

Funksjon XDocument::OnSaveRequest(ByRef pEvent As SaveEvent)

pEvent    Obligatorisk SaveEvent. En referanse til SaveEvent-objektet.

Merknader

Hvis ReturnStatus-egenskapen for SaveEvent-objektet er satt til False, avbryter InfoPath lagreoperasjonen. Hvis det oppstår en feil i koden for OnSaveRequest-hendelsesbehandlingen, ignorerer InfoPath feilen og bruker ReturnStatus-egenskapen for SaveEvent-objektet. Hvis ReturnStatus-egenskapen ikke er eksplisitt angitt, brukes standardverdien False.

ReturnStatus-egenskapen virker sammen med IsCancelled-egenskapen når InfoPath-skjemaet lukkes. Hvis dokumentet inneholder endringer som ikke er lagret, og brukeren avbryter lagreoperasjonen, kan IsCancelled-egenskapen settes til True for at InfoPath skal kunne lukkes.

Obs!  Denne objektmodellen støttes ikke når alternativet Deaktiver funksjoner fra oppdateringspakke under Avansert-kategorien i Alternativer-dialogboksen i InfoPath er valgt, eller når Microsoft Office 2003 Service Pack 1 eller senere ikke er installert. Skjemaer som implementerer dette objektmodellmedlemmet i kode, vil generere en feilmelding hvis de åpnes i InfoPath nå oppdateringspakkefunksjoner er deaktivert eller ikke er tilgjengelige.

Eksempel

I eksempelet nedenfor brukes hendelsesbehandlingen OnSaveRequest til å opprette et XMLHTTP-objekt for overføring av skjemaets underliggende XML-dokument:

function XDocument::OnSaveRequest(eventObj)
{
	// Write the code to be run before saving here.

	XDocument.UI.Alert("Begin saving form.");

	eventObj.IsCancelled = eventObj.PerformSaveOperation();

	// Write the code to be run after saving here.

	XDocument.UI.Alert("Form saved.");

	eventObj.ReturnStatus = true;
}