Interfaccia XDocument
Rappresenta il documento XML sottostante di un modulo.
Spazio dei nomi: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in Microsoft.Office.Interop.InfoPath.SemiTrust.dll)
Sintassi
'Dichiarazione
<GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface XDocument _
Inherits _XDocument2, _XDocument
'Utilizzo
Dim instance As XDocument
[GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")]
public interface XDocument : _XDocument2,
_XDocument
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_XDocument2.
L'utilizzo dei membri dell'interfaccia _XDocument2 garantisce la compatibilità con InfoPath 2003. Per utilizzare nuovi membri aggiunti al modello a oggetti XDocument in Microsoft InfoPath 2010, ad esempio la proprietà _XDocument3.Permission, è necessario eseguire il cast dell'oggetto XDocument al tipo _XDocument3. Per ulteriori informazioni, vedere Procedura: Utilizzare membri di Microsoft.Office.Interop.InfoPath.SemiTrust non compatibili con InfoPath 2003.
L'oggetto XDocument è un oggetto fondamentale del modello a 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, nella maggior parte dei casi per accedervi si utilizza la variabile thisXDocument che viene inizializzata nel metodo _Startup di un progetto con codice gestito, senza ricorrere all'insieme.
I dati XML di origine di un modulo prendono la forma di documento DOM (Document Object Model) XML, a cui si accede 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.
Accesso all'oggetto XDocument
È possibile accedere all'oggetto XDocument da diverse posizioni nell'ambito del modello a oggetti di InfoPath. Nella tabella seguente sono riepilogate le posizioni in cui è disponibile l'oggetto XDocument.
Nome |
Descrizione |
|---|---|
Vi si accede da Application. Implementa Item per l'accesso agli oggetti XDocument in esso contenuti. |
|
Implementa XDocument per l'accesso ai dati XML di origine durante un cambiamento di modello DOM XML. |
|
Implementa XDocument per l'accesso ai dati XML di origine quando viene scelto un pulsante nell'area del modulo. |
|
Implementa XDocument per l'accesso ai dati XML di origine durante un cambiamento di visualizzazione o un'operazione di unione di un modulo. |
|
Implementa XDocument per l'accesso ai dati XML di origine durante il caricamento o l'invio di un modulo. |
|
Implementa XDocument per l'accesso ai dati XML di origine durante l'operazione di aggiornamento della versione. |
|
Implementa XDocument per l'accesso all'oggetto XDocument associato alla finestra. |
Esempi
I dati XML di origine prendono la forma di un documento DOM (Document Object Model) XML, a cui è possibile accedere 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 tramite il modello a oggetti di InfoPath 2003.