Clase SharePointListRWQueryConnection
Representa una conexión de datos para recuperar datos de una lista o una biblioteca de documentos de SharePoint.
Jerarquía de la herencia
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.SharePointListRWQueryConnection
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustInherit Class SharePointListRWQueryConnection _
Inherits DataConnection
'Uso
Dim instance As SharePointListRWQueryConnection
public abstract class SharePointListRWQueryConnection : DataConnection
Comentarios
La clase SharePointListRWQueryConnection representa una conexión de datos secundaria creada en InfoPath que especifica toda la información necesaria para recuperar datos de una lista o biblioteca de documentos de SharePoint. Para crear una plantilla de formulario que contenga una conexión de datos secundaria a una lista o biblioteca de documentos de SharePoint, utilice el comando Conexiones de datos de la pestaña Datos.
Nota
El código escrito con los miembros de la clase SharePointListRWQueryConnection no es compatible con una conexión de datos a una lista o biblioteca de documentos de SharePoint creada en InfoPath 2003 o InfoPath 2007, con una conexión de datos en una nueva plantilla de formulario creada en InfoPath con una de las plantillas de formulario de InfoPath 2007 ni con una conexión de datos convertida con el botón Convertir a versión anterior del cuadro de diálogo Conexiones de datos. Si no es necesario mantener la compatibilidad con una versión anterior de InfoPath y desea escribir código con miembros de la clase SharePointListRWQueryConnection, convierta la conexión de datos con el botón Convertir a versión actual en el cuadro de diálogo Conexiones de datos.
Nota
Cree una nueva plantilla de formulario con la plantilla Lista de SharePoint para crear una conexión de datos primaria (principal) a una lista de SharePoint. Sin embargo, no es posible escribir código de formulario detrás de dicho formulario, ya que solo se admite la lógica declarativa, como las reglas, en una plantilla de formulario creada con la plantilla Lista de SharePoint. Por este motivo no se puede utilizar la clase SharePointListRWQueryConnection y sus miembros para trabajar con una conexión de datos primaria a una lista de SharePoint.
La clase SharePointListRWQueryConnection proporciona propiedades que pueden utilizarse para obtener el nombre de la conexión de datos y la dirección URL de la lista o biblioteca de documentos en el sitio de SharePoint Foundation o Microsoft SharePoint Server desde el cual la conexión recupera los datos.
Es posible obtener acceso al objeto SharePointListRWQueryConnection asociado con la conexión de datos por medio del uso de la propiedad DataConnections de la clase XmlForm para devolver la conexión desde la DataConnectionCollection de la plantilla de formularios.
El método predeterminado Execute, heredado desde la clase base DataConnection, realiza una consulta o una operación de envío con los valores que se definieron declarativamente en la plantilla de formulario de InfoPath en tiempo de diseño. Además, la clase SharePointListRWQueryConnection proporciona el método Execute(XPathNavigator), el cual permite especificar una ubicación diferente para insertar los datos devueltos.
Ejemplos
En el siguiente ejemplo de código, se tiene acceso a una conexión de datos llamada "Contacts", que se conecta a una lista de información de contacto en un sitio de SharePoint, por medio del siguiente proceso de dos pasos. El nombre "Contacts" se pasa a la propiedad Item de la clase DataConnectionCollection para recuperar un objeto que representa la conexión de datos. Posteriormente, el objeto devuelto desde la colección se convierte al tipo SharePointListRWQueryConnection.
SharePointListRWQueryConnection spConnection = (SharePointListRWQueryConnection)this.DataConnections["Contacts"];
Dim spConnection As SharePointListRWQueryConnection = _
DirectCast(Me.DataConnections("Contacts"), _
SharePointListRWQueryConnection)
Tras determinar la referencia a la conexión de datos, puede usar las propiedades o métodos del objeto SharePointListRWQueryConnection. En el ejemplo de código siguiente se establece una variable de cadena en el valor devuelto por la propiedad Name heredada de la clase base DataConnection.
string spName = spConnection.Name;
Dim spName As String = spConnection.Name
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.