XDocument, interface

Article
04/27/2010

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

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

Syntaxe

<CLSCompliantAttribute(False)> _
<CoClassAttribute(GetType(XDocumentWrapper))> _
<GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface XDocument
    Inherits _XDocument2, _XDocument

Dim instance As XDocument

[CLSCompliantAttribute(false)] 
[CoClassAttribute(typeof(XDocumentWrapper))] 
[GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")] 
public interface XDocument : _XDocument2, _XDocument

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 _XDocument2.

L'utilisation des membres de l'interface _XDocument2 permet de garantir la compatibilité avec InfoPath 2003. Pour utiliser les nouveaux membres ajoutés au modèle objet XDocument dans Microsoft Office InfoPath 2007 (par exemple la propriété _XDocument3.Permission), vous devez envoyer l'objet XDocument au type _XDocument3. Pour plus d'informations, consultez Utilisation des membres Microsoft.Office.Interop.InfoPath.SemiTrust qui ne sont pas compatibles avec InfoPath 2003.

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 d'accès aux données d'application en utilisant le modèle objet InfoPath 2003.

Voir aussi

Référence

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

Partager via