XDocument - Interface
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
'Déclaration
<GuidAttribute("096CD6A8-0786-11D1-95FA-0080C78EE3BB")> _
Public Interface XDocument _
Inherits _XDocument2, _XDocumentEventSink2_Event
'Utilisation
Dim instance As XDocument
[GuidAttribute("096CD6A8-0786-11D1-95FA-0080C78EE3BB")]
public interface XDocument : _XDocument2,
_XDocumentEventSink2_Event
Remarques
Ce type est le wrapper d’une coclasse requise par le code managé pour l’interopérabilité COM. Utilisez ce type pour accéder aux membres de l’interface COM implémentée par cette coclasse. Pour plus d’informations sur l’interface COM et pour accéder à un lien vers les 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.
Tandis que l'objet XDocument est accessible à l'aide de la collection XDocumentsCollection , dans la plupart des cas, vous y accédez à partir de la variable thisXDocument qui est instanciée dans la méthode _Startup d'un projet de code managé sans passer par la collection.
La source de données XML d'un formulaire prennent la forme d'un code XML modèle DOM (Document Object), qui est accessible via la propriété DOM . L'objet XDocument fournit également un nombre de propriétés qui peut servir à obtenir des informations sur le formulaire et son document XML sous-jacent. Il fournit également plusieurs méthodes qui peuvent être utilisés sur le formulaire, par exemple l'impression, l'enregistrement et l'envoi. L'objet XDocument fournit également un nombre d'événements qui peut être utilisé 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.
Accès à l'objet XDocument.
L'objet XDocument est accessible dans différents emplacements du modèle objet d'InfoPath. Le tableau suivant récapitule les emplacements où l'objet XDocument est disponible.
Name |
Description |
|---|---|
Accessible à partir de Application. Fournit des Item permettant d'accéder aux objets XDocument qu'elle contient. |
|
Fournit des XDocument permettant d'accéder aux données XML source pendant un changement de modèle DOM XML. |
|
Fournit des XDocument permettant d'accéder aux données XML source pendant un clic de bouton dans la zone de formulaire. |
|
Fournit des XDocument permettant d'accéder aux données XML source pendant une opération de fusion de formulaire ou d'affichage de commutateur. |
|
Fournit des XDocument pour accéder aux données XML source pendant le chargement ou l'envoi d'un formulaire. |
|
Fournit des XDocument pour accéder aux données XML source pendant l'opération de mise à niveau de version. |
|
Fournit des XDocument pour accéder à l'objet XDocument associé à la fenêtre. |
Exemples
La source de données XML d'un formulaire prennent la forme d'un code XML modèle DOM (Document Object), qui est accessible via la propriété DOM de l'objet XDocument . L'objet XDocument fournit également un nombre de propriétés qui peut servir à obtenir des informations sur le formulaire et son document XML sous-jacent. Par exemple, le code suivant vérifie si les 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
How to: Access Application Data Using the InfoPath 2003 Object Model.