XDocument Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Interop.InfoPath.SemiTrust

Ensamblado:

Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Representa el documento XML subyacente de un formulario.

public interface class XDocument : Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocument2

[System.Runtime.InteropServices.Guid("096cd6a8-0786-11d1-95fa-0080c78ee3bb")]
public interface XDocument : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocument2

type XDocument = interface
    interface _XDocument2
    interface _XDocument

Public Interface XDocument
Implements _XDocument2

Atributos

GuidAttribute

Implementaciones

_XDocument2

Ejemplos

Los datos XML de origen de un formulario toman la forma de un modelo de objetos de documento XML (DOM), al que se accede a través de la DOM propiedad 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 cambiado mediante la IsDirty propiedad :

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: Acceder a los datos de la aplicación (modelo de objetos de InfoPath 2003).

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. Para obtener información sobre la interfaz COM, incluido un vínculo a las descripciones de sus miembros, consulte_XDocument2 .

Usar los miembros de la interfaz de _XDocument2 proporciona compatibilidad con InfoPath 2003. Para usar nuevos miembros que se agregaron al modelo de objetos XDocument en Microsoft InfoPath 2010 como la Permission propiedad , debe convertir el objeto XDocument al _XDocument3 tipo . Para obtener más información, vea Cómo: Usar miembros del modelo de objetos 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 se puede acceder al objeto XDocument mediante la colección, en la XDocumentsCollection mayoría de los casos tendrá acceso a él desde la variable thisXDocument que se crea una instancia en el método _Startup de un proyecto de código administrado sin pasar por la colección.

Los datos XML de origen de un formulario toman la forma de un modelo de objetos de documento XML (DOM), al que se accede a través de la DOM propiedad . 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.

XDocumentsCollection	Se obtiene acceso desde Application. Proporciona Item[Object] para acceder a los objetos XDocument que contiene.
DataDOMEventObject	Proporciona XDocument para acceder a los datos XML de origen durante un cambio de XML DOM.
DocActionEventObject	Proporciona XDocument para acceder a los datos XML de origen durante un clic de botón en el área de formulario.
DocEventObject	Proporciona XDocument para acceder a los datos XML de origen durante una vista de modificador o una operación de combinación de formularios.
DocReturnEventObject	Proporciona XDocument acceso al XML de origen durante la carga o el envío de un formulario.
VersionUpgradeEventObject	Proporciona XDocument acceso al XML de origen durante la operación de actualización de la versión.
WindowObject	Proporciona XDocument acceso al objeto XDocument asociado a la ventana.

Propiedades

DataAdapters	Obtiene una referencia a la DataAdaptersCollection colección asociada a un formulario. (Heredado de _XDocument2)
DataObjects	Obtiene una referencia a la DataObjectsCollection colección asociada a un formulario. (Heredado de _XDocument2)
DOM	Obtiene una referencia al documento XML subyacente de un formulario de un modelo de objetos de documento (DOM) XML. (Heredado de _XDocument2)
Errors	Obtiene una referencia a que ErrorsCollection está asociada a un formulario. (Heredado de _XDocument2)
Extension	Obtiene una referencia al objeto de secuencias de comando global, que expone las funciones y variables globales contenidas en el archivo de código de formulario principal de un formulario. (Heredado de _XDocument2)
IsDirty	Obtiene un valor que indica si los datos de un formulario han sido modificados desde la última vez que se guardó. (Heredado de _XDocument2)
IsDOMReadOnly	Obtiene un valor que indica si los datos del documento XML subyacente de un formulario tienen el estado de sólo lectura. (Heredado de _XDocument2)
IsNew	Obtiene un valor que indica si se ha guardado un formulario que se acaba de crear. (Heredado de _XDocument2)
IsReadOnly	Obtiene un valor que indica si un formulario está en modo de sólo lectura. (Heredado de _XDocument2)
IsRecovered	Obtiene un valor que indica si un formulario se guardó la última vez mediante una operación de guardado de Autorrecuperación. (Heredado de _XDocument2)
IsSigned	Obtiene un valor que indica si un formulario se ha firmado digitalmente mediante firmas digitales. (Heredado de _XDocument2)
Language	Obtiene o establece el código del idioma predeterminado de un formulario. (Heredado de _XDocument2)
QueryAdapter	Obtiene una referencia al objeto de adaptador de datos asociado a un formulario. (Heredado de _XDocument2)
Role	Obtiene o establece el rol actual del usuario. (Heredado de _XDocument2)
SignedDataBlocks	Obtiene una referencia a la SignedDataBlocksCollection colección asociada a un XDocument objeto . (Heredado de _XDocument2)
Solution	Obtiene una referencia al SolutionObject objeto asociado a un formulario. (Heredado de _XDocument2)
UI	Devuelve una referencia al UIObject objeto . (Heredado de _XDocument2)
URI	Obtiene el identificador uniforme de recursos (URI) de un formulario. (Heredado de _XDocument2)
Util	Obtiene una referencia al UtilObject objeto . (Heredado de _XDocument2)
View	Obtiene una referencia al ViewObject asociado a un formulario. (Heredado de _XDocument2)
ViewInfos	Obtiene una referencia a la ViewInfosCollection colección asociada a un formulario. (Heredado de _XDocument2)

Métodos

CreateDOM()	Crea una nueva instancia del Modelo de objetos de documento (DOM) XML en memoria. (Heredado de _XDocument2)
GetDataVariable(Int32)	Obtiene el valor de la variable especificada, que es una variable predefinida guardada como atributo de instrucción de procesamiento en el documento XML subyacente del formulario. (Heredado de _XDocument2)
GetDOM(String)	Obtiene una referencia al modelo de objetos de documento XML (DOM) del objeto especificado DataSourceObject asociado al XDocument objeto . (Heredado de _XDocument2)
GetNamedNodeProperty(Object, String, String)	Obtiene el valor de una propiedad con nombre para el nodo XML especificado, que debe ser un nodo nonattribute en el origen de datos principal. (Heredado de _XDocument2)
ImportDOM(IXMLDOMDocument)	Importa los datos XML especificados en el formulario actual. (Heredado de _XDocument2)
ImportFile(String)	Importa el formulario especificado en el formulario actual. (Heredado de _XDocument2)
PrintOut()	Imprime el contenido del formulario tal y como está presentado en la ventana correspondiente a la vista activa del formulario. (Heredado de _XDocument2)
Query()	Recupera datos del objeto de adaptador de datos asociado del formulario y los guarda en el Modelo de objetos de documento (DOM) XML subyacente. (Heredado de _XDocument2)
Save()	Guarda el formulario en la dirección URL a la que esté asociado actualmente. (Heredado de _XDocument2)
SaveAs(String)	Guarda el formulario en la dirección URL especificada. (Heredado de _XDocument2)
SetDataVariable(Int32, String)	Establece el valor de una variable predefinida guardada como un atributo de instrucción de procesamiento en el documento XML subyacente del documento. (Heredado de _XDocument2)
SetDirty(Boolean)	Establece la IsDirty propiedad del XDocument objeto , que indica si los datos de un formulario se han modificado desde la última vez que se guardaron. (Heredado de _XDocument2)
SetNamedNodeProperty(IXMLDOMNode, String, String)	Establece el valor de una propiedad con nombre para el nodo XML suministrado, que debe ser un nodo nonattribute en el origen de datos principal. (Heredado de _XDocument2)
Submit()	Ejecuta la operación de envío predefinida en un formulario. (Heredado de _XDocument2)