Interfaccia XDocument

Rappresenta il documento XML sottostante di un modulo di Microsoft Office InfoPath.

Spazio dei nomi: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Sintassi

<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

Osservazioni

Questo tipo è un wrapper per una coclasse richiesta dal codice gestito per l'interoperabilità COM. Utilizzare questo tipo per accedere ai membri dell'interfaccia COM implementata dalla coclasse. Per informazioni sull'interfaccia COM e un collegamento alle descrizioni dei relativi membri, vedere _XDocument3.

L'oggetto XDocument è un oggetto fondamentale del modello di oggetti di InfoPath che implementa proprietà, metodi ed eventi utilizzabili per interagire e modificare a livello di programmazione i dati XML di origine di un modulo.

Sebbene sia possibile accedere all'oggetto XDocument utilizzando l'insieme XDocumentsCollection, in genere per accedere all'oggetto viene utilizzata la variabile thisXDocument, inizializzata nel metodo _Startup di un progetto con codice gestito, senza ricorrere all'insieme.

I dati XML di origine di un modulo assumono il formato di documento DOM (Document Object Model) XML, accessibile tramite la proprietà DOM. L'oggetto XDocument implementa inoltre diverse proprietà che possono essere utilizzate per recuperare informazioni sul modulo e sul relativo documento XML sottostante. Implementa inoltre numerosi metodi che possono essere utilizzati nel modulo, ad esempio per la stampa, il salvataggio e l'invio. L'oggetto XDocument implementa inoltre numerosi eventi che consentono di rispondere a varie azioni che si verificano a livello del modulo, come il caricamento di un modulo, il cambiamento di visualizzazione o un'operazione di unione.

Esempio

I dati XML di origine assumono il formato di un documento DOM (Document Object Model) XML, accessibile tramite la proprietà DOM dell'oggetto XDocument. L'oggetto XDocument implementa inoltre diverse proprietà che possono essere utilizzate per recuperare informazioni sul modulo e sul relativo documento XML sottostante. Il codice seguente, ad esempio, verifica se i dati del modulo sono cambiati mediante la proprietà IsDirty:

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

Oltre alle informazioni sul modulo e sul relativo documento XML sottostante, l'oggetto XDocument rende disponibili diversi metodi che possono essere utilizzati nel modulo, per eseguire ad esempio stampe, salvataggi e invii. L'oggetto implementa inoltre numerosi eventi che possono essere utilizzati per rispondere a varie azioni che si verificano a livello del modulo, come il caricamento di un modulo, il cambiamento di visualizzazione o un'operazione di unione.

Per un ulteriore esempio di utilizzo dell'oggetto XDocument, vedere

Procedura: Accedere ai dati delle applicazioni.

Vedere anche

Riferimenti

Membri XDocument
Spazio dei nomi Microsoft.Office.Interop.InfoPath