方法: サービス モニカーを登録および構成する

  • [アーティクル]

COM アプリケーションの Windows Communication Foundation (WCF) サービス モニカーを型付きコントラクトで使うには、必要な属性を備えた型を COM に登録し、COM アプリケーションとモニカーに、必要なバインディング設定を組み込まなければなりません。

必要な属性を備えた型を COM に登録する

  1. ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe) ツールを使用して、WCF サービスからメタデータ コントラクトを取得します。 これにより、WCF クライアント アセンブリに組み込むソース コードと、クライアント アプリケーションの構成ファイルが生成されます。

  2. アセンブリ内で定義されている型に ComVisible という設定をします。 これを行うには、Visual Studio プロジェクトで、AssemblyInfo.cs ファイルに次の属性を追加してください。

    [assembly: ComVisible(true)]

  3. マネージド WCF クライアントを、厳密な名前のアセンブリとしてコンパイルします。 そのためには暗号キー ペアで署名する必要があります。 詳しくは、「厳密な名前でのアセンブリへの署名」をご覧ください。

  4. アセンブリ登録 (Regasm.exe) ツールに -tlb オプションを指定して、アセンブリで定義されている型を COM に登録します。

  5. グローバル アセンブリ キャッシュ ツール (Gacutil.exe) で、グローバル アセンブリ キャッシュにアセンブリを追加します。

    Note

    アセンブリへの署名とグローバル アセンブリ キャッシュへの追加は、必須ではありません。しかしこれを済ませておくと、実行時には、適切な場所からアセンブリを読み込むための手順が簡単になります。

COM アプリケーションとモニカーに必要なバインディングを設定する

  • ServiceModel メタデータ ユーティリティ ツール (Svcutil.exe) で生成したバインディング定義を、クライアント アプリケーションの構成ファイルにコピーします。 たとえば、Visual Basic 6.0 で開発した実行可能ファイルの名前が CallCenterClient.exe の場合、これと同じディレクトリに、CallCenterConfig.exe.config という名前で構成ファイルを作成します。 するとクライアント アプリケーションはモニカーを使えるようになります。 なお、WCF に組み込まれている標準のバインディング型を使うのであれば、バインディングの設定は必要ありません。

    次の型が登録されています。

    using System.ServiceModel;

[ServiceContract]
public interface IMathService
{
    [OperationContract]
    public int Add(int x, int y);
    [OperationContract]
    public int Subtract(int x, int y);
}

    このアプリケーションは、wsHttpBinding バインディングを使用して公開されています。 このような型とアプリケーション設定であれば、次のようなモニカー文字列が使用されます。

    service4:address=http://localhost/MathService, binding=wsHttpBinding, bindingConfiguration=Binding1

    or

    service4:address=http://localhost/MathService, binding=wsHttpBinding, bindingConfiguration=Binding1, contract={36ADAD5A-A944-4d5c-9B7C-967E4F00A090}

    IMathService 型を定義するアセンブリへの参照を追加すれば、次のコード例のように、Visual Basic 6.0 アプリケーションに上記のモニカー文字列 (どちらの形式でも可) を記述できるようになります。

    Dim mathProxy As IMathService
Dim result As Integer

Set mathProxy = GetObject( _
        "service4:address=http://localhost/MathService, _
        binding=wsHttpBinding, _
        bindingConfiguration=Binding1")

result = mathProxy.Add(3, 5)

    この例で、バインド構成 Binding1 の定義は、クライアント アプリケーションごとに、vb6appname.exe.config など該当する名前の構成ファイルに記述します。

    Note

    同様のコードを C#、C++、およびその他の .NET 言語アプリケーションで使用できます。

    Note

    モニカーの形式が正しくないか、サービスを使用できない場合は、GetObject を呼び出すと、"構文が無効です" というエラーが返されます。 このエラーが発生した場合は、使用しているモニカーが正しく、サービスが使用可能であることを確認してください。

    このトピックでは、主に Visual Basic 6.0 コードからサービス モニカーを使用する方法について説明していますが、他の言語からサービス モニカーを使用することもできます。 C++ コードからモニカーを使用している場合、次のコードに示すように、Svcutil.exe によって生成されたアセンブリを、"no_namespace named_guids raw_interfaces_only" と共にインポートする必要があります。

    #import "ComTestProxy.tlb" no_namespace named_guids

    これにより、インポートされたインターフェイス定義は、すべてのメソッドが HResult を返すように変更されます。 他の戻り値は、出力パラメーターに変換されます。 メソッドの実行全体は、同じままです。 このために、プロキシでメソッドを呼び出したときの例外の原因を特定できます。 この機能は C++ コードからのみ使用できます。

関連項目