XDocument (Interfaz)

Representa el documento XML subyacente de un formulario.

 

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

Sintaxis

<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

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 _XDocument2.

Usar los miembros de la interfaz de _XDocument2 proporciona compatibilidad con InfoPath 2003. Para poder usar los miembros nuevos que se agregaron al modelo de objetos de XDocument en Microsoft Office InfoPath 2007, como la propiedad _XDocument3.Permission, debe convertir el objeto XDocument al tipo _XDocument3. Para obtener más información, vea Cómo: Usar los miembros de Microsoft.Office.Interop.InfoPath.SemiTrust que no son compatibles con InfoPath 2003.

El objeto XDocument es un objeto clave del modelo de objetos de InfoPath que proporciona propiedades, métodos y eventos que se pueden utilizar 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 de 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 utilizar para obtener información sobre el formulario y su documento XML subyacente. Además, proporciona varios métodos que se pueden utilizar en el propio formulario, como imprimir, guardar y enviar. El objeto XDocument proporciona así mismo diversos eventos que se pueden utilizar para responder a distintas acciones que tienen lugar en el formulario, como cargar un formulario, cambiar a otra vista 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 utilizar 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 utilizar en el propio formulario, como imprimir, guardar, y enviar. También proporciona diversos eventos que se pueden utilizar para responder a distintas acciones que tienen lugar en el formulario, como cargar un formulario, cambiar a otra 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 con el modelo de objetos de InfoPath 2003.

Vea también

Referencia

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