<userDefinedType>

  • [アーティクル]

サービス コントラクトに含まれるユーザー定義型 (UDT) を表します。

<system.serviceModel>
  <comContracts>
    <comContract>
      <userDefinedTypes>

<comContracts>
  <comContract>
      <userDefinedTypes>
         <userDefinedType name="string"
            typeLibID="string"
            typeLibVersion="string"
            typeDefID="string">
         </userDefinedType>
      </userDefinedTypes>
  </comContract>
</comContracts>

属性および要素

属性

属性 説明

name

判読可能な型名を提供する文字列を含む省略可能な属性。これは、ランタイムでは使用されませんが、リーダーが型を区別するのに役立ちます。

TypeDefID

登録されているタイプ ライブラリ内の特定の UDT 型を識別する GUID 文字列。

TypeLibID

型を定義する登録されているタイプ ライブラリを識別する GUID 文字列。

TypeLibVersion

型を定義するタイプ ライブラリ バージョンを識別する文字列。

子要素

なし。

親要素

要素 説明

userDefinedTypes

userDefinedType 要素のコレクション。

解説

COM+ 統合ランタイムは、タイプ ライブラリを調べることによってサービスを作成します。COM+ コンポーネントに VARIANT を渡すメソッドが含まれている場合、システムでは、渡される実際の型を実行前に判断することはできません。したがって、VARIANT としてユーザー定義型 (UDT) を渡そうとしても、シリアル化で認識できる型ではないので失敗します。

この問題を回避するには、UDT を構成ファイルに追加して、適切なサービス コントラクトで既知の型として含まれるようにすることができます。このためには、UDT およびコントラクト、つまりそれを使用する元の COM インターフェイスを一意に識別する必要があります。

この目的で、2 つの特定の UDT を構成ファイルの <userDefinedTypes> セクションに追加するコード例を次に示します。

<comContracts>
  <comContract
      contract="{5163B1E7-F0CF-4B6A-9A02-4AB654F34284}"
      namespace="http://tempuri.org/5163B1E7-F0CF-4B6A-9A02-4AB654F34284"
      name="_Broker"
      requireSession="true">
      <userDefinedTypes>
         <userDefinedType name="CustomerType"
            typeLibID="{91DC728C-4F1A-45de-A9B6-B538E209CEA6}"
            typeLibVersion="1.0"
            typeDefID="{D129765C-F211-434e-825A-9A63198C41F2}">
         </userDefinedType>
         <userDefinedType name="AddressType"
            typeLibID="{91DC728C-4F1A-45de-A9B6-B538E209CEA6}"
            typeLibVersion="1.0"
            typeDefID="{4616AE0D-687A-43B7-BC63-141AE3DFD099}">
         </userDefinedType>
      </userDefinedTypes>
      <exposedMethods>
         <exposedMethod name="BuyStock" />
         <exposedMethod name="SellStock" />
         <exposedMethod name="ExecuteTransaction" />
      </exposedMethods>
  </comContract>
</comContracts>

サービスを初期化する場合、統合ランタイムは、指定された型を検索し、指定されたコントラクトで既知の型のコレクションにそれらを追加します。

関連項目

リファレンス

UserDefinedTypes
ComUdtElementCollection
ComUdtElement

概念

<comContracts>

その他の技術情報

Integrating with COM+ Applications
How to: Configure COM+ Service Settings