FormEvents.Loading Événement

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 

Type d'événement

Exceptions

Exemples

Dans l'exemple suivant, le gestionnaire de l'événement Loading permet de déterminer si le formulaire a été signé numériquement et, si ce n'est pas le cas, affecte la date du jour au champ Date1.

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

Remarques

Important : l’événement Loading n’est pas destiné à être instancié par le développeur dans le code du formulaire. Vous devez uniquement ajouter des gestionnaires d’événements pour les événements au niveau du formulaire à partir de l’interface utilisateur du mode création Microsoft InfoPath. Lorsque vous ajoutez un gestionnaire d’événements à votre modèle de formulaire à partir de l’interface utilisateur en mode Création, InfoPath génère du code dans la méthode InternalStartup de votre fichier de code de formulaire à l’aide de la EventManager classe et du membre de la FormEvents classe pour lier l’événement à son gestionnaire d’événements. Pour plus d'informations sur l'ajout de gestionnaires d'événements en mode Création dans InfoPath, consultez Procédure : Ajouter un gestionnaire d'événements.

L’événement Loading est lié à l’aide du LoadingEventHandler délégué.

L'événement Loading se produit avant le chargement du formulaire et avant le rendu d'une vue quelconque.

Si un modèle de formulaire est déployé et ouvert à partir d’une bibliothèque de documents configurée de manière appropriée sur SharePoint Server 2010 exécutant InfoPath Forms Services, l’événement Loading ne se produit qu’une seule fois par session.

L’événement Loading peut être annulé en utilisant la CancelableArgs propriété de la SaveEventArgs classe pour définir la propriété Cancel sur true.

Remarque : Lorsque l’événement Loading se produit, la vue n’est pas initialisée et la transformation XSL (XSLT) utilisée pour la vue n’est pas encore chargée. L’objet XmlForm n’est pas ajouté à la XmlFormCollection collection tant que l’événement Loading ne s’est pas produit. L'objet XmlForm est toutefois accessible pendant l'événement Loading.

Il est impossible d'appeler les propriétés et méthodes suivantes dans le gestionnaire d'événements Loading :

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

Les appels aux membres des AdoSubmitConnectionclasses , EmailSubmitConnectionou FileSubmitConnection ne peuvent pas être effectués dans le gestionnaire d’événements Loading .

Vous pouvez accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler ou dans un navigateur web.

S’applique à