次の方法で共有

WebServiceConnection クラス

  • リファレンス

定義

名前空間:
Microsoft.Office.InfoPath
アセンブリ:
Microsoft.Office.InfoPath.dll

XML Web サービスへの接続を表します。

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
継承
Object
DataConnection
WebServiceConnection

例

次の例では、"Main query" という名前の接続を表す WebServiceConnection オブジェクトへの参照を設定するには、DataConnectionCollection クラスのプロパティにItem[String]名前を渡し、返されたオブジェクトを WebServiceConnection 型にキャストします。

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

参照が設定されたら、次の例に示すように WebServiceConnection オブジェクトのプロパティを使用できます。これは、文字列変数を プロパティによって ServiceUrl 返される値に設定します。

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

注釈

WebServiceConnection クラスは、データ接続ウィザードを使用して InfoPath で作成されたデータ接続を表し、Web サービスを使用してデータを取得して外部データ ソースに送信するために必要なすべての情報を指定します。

WebServiceConnection には、データ接続の入力文字列および操作文字列に関する情報を取得および設定するために使用可能なプロパティが用意されています。 また、XML Web サービスの Web サービス記述言語 (WDSL) ファイルの URL (Uniform Resource Locator) を取得するためのプロパティも用意されています。

データ接続に関連付けられている WebServiceConnection オブジェクトにアクセスするには、 クラスの プロパティをDataConnectionsXmlForm使用して、フォーム テンプレートの からDataConnectionCollection接続を返します。

InfoPath フォーム テンプレート デザイン モードで宣言的に定義された値を使用してクエリまたは送信操作を実行する基底クラスからDataConnection継承された既定Execute()のメソッドに加えて、WebServiceConnection クラスにはメソッドも用意Execute(XPathNavigator, XPathNavigator, XPathNavigator)されています。これにより、送信する別のデータ ソースを指定できます。これにより、返されたデータを挿入する別の場所を指定できます。 接続によって返されるエラーを取得する方法。

WebServiceConnection クラスは、Microsoft Office InfoPath 2003 オブジェクト モデルの WebServiceAdapterObject インターフェイスに対応しています。

コンストラクター

WebServiceConnection()

XML Web サービスへの接続を表します。

プロパティ

Name

データ接続の名前を取得します。

(継承元 DataConnection)
ServiceUrl

オブジェクトに関連付 WebServiceConnection けられている Web サービスの呼び出しに使用される Uniform Resource Locator (URL) を取得または設定します。
SoapAction

オブジェクトに関連付けられている Web サービスの soapAction 属性の値を WebServiceConnection 取得または設定します。
Timeout

オブジェクトに関連付けられているデータ接続のタイムアウト値を秒単位で WebServiceConnection 取得または設定します。
WsdlUrl

オブジェクトに関連付けられている Web サービスの Web サービス記述言語 (WSDL) ファイルの Uniform Resource Locator (URL) を WebServiceConnection 取得します。

メソッド

Execute()

どの ConnectionTypeConnection クラスから呼び出されたかに応じて、送信されるデータ、クエリ パラメーター、または取得するデータに対して宣言的に定義された値を使用して、データ接続で送信操作またはクエリ操作を実行します。

(継承元 DataConnection)
Execute(XPathNavigator, XPathNavigator, XPathNavigator)

送信するデータの別のソース、返されるデータを挿入する別の場所、返されるエラー テキストを挿入する場所を指定できるように、基底クラスからDataConnection継承された既定Execute()のメソッドをオーバーライドします。
GenerateDataSetDiffGram()

ADO .NET の DataSet を使用するデータ接続で、データ要素の元のバージョンと現在のバージョンの違いを識別する DiffGram を返します。

適用対象