View.DisableAutoUpdate - Méthode
Désactive la synchronisation automatique entre le document XML sous-jacent d'un formulaire et la vue associée.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Sub DisableAutoUpdate
'Utilisation
Dim instance As View
instance.DisableAutoUpdate()
public abstract void DisableAutoUpdate()
Exceptions
Exception | Condition |
---|---|
InvalidOperationException | La méthode DisableAutoUpdate a été appelée depuis un gestionnaire d’événements pour l’événement Loading. |
Remarques
Les vues d’un formulaire sont automatiquement synchronisées avec les données contenues dans le document XML sous-jacent de ce formulaire. Vous pouvez empêcher cette synchronisation automatique en utilisant la méthode DisableAutoUpdate. Cela peut s’avérer utile pour améliorer les performances, par exemple en cas de nombreuses modifications par programmation dans le document XML sous-jacent d’un formulaire et si vous ne souhaitez pas que la vue soit actualisée tant que les modifications ne sont pas terminées.
Par défaut, les vues seront mises à jour automatiquement lorsque l’application sera libre. La synchronisation des vues peut être réactivée à l’aide de la méthode EnableAutoUpdate.
Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.
Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.
Exemples
Dans l’exemple suivant, la méthode DisableAutoUpdate de la classe View est utilisée pour désactiver la synchronisation entre le document XML sous-jacent d’un formulaire et la vue à laquelle il est associé.
this.CurrentView.DisableAutoUpdate();
Me.CurrentView.DisableAutoUpdate()