OnSubmitRequest-hendelsen

Inntreffer når sendeoperasjonen startes fra Microsoft Office InfoPath 2003-brukergrensesnittet eller ved hjelp av Submit-metoden for XDocument-objektet i InfoPath-objektmodellen.

Funksjon XDocument::OnSubmitRequest(ByRef pEvent As DocReturnEvent)

pEvent Obligatorisk DocReturnEvent. En referanse til DocReturnEvent-objektet.

Merknader

Denne hendelsesbehandlingen tillater at brukeren avbryter en operasjon.

Hvis ReturnStatus-egenskapen for DocReturnEvent-objektet er satt til False, avbryter InfoPath sendeoperasjonen. Hvis det oppstår en feil i skriptkoden for hendelsesbehandlingen OnSubmitRequest, ignorerer InfoPath den og bruker ReturnStatus-egenskapen for DocReturnEvent-objektet. Hvis ReturnStatus-egenskapen ikke er eksplisitt angitt, brukes standardverdien False.

Eksempel

I eksemplet nedenfor brukes hendelsesbehandlingen OnSubmitRequest til å opprette et XMLHTTP-objekt for transport av skjemaets underliggende XML-dokument:

function XDocument::OnSubmitRequest(eventObj)
{
   // Create an XMLHTTP object for document transport.
   try
   {
      var objXmlHttp = new ActiveXObject("MSXML2.XMLHTTP");
   }
   catch(ex)
   {
      XDocument.UI.Alert("Could not create MSXML2.XMLHTTP 
         object.\r\n" + ex.number + " - " + ex.description);

      // Return with eventObj.ReturnStatus == false, 
      // because no change was made to this value.
      return;	
   }

   // Post the XML document to strUrl.
   objXmlHttp.open("POST", strUrl, false);
   try
   {
      objXmlHttp.send(XDocument.DOM.xml);
   }
   catch(ex)
   {
      XDocument.UI.Alert("Could not post (ASP) document to " + 
         strUrl + "\r\n" + ex.number + " - " + ex.description);

      // Return with eventObj.ReturnStatus == false.
      return;
   }
   // If here, the submit operation is has been successful.
   eventObj.ReturnStatus = true;	
}