DataSource 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.
Representa uma fonte de dados em um modelo de formulário.
public ref class DataSource abstractpublic abstract class DataSourcetype DataSource = classPublic MustInherit Class DataSource- Herança
-
DataSource
Comentários
Um DataSource objeto corresponde a uma das fontes de dados armazenados associadas a um modelo de formulário InfoPath. Um DataSource objeto pode representar a fonte de dados primária (main) do modelo de formulário ou uma fonte de dados secundária obtida de alguma fonte externa de dados usando uma conexão de dados associada (conhecida como adaptador de dados na primeira versão do Microsoft InfoPath). Trabalhar com a fonte de dados main de um formulário fornece acesso ao documento XML subjacente do formulário, enquanto trabalhar com uma fonte de dados secundária fornece acesso aos dados recuperados de uma fonte externa de dados, como uma consulta do Serviço Web.
O DataSource objeto fornece propriedades e métodos que podem ser usados para interagir programaticamente com os dados armazenados, bem como fornecer acesso à conexão de dados associada para fontes de dados secundárias. Um DataSource objeto pode ser acessado usando a DataSources propriedade da XmlForm classe.
Para fontes de dados secundárias, um DataSource objeto atua como um intermediário entre o formulário e a conexão de dados que é usada para obter dados de uma fonte de dados externa, como uma conexão com um banco de dados Microsoft Access ou Microsoft SQL Server, um arquivo .xml ou um serviço Web XML. O tipo de objeto de conexão de dados usado depende do tipo de conexão de dados externa usada para adquirir os dados. O DataSource objeto fornece um conjunto comum de propriedades e métodos que podem ser usados para todos os tipos de objetos de conexão de dados e cada um dos objetos de conexão de dados fornece seu próprio conjunto de propriedades e métodos.
O Microsoft InfoPath dá suporte aos seguintes tipos de conexões de dados:
- Uma consulta de conexão ou envio usando a ADO (ActiveX Data Objects) representada pelos AdoQueryConnection objetos e AdoSubmitConnection .
- Uma conexão para consultar ou enviar a uma fonte de dados externa registrada no BDC (serviço de conectividade de dados empresariais) um servidor que executa o SharePoint Foundation 2010 ou o BdcQueryConnection SharePoint Server 2010 representado pelos objetos ou BdcSubmitConnection .
- Uma conexão para consultar ou enviar para uma lista do SharePoint representada pelos Microsoft.Office.InfoPath.SharepointListRWQueryConnection objetos ou Microsoft.Office.InfoPath.SharepointListRWSubmitConnection .
- Uma conexão com um serviço Web representado pelo WebServiceConnection objeto.
- Uma conexão para consultar ou enviar a um arquivo XML representado pelos FileQueryConnection objetos e FileSubmitConnection .
- Uma conexão para enviar por email representada pelo EmailSubmitConnection objeto.
A DataSource classe corresponde à interface DataObject no modelo de objeto Microsoft InfoPath 2003.
Construtores
| DataSource() |
Representa uma fonte de dados em um modelo de formulário. |
Propriedades
| Name |
Obtém o nome do objeto associado DataSource . |
| QueryConnection |
Obtém uma referência ao DataConnection objeto associado à fonte de dados. |
| ReadOnly |
Obtém um valor que indica se a fonte de dados está em um estado somente leitura. |
Métodos
| CreateNavigator() |
Retorna um XPathNavigator |
| GetNamedNodeProperty(XPathNavigator, String) |
Obtém o valor de uma propriedade nomeada para o nó XML especificado, que deve ser um nó nonattribute na fonte de dados main. |
| SetNamedNodeProperty(XPathNavigator, String, String) |
Define o valor de uma propriedade nomeada para o nó XML especificado, que deve ser um nó nonattribute na fonte de dados main. |