Share via

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

  • [アーティクル]

アプリケーションがクライアントに公開する、サーバー側でアクティブ化される既知のオブジェクトに関する情報を指定します。

<configuration>
   <system.runtime.remoting>
      <application>
         <service>
**            <wellknown>**

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

省略可能属性

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

必須属性

属性 説明
mode オブジェクトが Singleton オブジェクトか SingleCall オブジェクトのいずれかを示します。いずれかのオプションを選択する必要があります。詳細については、「アクティベーション」を参照してください。
type オブジェクトの完全型名と、型の実装のアセンブリ名を指定します。格納しているアセンブリがグローバル アセンブリ キャッシュ内にある場合は、バージョン、カルチャ、および公開キーの情報が含まれます。
objectUri オブジェクトの URI (Uniform Resource Identifier) のエンドポイントを指定します。

解説

オブジェクトをインターネット インフォメーション サービス (IIS: Internet Information Services) で管理する場合は、要求が .NET リモート処理の 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>

必要条件

構成ファイル : アプリケーション構成ファイル、マシン構成ファイル (Machine.config)

参照

リモート処理設定スキーマ | アクティベーション | 構成