Partager via


XDocument Interface

Définition

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

public interface class XDocument : Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocument2
[System.Runtime.InteropServices.Guid("096cd6a8-0786-11d1-95fa-0080c78ee3bb")]
public interface XDocument : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocument2
type XDocument = interface
    interface _XDocument2
    interface _XDocument
Public Interface XDocument
Implements _XDocument2
Attributs
Implémente

Exemples

Les données XML sources d’un formulaire prennent la forme d’un modèle DOM (Document Object Model) XML, accessible via la DOM propriété 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 les données du formulaire ont été modifiées à l’aide de la IsDirty propriété :

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

Guide pratique pour accéder aux données d’application (Modèle objet InfoPath 2003).

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, y compris un lien vers les descriptions de ses membres, consultez_XDocument2 .

L'utilisation des membres de l'interface _XDocument2 permet de garantir la compatibilité avec InfoPath 2003. Pour utiliser de nouveaux membres ajoutés au modèle objet XDocument dans Microsoft InfoPath 2010 comme la Permission propriété , vous devez convertir l’objet XDocument en _XDocument3 type . Pour plus d'informations, consultez Procédure : utiliser les membres du modèle objet 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, dans la XDocumentsCollection plupart des cas, vous y accéderez à partir de la variable thisXDocument instanciée dans la méthode _Startup d’un projet de code managé sans passer par la collection.

Les données XML sources d’un formulaire prennent la forme d’un modèle DOM (Document Object Model) XML accessible via la DOM propriété . 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.

XDocumentsCollection Accessible à partir de Application. Fournit Item[Object] l’accès aux objets XDocument qu’il contient.
DataDOMEventObject Permet XDocument d’accéder aux données XML sources lors d’une modification DU DOM XML.
DocActionEventObject Permet XDocument d’accéder aux données XML sources lors d’un clic sur un bouton dans la zone de formulaire.
DocEventObject Permet d’accéder XDocument aux données XML sources lors d’une vue switch ou d’une opération de fusion de formulaires.
DocReturnEventObject Permet XDocument d’accéder au code XML source lors du chargement ou de l’envoi d’un formulaire.
VersionUpgradeEventObject Permet XDocument d’accéder au code XML source pendant l’opération de mise à niveau de version.
WindowObject Permet XDocument d’accéder à l’objet XDocument associé à la fenêtre.

Propriétés

DataAdapters

Obtient une référence à la DataAdaptersCollection collection associée à un formulaire.

(Hérité de _XDocument2)
DataObjects

Obtient une référence à la DataObjectsCollection collection associée à un formulaire.

(Hérité de _XDocument2)
DOM

Obtient une référence au document XML sous-jacent d'un formulaire sous la forme d'un modèle DOM (Document Object Model) XML.

(Hérité de _XDocument2)
Errors

Obtient une référence au ErrorsCollection associé à un formulaire.

(Hérité de _XDocument2)
Extension

Obtient une référence à l'objet de script global, qui expose les fonctions et variables globales contenues dans le fichier de code de formulaire principal d'un formulaire.

(Hérité de _XDocument2)
IsDirty

Obtient une valeur qui indique si les données d'un formulaire ont été modifiées depuis leur dernier enregistrement.

(Hérité de _XDocument2)
IsDOMReadOnly

Obtient une valeur qui indique si les données du document XML sous-jacent d'un formulaire ont été mises en lecture seule.

(Hérité de _XDocument2)
IsNew

Obtient une valeur qui indique si un formulaire nouvellement créé à été enregistré.

(Hérité de _XDocument2)
IsReadOnly

Obtient une valeur qui indique si un formulaire est en lecture seule.

(Hérité de _XDocument2)
IsRecovered

Obtient une valeur qui indique si un formulaire a été enregistré pour la dernière fois par une opération de récupération automatique.

(Hérité de _XDocument2)
IsSigned

Obtient une valeur qui indique si un formulaire a été signé numériquement à l’aide de signatures numériques.

(Hérité de _XDocument2)
Language

Obtient ou définit le code de langue par défaut du formulaire.

(Hérité de _XDocument2)
QueryAdapter

Obtient une référence à l'objet adaptateur de données associé à un formulaire.

(Hérité de _XDocument2)
Role

Obtient ou définit le rôle actuel de l'utilisateur.

(Hérité de _XDocument2)
SignedDataBlocks

Obtient une référence à la SignedDataBlocksCollection collection associée à un XDocument objet .

(Hérité de _XDocument2)
Solution

Obtient une référence à l’objet SolutionObject associé à un formulaire.

(Hérité de _XDocument2)
UI

Retourne une référence à l’objet UIObject .

(Hérité de _XDocument2)
URI

Obtient l’URI (Uniform Resource Identifier) d’un formulaire.

(Hérité de _XDocument2)
Util

Obtient une référence à l’objet UtilObject .

(Hérité de _XDocument2)
View

Obtient une référence au associé à ViewObject un formulaire.

(Hérité de _XDocument2)
ViewInfos

Obtient une référence à la ViewInfosCollection collection associée à un formulaire.

(Hérité de _XDocument2)

Méthodes

CreateDOM()

Crée une instance du modèle XML DOM (Document Object Model) en mémoire.

(Hérité de _XDocument2)
GetDataVariable(Int32)

Obtient la valeur de la variable spécifiée, qui est une variable prédéfinie stockée en tant qu'attribut d'instruction de traitement dans le document XML sous-jacent du formulaire.

(Hérité de _XDocument2)
GetDOM(String)

Obtient une référence au modèle DOM (Document Object Model) XML de l’objet spécifié DataSourceObject associé à l’objet XDocument .

(Hérité de _XDocument2)
GetNamedNodeProperty(Object, String, String)

Obtient la valeur d'une propriété nommée pour le nœud XML spécifié, lequel doit être un nœud nonattribute dans la source de données principale.

(Hérité de _XDocument2)
ImportDOM(IXMLDOMDocument)

Importe les données XML spécifiées dans le formulaire actif.

(Hérité de _XDocument2)
ImportFile(String)

Importe le formulaire spécifié dans le formulaire actif.

(Hérité de _XDocument2)
PrintOut()

Imprime le contenu d'un formulaire tel qu'il s'affiche dans la fenêtre correspondant à la vue active du formulaire.

(Hérité de _XDocument2)
Query()

Extrait des données de l' objet adaptateur de données associé à un formulaire et stocke ces données dans le modèle DOM (Document Object Model) XML sous-jacent du formulaire.

(Hérité de _XDocument2)
Save()

Enregistre le formulaire dans l’URL (Uniform Resource Locator) qui lui est actuellement associée.

(Hérité de _XDocument2)
SaveAs(String)

Enregistre le formulaire dans l’URL (Uniform Resource Locator) spécifiée.

(Hérité de _XDocument2)
SetDataVariable(Int32, String)

Définit la valeur d'une variable prédéfinie stockée en tant qu'attribut d'instruction de traitement dans le document XML sous-jacent du formulaire.

(Hérité de _XDocument2)
SetDirty(Boolean)

Définit la IsDirty propriété de l’objet XDocument , qui indique si les données d’un formulaire ont été modifiées depuis leur dernier enregistrement.

(Hérité de _XDocument2)
SetNamedNodeProperty(IXMLDOMNode, String, String)

Définit la valeur d'une propriété nommée pour le nœud XML fourni, lequel doit être un nœud nonattribute dans la source de données principale.

(Hérité de _XDocument2)
Submit()

Exécute l'opération d'envoi prédéfinie dans un formulaire.

(Hérité de _XDocument2)

S’applique à