FileQueryConnection Classe

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Representa uma conexão para recuperar dados de um arquivo XML.

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

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

type FileQueryConnection = class
    inherit DataConnection

Public MustInherit Class FileQueryConnection
Inherits DataConnection

Herança

Object

DataConnection

FileQueryConnection

Comentários

A classe FileQueryConnection representa uma conexão de dados criada no InfoPath usando o Assistente de Conexão de Dados que especifica todas as informações necessárias para recuperar dados de um arquivo XML que é usado como uma fonte de dados secundária (externa).

O objeto FileQueryConnection está acessível usando a DataConnections propriedade da XmlForm classe para retornar a conexão do DataConnectionCollection modelo do formulário.

O objeto FileQueryConnection também pode ser acessado do modelo de DataSourceCollection formulário usando a DataSources propriedade do XmlForm, e a QueryConnection propriedade da DataSource classe, conforme mostrado na linha de código a seguir.

FileQueryConnection myDataSource = 
   (FileQueryConnection)(DataSources["XMLFile"].QueryConnection);

Dim myDataSource As FileQueryConnection  = 
   DirectCast(DataSources("XMLFile").QueryConnection, _
   FileQueryConnection)

A classe FileQueryConnection fornece a FileLocation propriedade, que pode ser usada para obter ou definir a URL (Uniform Resource Locator) ou o caminho UNC (convenção universal de nomenclatura) do arquivo XML que está sendo usado como uma fonte de dados externa.

Além do método padrão Execute() herdado da DataConnection classe base que executa uma operação de consulta usando os valores que foram definidos declarativamente no modo de design de modelo de formulário InfoPath, a classe FileQueryConnection também fornece o Execute(XPathNavigator) método, que permite especificar um nó XML diferente no qual inserir os dados retornados do arquivo XML externo.

A classe FileQueryConnection corresponde à classe XMLFileAdapterObject do modelo de objeto Do Microsoft Office InfoPath 2003.

Construtores

FileQueryConnection()

Representa uma conexão para recuperar dados de um arquivo XML.

Propriedades

FileLocation	Obtém ou define o caminho da URL (Uniform Resource Locator) ou da UNC (convenção de nomenclatura universal) do arquivo XML associado ao FileQueryConnection objeto.
Name	Obtém o nome da conexão de dados. (Herdado de DataConnection)

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 permitir que a especificação de um local diferente insira os dados retornados.