SharePointListRWQueryConnection Classe

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Representa uma conexão de dados para recuperar dados de uma lista do SharePoint ou biblioteca de documentos.

public ref class SharePointListRWQueryConnection abstract : Microsoft::Office::InfoPath::DataConnection

public abstract class SharePointListRWQueryConnection : Microsoft.Office.InfoPath.DataConnection

type SharePointListRWQueryConnection = class
    inherit DataConnection

Public MustInherit Class SharePointListRWQueryConnection
Inherits DataConnection

Herança

Object

DataConnection

SharePointListRWQueryConnection

Exemplos

No exemplo de código a seguir, uma conexão de dados chamada "Contatos", que se conecta a uma lista de informações de contato em um site do SharePoint, é acessada usando o processo de duas etapas a seguir. O nome "Contatos" é passado para a Item[String] propriedade da DataConnectionCollection classe para recuperar um objeto que representa a conexão de dados. Em seguida, o objeto retornado da coleção é lançado para o SharePointListRWQueryConnection tipo.

SharePointListRWQueryConnection spConnection = (SharePointListRWQueryConnection)this.DataConnections["Contacts"];

Dim spConnection As SharePointListRWQueryConnection = _
   DirectCast(Me.DataConnections("Contacts"), _
   SharePointListRWQueryConnection)

Depois que a referência à conexão de dados tiver sido definida, você poderá usar as propriedades ou os métodos do SharePointListRWQueryConnection objeto. O exemplo de código a seguir define uma variável de cadeia de caracteres para o valor retornado pela Name propriedade herdada da DataConnection classe base.

string spName = spConnection.Name; Dim spName As String = spConnection.Name

Comentários

A SharePointListRWQueryConnection classe representa uma conexão de dados secundária criada no InfoPath que especifica todas as informações necessárias para recuperar dados de uma lista do SharePoint ou biblioteca de documentos. Para criar um modelo de formulário que contenha uma conexão de dados secundária com uma lista do SharePoint ou biblioteca de documentos, use o comando Data Connections na guia Dados.

Observação: o código escrito com os membros da SharePointListRWQueryConnection classe não é compatível com uma conexão de dados com uma lista do SharePoint ou biblioteca de documentos criada no InfoPath 2003 ou no InfoPath 2007, com uma conexão de dados em um novo modelo de formulário criado no InfoPath com um dos Modelos de Formulário do InfoPath 2007 ou com uma conexão de dados convertida com o botão Converter para Versão Anterior na caixa de diálogo Data Connections. Se você não precisar manter a compatibilidade com uma versão anterior do InfoPath e quiser gravar código com membros SharePointListRWQueryConnection da classe, converta a conexão de dados com o botão Converter para Versão Atual na caixa de diálogo Data Connections.

Observação: você pode criar uma conexão de dados primária (main) com uma lista do SharePoint criando um novo modelo de formulário com o modelo da Lista do SharePoint. No entanto, não é possível gravar código de formulário por trás desse formulário, pois apenas a lógica declarativa, como regras, tem suporte em um modelo de formulário criado com o modelo de Lista do SharePoint. Por esse motivo, você não pode usar a SharePointListRWQueryConnection classe e seus membros para trabalhar com uma conexão de dados primária com uma lista do SharePoint.

A SharePointListRWQueryConnection classe fornece propriedades que podem ser usadas para obter o nome da conexão de dados e a URL da lista ou biblioteca de documentos no site do SharePoint Foundation ou do Microsoft SharePoint Server do qual a conexão recupera dados.

O SharePointListRWQueryConnection objeto associado à conexão de dados é acessível usando a DataConnections propriedade da XmlForm classe para retornar a conexão do DataConnectionCollection modelo do formulário.

O método padrão Execute() , herdado da DataConnection classe base, executa uma operação de consulta ou envio usando os valores que foram definidos declarativamente no modelo de formulário InfoPath no momento do design. Além disso, a SharePointListRWQueryConnection classe fornece o Execute(XPathNavigator) método, que permite especificar um local diferente para inserir os dados retornados.

Construtores

SharePointListRWQueryConnection()

Representa uma conexão de dados para recuperar dados de uma lista do SharePoint ou biblioteca de documentos.

Propriedades

ContentTypeId	Obtém ou define a ID do tipo de conteúdo da lista do SharePoint associada ao SharePointListRWQueryConnection objeto.
ListId	Obtém ou define a ID da lista do SharePoint associada ao SharePointListRWQueryConnection objeto.
Name	Obtém o nome da conexão de dados. (Herdado de DataConnection)
SiteUrl	Obtém ou define um Uri objeto que representa a URL do site do SharePoint Foundation associado ao Microsoft.Office.InfoPath.SharepointListRWQueryConnection objeto.

Métodos

Execute()	Dependendo da classe ConnectionTypeConnection da qual é chamada, executa uma operação de envio ou consulta na conexão de dados usando os valores definidos declarativamente para os dados enviados, parâmetros de consulta ou dados a serem recuperados. (Herdado de DataConnection)
Execute(XPathNavigator)	Substitui o método padrão Execute() para habilitar a especificação de um local diferente para inserir os dados retornados.