WebServiceConnection Classe

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Representa uma conexão com um serviço Web XML.

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

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

type WebServiceConnection = class
    inherit DataConnection

Public MustInherit Class WebServiceConnection
Inherits DataConnection

Herança

Object

DataConnection

WebServiceConnection

Exemplos

No exemplo a seguir, uma referência ao objeto WebServiceConnection que representa a conexão chamada "Consulta principal" é definida passando o nome para a Item[String] propriedade da classe DataConnectionCollection e, em seguida, lançando o objeto retornado para o tipo WebServiceConnection .

WebServiceConnection wsConnection = (WebServiceConnection)this.DataConnections["Main query"];

Dim wsConnection As WebServiceConnection = _
   DirectCast(Me.DataConnections("Main query"), WebServiceConnection)

Depois que a referência tiver sido definida, você poderá usar as propriedades do objeto WebServiceConnection , conforme mostrado no exemplo a seguir, que define uma variável de cadeia de caracteres para o valor retornado pela ServiceUrl propriedade.

string wsServiceURL = wsConnection.ServiceUrl.ToString();

Dim wsServiceURL As String = _
   string wsServiceURL = wsConnection.ServiceUrl.ToString()

Comentários

A classe WebServiceConnection 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 e enviar dados para uma fonte de dados externa usando um serviço Web.

O WebServiceConnection fornece propriedades que podem ser usadas para obter e definir informações sobre as cadeias de caracteres de entrada e operação da conexão de dados. Ele também fornece uma propriedade para obter a URL (Uniform Resource Locator) do arquivo WSDL (Linguagem de Descrição dos Serviços Web) do serviço Web XML.

O objeto WebServiceConnection 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.

Além do método padrão Execute() herdado da DataConnection classe base que 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, a classe WebServiceConnection também fornece o Execute(XPathNavigator, XPathNavigator, XPathNavigator) método, que permite especificar uma fonte diferente de dados a serem enviadas, um local diferente para inserir os dados retornados, e uma maneira de recuperar erros retornados pela conexão.

A classe WebServiceConnection corresponde à interface WebServiceAdapterObject do modelo de objeto Do Microsoft Office InfoPath 2003.

Construtores

WebServiceConnection()

Representa uma conexão com um serviço Web XML.

Propriedades

Name	Obtém o nome da conexão de dados. (Herdado de DataConnection)
ServiceUrl	Obtém ou define a URL (Uniform Resource Locator) usada para invocar o serviço Web associado a um WebServiceConnection objeto.
SoapAction	Obtém ou define o valor do atributo soapAction do serviço Web associado a um WebServiceConnection objeto.
Timeout	Obtém ou define o valor de tempo limite em segundos para a conexão de dados associada a um WebServiceConnection objeto.
WsdlUrl	Obtém a URL (Uniform Resource Locator) do arquivo WSDL (Linguagem de Descrição dos Serviços Web) para o serviço Web associado ao WebServiceConnection objeto.

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, XPathNavigator, XPathNavigator)	Substitui o método padrão Execute() herdado da DataConnection classe base para permitir a especificação de uma fonte diferente de dados a serem enviadas, um local diferente para inserir os dados retornados ou um local para inserir qualquer texto de erro retornado.
GenerateDataSetDiffGram()	Para uma conexão de dados que usa um ADO .NET DataSet e retorna um DiffGram que identifica quaisquer diferenças entre versões originais e atuais de elementos de dados.