XDocument-Schnittstelle

Artikel
04/27/2010

Stellt das zugrunde liegende XML-Dokument eines Formulars dar.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

<CLSCompliantAttribute(False)> _
<CoClassAttribute(GetType(XDocumentWrapper))> _
<GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface XDocument
    Inherits _XDocument2, _XDocument

Dim instance As XDocument

[CLSCompliantAttribute(false)] 
[CoClassAttribute(typeof(XDocumentWrapper))] 
[GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")] 
public interface XDocument : _XDocument2, _XDocument

Hinweise

Dies ist ein Wrappertyp für eine Coklasse, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie diesen Typ zum Zugreifen auf die Member der COM-Schnittstelle, die von der Coklasse implementiert wurden. Informationen zur COM-Schnittstelle, einschließlich eines Links zu den Memberbeschreibungen, finden Sie unter _XDocument2.

Mithilfe der Member der _XDocument2-Schnittstelle wird Kompatibilität mit InfoPath 2003 bereitgestellt. Um neue Member zu verwenden, die dem XDocument-Objektmodell in Microsoft Office InfoPath 2007 hinzugefügt wurden (beispielsweise die _XDocument3.Permission-Eigenschaft), müssen Sie das XDocument-Objekt in den _XDocument3-Typ umwandeln. Weitere Informationen hierzu finden Sie unter Vorgehensweise: Verwenden von nicht mit InfoPath 2003 kompatiblen Microsoft.Office.Interop.InfoPath.SemiTrust-Membern.

Beim XDocument-Objekt handelt es sich um ein Schlüsselobjekt im InfoPath-Objektmodell. Es stellt Eigenschaften, Methoden und Ereignisse bereit, die verwendet werden können, um mit den XML-Quelldaten eines Formulars programmgesteuert zu interagieren und sie zu bearbeiten.

Während der Zugriff auf das XDocument-Objekt über die XDocumentsCollection-Auflistung erfolgen kann, erfolgt er in den meisten Fällen über die thisXDocument-Variable, die in der _Startup-Methode eines Projekts mit verwaltetem Code ohne Durchlaufen der Auflistung instanziiert wird.

Die XML-Quelldaten eines Formulars nehmen die Form eines XML-DOM (Document Object Model) an, auf das über die DOM-Eigenschaft zugegriffen werden kann. Das XDocument-Objekt stellt darüber hinaus mehrere Eigenschaften bereit, mit deren Hilfe Informationen zum Formular und dem zugrunde liegenden XML-Dokument abgerufen werden können. Es bietet zudem verschiedene Methoden, die auf das Formular angewendet werden können, wie z. B. zum Drucken, Speichern und Senden. Das XDocument-Objekt stellt weiterhin mehrere Ereignisse bereit, die verwendet werden können, um auf verschiedene, auf Formularebene stattfindende Aktionen zu reagieren, z. B. das Laden eines Formulars, das Wechseln einer Ansicht oder ein Zusammenführungsvorgang.

Beispiel

Die XML-Quelldaten eines Formulars nehmen die Form eines XML-DOM (Document Object Model) an, auf das über die DOM-Eigenschaft des XDocument-Objekts zugegriffen werden kann. Das XDocument-Objekt stellt darüber hinaus mehrere Eigenschaften bereit, mit deren Hilfe Informationen zum Formular und dem zugrunde liegenden XML-Dokument abgerufen werden können. Der folgende Code prüft beispielsweise mithilfe der IsDirty-Eigenschaft, ob Daten im Formular geändert wurden:

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

Zusätzlich zu den Informationen zum Formular und zu dem ihm zugrunde liegenden XML-Dokument stellt das XDocument-Objekt mehrere Methoden bereit, die für Formularvorgänge verwendet werden können, z. B. zum Drucken, Speichern und Senden. Es stellt weiterhin mehrere Ereignisse bereit, die verwendet werden können, um auf verschiedene, auf Formularebene stattfindende Aktionen zu reagieren, z. B. das Laden eines Formulars, das Wechseln einer Ansicht oder ein Zusammenführungsvorgang.

Ein weiteres Beispiel, das die Arbeit mit dem XDocument-Objekt veranschaulicht, finden Sie unter

Vorgehensweise: Zugreifen auf Anwendungsdaten mit dem InfoPath 2003-Objektmodell.

Siehe auch

Referenz

XDocument-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Freigeben über