Clase SharepointListQueryConnection
NOTA: esta API está ahora obsoleta.
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.SharepointListQueryConnection
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
<ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")> _
Public MustInherit Class SharepointListQueryConnection _
Inherits DataConnection
'Uso
Dim instance As SharepointListQueryConnection
[ObsoleteAttribute("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")]
public abstract class SharepointListQueryConnection : DataConnection
Comentarios
Importante
La clase SharepointListQueryConnection y sus miembros han dejado de usarse en Microsoft InfoPath. El código escrito con los miembros de esta clase es compatible únicamente con una conexión de datos a una 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 o con una conexión de datos convertida con el botón Convertir a InfoPath 2003/2007 en el cuadro de diálogo Conexiones de datos. Para escribir código que funcione con una conexión de datos a una biblioteca de documentos de SharePoint creada en una plantilla de formulario InfoPath, use los miembros de la clase SharePointListRWQueryConnection. Además, si convierte una conexión de datos a una biblioteca de documentos de SharePoint con el botón Convertir a versión actual en el cuadro de diálogo Conexiones de datos, debe volver a escribir cualquier código escrito con los miembros de la clase SharepointListQueryConnection para usar los miembros de la clase SharePointListRWQueryConnection en su lugar.
El objeto SharePointListQueryConnection representa una conexión de datos secundaria creada en InfoPath con el Asistente para la conexión de datos que especifica toda la información necesaria para recuperar datos de una lista o de una biblioteca de documentos de SharePoint.
La clase SharePointListQueryConnection proporciona propiedades que se pueden usar para obtener el nombre de la conexión de datos y la dirección URL de la lista o biblioteca de documentos del sitio de Windows SharePoint Services del que la conexión recupera los datos.
Se puede tener acceso al objeto SharePointListQueryConnection asociado a la conexión de datos mediante la propiedad DataConnections de la clase XmlForm para devolver la conexión de la colección DataConnectionCollection de la plantilla de formulario.
El método Execute predeterminado heredado de la clase base DataConnection realiza una operación de consulta o envío con los valores que se definieron declarativamente en el modo de diseño de plantillas de formulario de InfoPath. Además, la clase SharePointListQueryConnection proporciona el método SharepointListQueryConnection.Execute, que permite especificar otra ubicación para insertar los datos devueltos.
La clase SharePointListQueryConnection corresponde a la interfaz SharePointListAdapterObject del modelo de objetos de Microsoft Office InfoPath 2003.
Ejemplos
En el ejemplo siguiente, se establece una referencia al objeto SharePointListQueryConnection que representa la conexión denominada "Contacts", que establece la conexión con una lista de información de contacto de SharePoint; para ello, se pasa el nombre a la propiedad Item de la clase DataConnectionCollection y, a continuación, se convierte el objeto devuelto en el tipo SharePointListQueryConnection.
[C#]
SharePointListQueryConnection spConnection = (SharePointListQueryConnection)this.DataConnections["Contacts"];
Dim spConnection As SharePointListQueryConnection = _
DirectCast(Me.DataConnections("Contacts"), _
SharePointListQueryConnection)
Una vez que se ha establecido la referencia, se pueden usar las propiedades y métodos del objeto SharePointListQueryConnection. En el ejemplo 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.