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 ou biblioteca de documentos do SharePoint.
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 "Contacts", 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, convertendo 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 Conexões de Dados. Para escrever um código que funcione com uma conexão de dados com uma biblioteca de documentos do SharePoint criada em um modelo de formulário do 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 Conexões de Dados, 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 ou biblioteca de documentos do SharePoint.
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 do Windows SharePoint Services do qual a conexão recupera dados.
O objeto SharePointListQueryConnection associado à conexão de dados pode ser acessado usando a DataConnectionsXmlForm propriedade da 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 do InfoPath. Além disso, a classe SharePointListQueryConnection fornece o Execute(XPathNavigator) método, que permite especificar um local diferente para inserir os dados retornados.
A classe SharePointListQueryConnection corresponde à interface SharePointListAdapterObject do modelo de objeto Microsoft Office InfoPath 2003.
Construtores
| Nome | Description |
|---|---|
| SharepointListQueryConnection() |
Obsoleto.
Representa uma conexão de dados para recuperar dados de uma lista ou biblioteca de documentos do SharePoint. |
Propriedades
| Nome | Description |
|---|---|
| Name |
Obsoleto.
Obtém o nome da conexão de dados. (Herdado de DataConnection) |
| QueryThisFormOnly |
Obsoleto.
Determina se a operação de consulta se aplicará somente ao formulário atual. |
| SiteUrl |
Obsoleto.
Obtém um objeto System.Uri que representa a URL (Uniform Resource Locator) do site do Windows SharePoint Services associado ao SharepointListQueryConnection objeto. |
Métodos
| Nome | Description |
|---|---|
| Execute() |
Obsoleto.
Dependendo de qual classe ConnectionTypeConnection é 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 a especificação de um local diferente para inserir os dados retornados. |