XDocument, interface

Article
04/27/2010

Représente le document XML sous-jacent d'un formulaire Microsoft Office InfoPath.

Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans microsoft.office.interop.infopath.dll)

Syntaxe

<GuidAttribute("096CD6A8-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(XDocumentClass))> _
Public Interface XDocument
    Inherits _XDocument2, _XDocumentEventSink2_Event

Dim instance As XDocument

[GuidAttribute("096CD6A8-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(XDocumentClass))] 
public interface XDocument : _XDocument2, _XDocumentEventSink2_Event

Remarques

Ce type est le wrapper d'une classe de composants (coclass) requise par le code managé pour l'interopérabilité COM. Ce type permet d'accéder aux membres de l'interface COM implémentés par cette classe de composants. Pour plus d'informations sur l'interface COM, et pour accéder aux descriptions de ses membres, voir _XDocument3.

L'objet XDocument est un objet clé dans le modèle objet d'InfoPath : il fournit des propriétés, des méthodes et des événements qui peuvent être utilisés pour interagir avec les données XML source d'un formulaire et les manipuler.

Bien que l'objet XDocument soit accessible à l'aide de la collection XDocumentsCollection, vous pouvez, dans la plupart des cas, y accéder à partir de la variable thisXDocument instanciée dans la méthode _Startup d'un projet avec code managé sans passer par la collection.

Les données XML source d'un formulaire prennent la forme d'un modèle DOM (Document Object Model) XML, accessible via la propriété DOM. L'objet XDocument fournit également plusieurs propriétés qui peuvent être utilisées pour obtenir des informations sur le formulaire et son document XML sous-jacent. Il fournit également différentes méthodes pouvant être utilisées dans le formulaire telles que l'impression, l'enregistrement et l'envoi. L'objet XDocument fournit également plusieurs événements qui peuvent être utilisés pour répondre à diverses actions qui se produisent au niveau du formulaire, telles que le chargement d'un formulaire, les changements de vues ou une opération de fusion.

Exemple

Les données XML source d'un formulaire prennent la forme d'un modèle DOM (Document Object Model) XML, accessible via la propriété DOM de l'objet XDocument. L'objet XDocument fournit également plusieurs propriétés qui peuvent être utilisées pour obtenir des informations sur le formulaire et son document XML sous-jacent. Par exemple, le code suivant vérifie si des données du formulaire ont été modifiées à l'aide de la propriété IsDirty :

if (thisXDocument.IsDirty)
{
   thisXDocument.UI.Alert("Form has been changed.");
}
else
{
   thisXDocument.UI.Alert("Form has not been changed.");
}

En plus des informations sur le formulaire et son document XML sous-jacent, l'objet XDocument fournit plusieurs méthodes qui peuvent être utilisées sur le formulaire, telles que l'impression, l'enregistrement et l'envoi. Il fournit également plusieurs événements qui peuvent être utilisés pour répondre à diverses actions qui se produisent au niveau du formulaire, telles que le chargement d'un formulaire, les changements de vues ou une opération de fusion.

Pour un autre exemple illustrant l'utilisation de l'objet XDocument, voir

Procédure : accéder aux données d'application

Voir aussi

Référence

Membres XDocument
Microsoft.Office.Interop.InfoPath, espace de noms

Partager via