Share via

<wellknown> 要素 (サービス インスタンス)

  • [アーティクル]

このトピックの対象は、既存のアプリケーションとの下位互換性のために残されているレガシ テクノロジに特定されています。新規の開発には、このトピックを適用しないでください。分散アプリケーションは、現在は Windows Communication Foundation (WCF) を使用して開発する必要があります。

アプリケーションがクライアントに公開する、サーバー側でアクティブ化される既知のオブジェクトに関する情報を指定します。この要素は、アプリケーション構成ファイルとマシン構成ファイルに出現する可能性があります。

Schema Hierarchy

<configuration>
  <system.runtime.remoting> 要素
    <application> 要素
      <service> 要素
        <wellknown> 要素 (サービス インスタンス)

構文

<wellknown  
   mode="Singleton|SingleCall"
   displayName="name"
   type="type,assembly" 
      objectUri="objectUri" 
/>

属性と要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明

mode

必須属性

オブジェクトが Singleton オブジェクトか SingleCall オブジェクトのいずれかを示します。いずれかのオプションを選択する必要があります。詳細については、「アクティベーション」を参照してください。

objectUrl

必須属性

オブジェクトの URI (Uniform Resource Identifier) のエンドポイントを指定します。

type

必須属性

オブジェクトの完全型名と、型の実装のアセンブリ名を指定します。格納しているアセンブリがグローバル アセンブリ キャッシュ内にある場合は、バージョン、カルチャ、および公開キーの情報が含まれます。

displayName

省略可能属性

.NET Framework 構成ツールによって使用し、公開用に登録されたサーバー側でアクティブ化されるオブジェクトのリストを作成します。この属性は、.NET Framework リモート処理システムによっては使用されません。

子要素

なし。

親要素

要素 説明

application

アプリケーションが使用および公開するリモート オブジェクトに関する情報を指定します。

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。

service

アプリケーションが、他のアプリケーション ドメインまたはアプリケーション コンテキストに公開するオブジェクトを指定します。

system.runtime.remoting

リモート オブジェクトおよびチャネルに関する情報を指定します。

解説

オブジェクトをインターネット インフォメーション サービス (IIS: Internet Information Services) でホストする場合は、要求が .NET Framework リモート処理の IHttpHandler にルーティングされるように、objectUri の拡張子を .soap または .rem にする必要があります。

例

次の構成ファイルは、サーバー側でアクティブ化される既知の型、この型が存在する場所を示すオブジェクト URI、およびインスタンスのアクティブ化を制御する WellKnownObjectMode を宣言しています。

<configuration>
   <system.runtime.remoting>
      <application>
         <service>
            <wellknown 
               type="ServerActivatedType, RemoteAssembly" 
               objectUri="ServerType.rem" 
               mode="Singleton" 
            />
         </service>
      </application>
   </system.runtime.remoting>
</configuration>

参照

リファレンス

リモート処理設定スキーマ

概念

リモート オブジェクトのアクティベーション
リモート アプリケーションの構成

ビルド日:2010-02-13