Interfaz XDocument
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
'Declaración
<GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")> _
Public Interface XDocument _
Inherits _XDocument2, _XDocument
'Uso
Dim instance As XDocument
[GuidAttribute("096cd6a8-0786-11d1-95fa-0080c78ee3bb")]
public interface XDocument : _XDocument2,
_XDocument
Comentarios
Este tipo es un contenedor para una coclase que requiere el código administrado para la interoperabilidad con COM. Use este tipo para acceder a los miembros de la interfaz COM que implementa esta coclase. Encontrará información sobre la interfaz COM, así como vínculos a las descripciones de sus miembros, en_XDocument2.
Los miembros de la interfaz de _XDocument2 ofrecen compatibilidad con InfoPath 2003. Para utilizar los nuevos miembros que se han agregado al modelo de objetos XDocument en Microsoft InfoPath 2010 como la propiedad _XDocument3.Permission , debe convertir el objeto XDocument para el tipo de _XDocument3 . Para obtener más información, consulte How to: Use Object Model Members That Are Not Compatible with 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.
Tener acceso al objeto XDocument
Se puede tener acceso al objeto XDocument en varios lugares del modelo de objetos de InfoPath. En la tabla siguiente se resumen las ubicaciones donde está disponible el objeto XDocument.
Nombre |
Descripción |
|---|---|
Acceso desde Application. Proporciona Item para tener acceso a los objetos XDocument que contiene. |
|
Proporciona XDocument para tener acceso a los datos XML de origen durante un cambio de XML DOM. |
|
Proporciona XDocument para tener acceso a los datos XML de origen cuando se hace clic en un botón del área del formulario. |
|
Proporciona XDocument para tener acceso a los datos XML de origen durante un cambio de vista o una operación de combinación de formularios. |
|
Proporciona XDocument para tener acceso al código XML de origen durante la carga o el envío de un formulario. |
|
Proporciona XDocument para tener acceso al código XML de origen durante una versión de actualización de versión. |
|
Proporciona XDocument para tener acceso al objeto XDocument asociado a la ventana. |
Ejemplos
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
How to: Access Application Data (InfoPath 2003 Object Model).
Vea también
Referencia
Espacio de nombres Microsoft.Office.Interop.InfoPath.SemiTrust