クライアント アプリケーションへの SOAP トレース サポートの追加

「SQL SOAP トレース サンプル クラス ライブラリの C# コード リスト」の内容をコピーしてメモ帳に貼り付け、"SqlSoapTracer.cs" という名前を付けて SOAP クライアント プロジェクト ファイルを含むフォルダと同じフォルダに保存します。

クライアント コンピュータで、[スタート] ボタンをクリックし、[すべてのプログラム] をポイントします。次に、[Microsoft Visual Studio 2005] の Microsoft Visual Studio 2005 を起動します。

[プロジェクトを開く] をクリックします。

SOAP クライアント プロジェクト (.csproj) ファイルを参照し、選択します。

ソリューション エクスプローラで、次の手順を実行します。

1. 名前でプロジェクトを選択し、選択したプロジェクトを右クリックします。次に、[追加] をポイントして [既存の項目の追加] をクリックします。

2. [既存の項目の追加] ダイアログ ボックスで、手順 1. で SqlSoapTracer.cs ファイルを保存した場所を参照し、ファイルを選択します。

3. [すべてのファイルを表示] をクリックし、[Web 参照] ノードを展開して、Reference.cs ファイルを選択します。

コード エディタで、Web メソッドのエントリ ポイントを追加して、Reference.cs ファイルを更新します。

たとえば、「Visual Studio 2005 クライアントを使用した SOAP 要求の送信 (C#)」で使用しているサンプル プロジェクトに SOAP トレース サポートを追加すると、そのプロジェクトに含まれているさまざまな Web メソッドの公開済みの Web メソッド エントリ ポイントは次のように表示されます。

                public object[] GetCustomerInfo([System.Xml.Serialization.XmlElementAttribute(IsNullable=true)] System.Data.SqlTypes.SqlString CustomerID, [System.Xml.Serialization.XmlElementAttribute(IsNullable=true)] ref System.Data.SqlTypes.SqlString OutputParam) {
            object[] results = this.Invoke("s2MsgGetCustomerInfoSoapIn", new object[] {
                        CustomerID,
                        OutputParam});
            OutputParam = ((System.Data.SqlTypes.SqlString)(results[1]));
            return ((object[])(results[0]));
        }

...

public System.Data.SqlTypes.SqlInt32 UDFReturningAScalar() {
            object[] results = this.Invoke("s1MsgUDFReturningAScalarSoapIn", new object[0]);
            return ((System.Data.SqlTypes.SqlInt32)(results[0]));
        }

クライアント コードで Web メソッドを実行するときに SOAP トレース サポートを追加するには、次のコード行に示すように、Reference.cs コード内のトレースする各 Web メソッドのエントリ ポイントの直前に、snoopattribute() 呼び出しを追加します。

                [snoopattribute()]
public object[] GetCustomerInfo(...) {...}
...
[snoopattribute()]
public System.Data.SqlTypes.SqlInt32 UDFReturningAScalar() {...}

これにより、これらの Web メソッドが実行されるときに Web メソッドの SOAP トレースを開始する SOAP 拡張機能が登録されます。