SharepointListQueryConnection Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cuidado
The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.
Representa uma conexão de dados para recuperar dados de uma lista do SharePoint ou biblioteca de documentos.
public ref class SharepointListQueryConnection abstract : Microsoft::Office::InfoPath::DataConnection[System.Obsolete("The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.")]
public abstract class SharepointListQueryConnection : Microsoft.Office.InfoPath.DataConnectiontype SharepointListQueryConnection = class
inherit DataConnectionPublic MustInherit Class SharepointListQueryConnection
Inherits DataConnection- Herança
- Atributos
Exemplos
No exemplo a seguir, uma referência ao objeto SharePointListQueryConnection que representa a conexão chamada "Contatos", que se conecta a uma lista de informações de contato no SharePoint, é definida passando o nome para a Item[String] propriedade da classe DataConnectionCollection e, em seguida, lançando o objeto retornado para o tipo SharePointListQueryConnection .
[C#]
SharePointListQueryConnection spConnection = (SharePointListQueryConnection)this.DataConnections["Contacts"];
Dim spConnection As SharePointListQueryConnection = _
DirectCast(Me.DataConnections("Contacts"), _
SharePointListQueryConnection)
Depois que a referência tiver sido definida, você poderá usar as propriedades ou os métodos do objeto SharePointListQueryConnection . O exemplo a seguir define uma variável de cadeia de caracteres para o valor retornado pela Name propriedade herdada da classe base DataConnection .
string spName = spConnection.Name;
Dim spName As String = spConnection.Name
Comentários
Importante: a SharepointListQueryConnection classe e seus membros foram preteridos no Microsoft InfoPath. O código escrito com os membros dessa classe é compatível apenas com uma conexão de dados com uma biblioteca de documentos do SharePoint 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 em Versão Anterior na caixa de diálogo Data Connections. Para gravar um código que funciona com uma conexão de dados com uma biblioteca de documentos do SharePoint criada em um modelo de formulário InfoPath, use os membros da SharePointListRWQueryConnection classe. Além disso, se você converter uma conexão de dados em uma biblioteca de documentos do SharePoint com o botão Converter para Versão Atual na caixa de diálogo Data Connections, você deverá reescrever qualquer código escrito com os membros da SharepointListQueryConnection classe para usar os membros da SharePointListRWQueryConnection classe.
O objeto SharePointListQueryConnection representa uma conexão de dados secundária criada no InfoPath usando o Assistente de Conexão de Dados que especifica todas as informações necessárias para recuperar dados de uma lista do SharePoint ou biblioteca de documentos.
A classe SharePointListQueryConnection fornece propriedades que podem ser usadas para obter o nome da conexão de dados e a URL (Uniform Resource Locator) da lista ou biblioteca de documentos no site Windows SharePoint Services do qual a conexão recupera dados.
O objeto SharePointListQueryConnection associado à conexão de dados está acessível usando a DataConnections propriedade da XmlForm classe para retornar a conexão do DataConnectionCollection modelo de 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 modo de design de modelo de formulário infopath. Além disso, a classe SharePointListQueryConnection fornece o método, que Execute(XPathNavigator) permite especificar um local diferente para inserir os dados retornados.
A classe SharePointListQueryConnection corresponde à interface SharePointListAdapterObject do modelo de objeto Do Microsoft Office InfoPath 2003.
Construtores
| SharepointListQueryConnection() |
Obsoleto.
Representa uma conexão de dados para recuperar dados de uma lista do SharePoint ou biblioteca de documentos. |
Propriedades
| Name |
Obsoleto.
Obtém o nome da conexão de dados. (Herdado de DataConnection) |
| QueryThisFormOnly |
Obsoleto.
Obtém se a operação de consulta será aplicada apenas ao formulário atual. |
| SiteUrl |
Obsoleto.
Obtém um objeto System.Uri que representa a URL (Uniform Resource Locator) do site Windows SharePoint Services associado ao SharepointListQueryConnection objeto. |
Métodos
| Execute() |
Obsoleto.
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) |
Obsoleto.
Substitui o método padrão Execute() para permitir que a especificação de um local diferente insira os dados retornados. |