Compartir a través de

XDocument (Interfaz)

  • Artículo

Representa el documento XML subyacente de un formulario de Microsoft Office InfoPath.

Espacio de nombres: Microsoft.Office.Interop.InfoPath
Ensamblado: Microsoft.Office.Interop.InfoPath (en microsoft.office.interop.infopath.dll)

Sintaxis

<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

Comentarios

Este tipo es un contenedor para una coclase que necesita el código administrado para su interoperabilidad COM. Use este tipo para obtener acceso a los miembros de la interfaz COM implementada por esta coclase. Para obtener información sobre la interfaz COM, así como un vínculo a descripciones de sus miembros, vea _XDocument3.

El objeto XDocument es un objeto clave del modelo de objetos de InfoPath que proporciona propiedades, métodos y eventos que se pueden usar para interactuar mediante programación con los datos XML de origen de un formulario, así como para manipularlos.

Aunque es posible tener acceso al objeto XDocument mediante la colección XDocumentsCollection, en la mayoría de los casos se tendrá acceso a ella desde la variable thisXDocument que se inicializa en el método _Startup de un proyecto con código administrado sin ir a través de la colección.

Los datos XML de origen de un formulario toman el formulario de un modelo de objetos de documento (DOM) XML, al que se tiene acceso a través de la propiedad DOM. El objeto XDocument también proporciona varias propiedades que se pueden usar para obtener información sobre el formulario y su documento XML subyacente. Además, proporciona varios métodos que se pueden usar en el propio formulario, como imprimir, guardar y enviar. Además, el objeto XDocument proporciona diversos eventos que se pueden usar para responder a distintas acciones que tienen lugar en el formulario, como cargar un formulario, conmutar vistas o realizar una operación de combinación.

Ejemplo

Los datos XML de origen de un formulario toman la forma de un modelo de objetos de documento (DOM) XML, al que se tiene acceso a través de la propiedad DOM del objeto XDocument. El objeto XDocument también proporciona varias propiedades que se pueden usar para obtener información sobre el formulario y el documento XML subyacente. Por ejemplo, el código siguiente comprueba si los datos del formulario se han modificado mediante la propiedad IsDirty:

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

Además de la información sobre el formulario y su documento XML subyacente, el objeto XDocument proporciona varios métodos que se pueden usar en el propio formulario, como imprimir, guardar, y enviar. También proporciona diversos eventos que se pueden usar para responder a distintas acciones que tienen lugar en el formulario, como cargar un formulario, conmutar vista o realizar una operación de combinación.

Para ver otro ejemplo que muestre cómo se trabaja con el objeto XDocument, vea

Cómo: Obtener acceso a los datos de aplicaciones.

Vea también

Referencia

XDocument (Miembros)
Microsoft.Office.Interop.InfoPath (Espacio de nombres)