SharepointListQueryConnection Classe

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Cuidado

The SharePointListQueryConnection class has been deprecated. Use SharePointListRWQueryConnection instead.

Representa uma ligação de dados para obter 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.DataConnection

type SharepointListQueryConnection = class
    inherit DataConnection

Public MustInherit Class SharepointListQueryConnection
Inherits DataConnection

Herança

Object

DataConnection

SharepointListQueryConnection

Atributos

ObsoleteAttribute

Exemplos

No exemplo seguinte, uma referência ao objeto SharePointListQueryConnection que representa a ligação denominada "Contactos", que se liga a uma lista de informações de contacto no SharePoint, é definida ao transmitir o Item[String] nome para a propriedade da classe DataConnectionCollection e, em seguida, ao lançar o objeto devolvido para o tipo SharePointListQueryConnection .

[C#]

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

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

Depois de definir a referência, pode utilizar as propriedades ou métodos do objeto SharePointListQueryConnection . O exemplo seguinte define uma variável de cadeia para o valor devolvido 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 os respetivos membros foram preteridos no Microsoft InfoPath. O código escrito com os membros desta classe é compatível apenas com uma ligação de dados a uma biblioteca de documentos do SharePoint criada no InfoPath 2003 ou no InfoPath 2007, com uma ligação de dados num novo modelo de formulário criado no InfoPath com um dos Modelos de Formulário do InfoPath 2007 ou com uma ligação de dados convertida com o botão Converter para Versão Anterior na caixa de diálogo Connections dados. Para escrever código que funcione com uma ligação de dados a uma biblioteca de documentos do SharePoint criada num modelo de formulário do InfoPath, utilize os membros da SharePointListRWQueryConnection classe . Além disso, se converter uma ligação de dados numa biblioteca de documentos do SharePoint com o botão Converter para Versão Atual na caixa de diálogo Connections dados, terá de reescrever qualquer código escrito com os membros da SharepointListQueryConnection classe para utilizar os membros da SharePointListRWQueryConnection classe.

O objeto SharePointListQueryConnection representa uma ligação de dados secundária criada no InfoPath através do Assistente de Ligação de Dados que especifica todas as informações necessárias para obter dados de uma lista ou biblioteca de documentos do SharePoint.

A classe SharePointListQueryConnection fornece propriedades que podem ser utilizadas para obter o nome da ligação de dados e o UrL (Uniform Resource Locator) da lista ou biblioteca de documentos no site Windows SharePoint Services a partir do qual a ligação obtém dados.

O objeto SharePointListQueryConnection associado à ligação de dados é acessível através DataConnections da propriedade da XmlForm classe para devolver a ligação do DataConnectionCollection modelo de formulário.

O método predefinido Execute() , herdado da DataConnection classe base, executa uma consulta ou operação de submissão com os valores que foram definidos declarativamente no modo de estrutura do modelo de formulário do InfoPath. Além disso, a classe SharePointListQueryConnection fornece o Execute(XPathNavigator) método , que lhe permite especificar uma localização diferente para inserir os dados devolvidos.

A classe SharePointListQueryConnection corresponde à interface sharePointListAdapterObject do modelo de objetos do Microsoft Office InfoPath 2003.

Construtores

SharepointListQueryConnection()

Obsoleto. Representa uma ligação de dados para obter dados de uma lista ou biblioteca de documentos do SharePoint.

Propriedades

Name	Obsoleto. Obtém o nome da ligaçã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 o UrL (Uniform Resource Locator) do site de Windows SharePoint Services associado ao SharepointListQueryConnection objeto.

Métodos

Execute()	Obsoleto. Dependendo da classe ConnectionTypeConnection a partir da qual é chamada, executa uma operação de submissão ou consulta na ligação de dados com os valores definidos declarativamente para os dados submetidos, parâmetros de consulta ou dados a obter. (Herdado de DataConnection)
Execute(XPathNavigator)	Obsoleto. Substitui o método predefinido Execute() para permitir especificar uma localização diferente para inserir os dados devolvidos.