FormEvents.Loading Ereignis

public:
 abstract event Microsoft::Office::InfoPath::LoadingEventHandler ^ Loading;

public abstract event Microsoft.Office.InfoPath.LoadingEventHandler Loading;

member this.Loading : Microsoft.Office.InfoPath.LoadingEventHandler 

Public MustOverride Custom Event Loading As LoadingEventHandler 

Ereignistyp

Ausnahmen

Beispiele

Im folgenden Beispiel wird mithilfe des Ereignishandlers für das Loading-Ereignis bestimmt, ob das Formular digital signiert und das Feld Date1 auf das aktuelle Datum festgelegt wurde.

public void FormEvents_Loading(object sender, LoadingEventArgs e)
{
   if (this.Signed)
   {
         e.CancelableArgs.Message = 
            "This form is digitally signed. Loading is cancelled.";
         e.CancelableArgs.Cancel = true;
   }

   XPathNavigator myDate = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:date1",
      NamespaceManager);

   // Check for and delete xsi:nil="true" attribute.
   if (myDate.MoveToAttribute("nil", 
      "http://www.w3.org/2001/XMLSchema-instance"))
   {
      myDate.DeleteSelf();
   }

   myDate.SetValue(System.DateTime.Now.ToString("yyyy-MM-dd"));
}

Public Sub FormEvents_Loading(ByVal sender As Object, _
   ByVal e As LoadingEventArgs)
   If (Me.Signed)Then
         e.CancelableArgs.Message = 
            "This form is digitally signed. Loading is cancelled."
         e.CancelableArgs.Cancel = True
   End If

   Dim myDate As XPathNavigator = 
      CreateNavigator().SelectSingleNode("/my:myFields/my:date1",
      NamespaceManager)

   ' Check for and delete xsi:nil="true" attribute.
   If (myDate.MoveToAttribute("nil", 
      "http://www.w3.org/2001/XMLSchema-instance"))
      myDate.DeleteSelf();
   End If

   myDate.SetValue(System.DateTime.Now.ToString("yyyy-MM-dd"));
End Sub

Hinweise

Wichtig: Das Loading-Ereignis soll nicht vom Entwickler im Formularcode instanziiert werden. Sie sollten nur Ereignishandler für Ereignisse auf Formularebene über die Benutzeroberfläche des Microsoft InfoPath-Entwurfsmodus hinzufügen. Wenn Sie ihrer Formularvorlage über die Benutzeroberfläche des Entwurfsmodus einen Ereignishandler hinzufügen, generiert InfoPath Code in der InternalStartup-Methode Ihrer Formularcodedatei mithilfe der EventManager -Klasse und des Members der FormEvents -Klasse, um das Ereignis an ihren Ereignishandler zu binden. Weitere Informationen zum Hinzufügen von Ereignishandlern im InfoPath-Entwurfsmodus finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.

Das Loading-Ereignis wird mithilfe des LoadingEventHandler Delegaten gebunden.

Das Loading-Ereignis tritt ein, bevor das Formular geladen und die Ansicht gerendert wird.

Wenn eine Formularvorlage in einer entsprechend konfigurierten Dokumentbibliothek auf SharePoint Server 2010 unter InfoPath Forms Services bereitgestellt und geöffnet wird, tritt das Loading-Ereignis nur einmal pro Sitzung auf.

Das Loading-Ereignis kann mithilfe der CancelableArgs -Eigenschaft der SaveEventArgs -Klasse abgebrochen werden, um die Cancel-Eigenschaft auf true festzulegen.

Hinweis: Wenn das Loading-Ereignis auftritt, wird die Ansicht nicht initialisiert, und die für die Ansicht verwendete XSL-Transformation (XSLT) ist noch nicht geladen. Das XmlForm -Objekt wird der XmlFormCollection Auflistung erst hinzugefügt, nachdem das Loading-Ereignis aufgetreten ist. Das XmlForm-Objekt ist jedoch während des Loading-Ereignisses verfügbar.

Aufrufe der folgenden Methoden und Eigenschaften sind im Loading-Ereignishandler nicht möglich:

Quit()

DisableAutoUpdate()

EnableAutoUpdate()

ExecuteAction(ActionType)

Export(String, ExportFormat)

ForceUpdate()

GetContextNodes(XPathNavigator)

GetSelectedNodes()

SelectNodes(XPathNavigator)

SelectText(XPathNavigator)

SwitchView(String)

Close()

MergeForm(String)

New

Save()

SaveAs(String)

Submit()

Print()

NewFromFormTemplate(String)

Close()

TaskPanes

Aufrufe der Member der AdoSubmitConnectionKlassen , EmailSubmitConnectionoder FileSubmitConnection können im Loading-Ereignishandler nicht ausgeführt werden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

Gilt für: