SharePointListRWQueryConnection Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa una conexión de datos para recuperar datos de una lista o una biblioteca de documentos de SharePoint.
public ref class SharePointListRWQueryConnection abstract : Microsoft::Office::InfoPath::DataConnectionpublic abstract class SharePointListRWQueryConnection : Microsoft.Office.InfoPath.DataConnectiontype SharePointListRWQueryConnection = class
inherit DataConnectionPublic MustInherit Class SharePointListRWQueryConnection
Inherits DataConnection- Herencia
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 Item[String] propiedad de la DataConnectionCollection clase para recuperar un objeto que representa la conexión de datos. A continuación, el objeto devuelto de la colección se convierte al SharePointListRWQueryConnection tipo .
SharePointListRWQueryConnection spConnection = (SharePointListRWQueryConnection)this.DataConnections["Contacts"];
Dim spConnection As SharePointListRWQueryConnection = _
DirectCast(Me.DataConnections("Contacts"), _
SharePointListRWQueryConnection)
Una vez establecida la referencia a la conexión de datos, puede usar las propiedades o métodos del SharePointListRWQueryConnection objeto. En el ejemplo de código siguiente se establece una variable de cadena en el valor devuelto por la Name propiedad heredada de la DataConnection clase base.
string spName = spConnection.Name;
Dim spName As String = spConnection.Name
Comentarios
La SharePointListRWQueryConnection clase 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 SharePointListRWQueryConnection clase 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, o con una conexión de datos convertida con el botón Convertir a versión anterior en el cuadro de diálogo Connections de datos. Si no necesita mantener la compatibilidad con una versión anterior de InfoPath y desea escribir código con miembros de la SharePointListRWQueryConnection clase, convierta la conexión de datos con el botón Convertir a versión actual en el cuadro de diálogo Datos Connections .
Nota: Puede crear una conexión de datos principal (principal) a una lista de SharePoint mediante la creación de una nueva plantilla de formulario con la plantilla 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 puede usar la SharePointListRWQueryConnection clase y sus miembros para trabajar con una conexión de datos principal a una lista de SharePoint.
La SharePointListRWQueryConnection clase 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 en el sitio de SharePoint Foundation o Microsoft SharePoint Server desde el que la conexión recupera datos.
El SharePointListRWQueryConnection objeto asociado a la conexión de datos es accesible mediante la DataConnections propiedad de la XmlForm clase para devolver la conexión de la DataConnectionCollection plantilla de formulario.
El método predeterminado Execute() , heredado de la DataConnection clase base, realiza una operación de consulta o envío con los valores definidos declarativamente en la plantilla de formulario de InfoPath en tiempo de diseño. Además, la SharePointListRWQueryConnection clase proporciona el Execute(XPathNavigator) método , que permite especificar una ubicación diferente para insertar los datos que se devuelven.
Constructores
| SharePointListRWQueryConnection() |
Representa una conexión de datos para recuperar datos de una lista o una biblioteca de documentos de SharePoint. |
Propiedades
| ContentTypeId |
Obtiene o establece el identificador de tipo de contenido de la lista de SharePoint asociada al SharePointListRWQueryConnection objeto . |
| ListId |
Obtiene o establece el identificador de lista de la lista de SharePoint asociada al SharePointListRWQueryConnection objeto . |
| Name |
Obtiene el nombre de la conexión de datos. (Heredado de DataConnection) |
| SiteUrl |
Obtiene o establece un Uri objeto que representa la dirección URL del sitio de SharePoint Foundation asociado al Microsoft.Office.InfoPath.SharepointListRWQueryConnection objeto . |
Métodos
| Execute() |
Dependiendo de la clase ConnectionTypeConnection desde la que se llame, ejecuta una operación de envío o consulta en la conexión de datos utilizando los valores definidos declarativamente para los datos enviados o los datos que se deben recuperar. (Heredado de DataConnection) |
| Execute(XPathNavigator) |
Invalida el método predeterminado Execute() para habilitar la especificación de una ubicación diferente para insertar los datos que se devuelven. |