XmlForm.QueryDataConnection (Propiedad)

Obtiene una referencia al objeto DataConnection que representa la conexión de datos asociada al formulario.

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

Sintaxis

Public MustOverride ReadOnly Property QueryDataConnection As DataConnection

Dim instance As XmlForm
Dim value As DataConnection

value = instance.QueryDataConnection

public abstract DataConnection QueryDataConnection { get; }

Valor de propiedad

Objeto DataConnection que representa la conexión de datos asociada al formulario.

Comentarios

Los objetos DataConnection proporcionan distintas propiedades y métodos que recuperan y envían datos a los orígenes de datos externos; el adaptador de datos asociado a un formulario depende del tipo de origen de datos utilizado al crear inicialmente dicho formulario.

La propiedad QueryDataConnection permite tener acceso al origen de datos principal de un formulario de InfoPath. Para tener acceso a los objetos del adaptador de datos para los orígenes de datos secundarios de un formulario, utilice la propiedad DataSources.

Nota:
La propiedad QueryDataConnection proporciona una funcionalidad parecida a la de la propiedad QueryAdapter del objeto XDocument del modelo de objetos COM/Scripting, y a la de la propiedad QueryAdapter de la interfaz _XDocument2 del modelo de objetos de código administrado compatible con InfoPath 2003.

Sólo pueden tener acceso a este miembro los formularios que se ejecuten en el mismo dominio que el formulario abierto actualmente o los formularios a los que se hayan concedido permisos entre dominios.

Se puede tener acceso a este tipo o miembro desde un código ejecutado en formularios abiertos en Microsoft Office InfoPath 2007 o en un explorador Web.

Ejemplo

En el siguiente ejemplo, la propiedad QueryDataConnection de la clase XmlForm se usa para establecer una referencia a los objetos ADOQueryConnection y ADOSubmitConnection asociados a la plantilla de formulario. A continuación, la propiedad Command del objeto ADOQueryConnection y la propiedad Command de los objetos ADOQueryConnection se usan para mostrar el texto del comando SQL de cada tipo de conexión en un cuadro de mensaje.

ADOQueryConnection queryConnection;
ADOSubmitConnection submitConnection;

queryConnection = (ADOQueryConnection) this.QueryConnection;
MessageBox.Show("Query SQL command text: " + queryConnection.Command);

submitConnection = (ADOSubmitConnection) this.QueryConnection;
MessageBox.Show("Submit SQL command text: " + querySubmit.Command);
Dim queryConnection As ADOQueryConnection
Dim submitConnectionmAs ADOSubmitConnection

queryConnection = DirectCast(ADOQueryConnection, Me.QueryConnection)
MessageBox.Show("Query SQL command text: " & queryConnection.Command)

submitConnection = DirectCast(ADOSubmitConnection, Me.QueryConnection)
MessageBox.Show("Submit SQL command text: " & querySubmit.Command)

Vea también

Referencia

XmlForm (Clase)
XmlForm (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)