XDocument - Interface
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
'Déclaration
<GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface XDocument _
Inherits _XDocument2, _XDocument
'Utilisation
Dim instance As XDocument
[GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")]
public interface XDocument : _XDocument2,
_XDocument
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_XDocument2.
À l'aide des membres de l'interface _XDocument2 offre une compatibilité avec InfoPath 2003. Pour utiliser les nouveaux membres qui ont été ajoutés au modèle d'objet XDocument dans Microsoft InfoPath 2010 telles que la propriété _XDocument3.Permission , vous devez effectuer un cast de l'objet XDocument pour le type de _XDocument3 . Pour plus d'informations, voir How to: Use Object Model Members That Are Not Compatible with 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.
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 via Application. Fournit Item permettant d'accéder aux objets XDocument qu'il contient. |
|
Fournit XDocument permettant d'accéder aux données XML source pendant un changement de modèle DOM XML. |
|
Fournit XDocument permettant d'accéder aux données XML source pendant un clic sur un bouton dans la zone du formulaire. |
|
Fournit XDocument permettant d'accéder aux données XML source pendant une opération de changement de vue ou de fusion de formulaires. |
|
Fournit XDocument permettant d'accéder aux données XML source pendant le chargement ou l'envoi d'un formulaire. |
|
Fournit XDocument permettant d'accéder aux données XML source pendant une opération de mise à niveau de version. |
|
Fournit XDocument permettant d'accéder à l'objet XDocument associé à la fenêtre. |
Exemples
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
How to: Access Application Data (InfoPath 2003 Object Model).
Voir aussi
Référence
Microsoft.Office.Interop.InfoPath.SemiTrust - Espace de noms