<client> 要素

  • [アーティクル]

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

アプリケーションが使用するオブジェクトを指定します。url 属性は、サーバー側でアクティブ化される型の場合は必須ではありませんが、クライアント側でアクティブ化される型の場合は必須です。一意の URL はそれぞれ固有の client 要素を持つことになり、この要素には、その URL の位置で公開される、クライアント側でアクティブ化される型が含まれます。この要素は、アプリケーション構成ファイルとマシン構成ファイルに出現する可能性があります。

Schema Hierarchy

<configuration>
  <system.runtime.remoting> 要素
    <application> 要素
      <client> 要素

構文

<client
   url="url"
   displayName="displayName"
/>

属性と要素

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

属性

属性 説明

url

この属性は、リモート型がすべてサーバー側でアクティブ化される型の場合は省略できますが、クライアント側でアクティブ化される型が含まれている場合には必須です。

displayName

クライアント アプリケーションのリストを作成するために、the .NET Framework Configuration Toolで使用します。この属性は、.NET Framework リモート処理システムでは使用されません。

子要素

要素 説明

wellknown

アプリケーションが使用する、サーバー側でアクティブ化される既知のオブェクトに関する情報を指定します。client 要素内に 1 回以上指定できます。

activated

アプリケーションが使用する、クライアント側でアクティブ化されるオブジェクトに関する情報を指定します。client 要素内に 1 回以上指定できます。

親要素

要素 説明

application

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

configuration

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

system.runtime.remoting

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

例

次の構成ファイルは、サーバー側でアクティブ化される (既知の) リモート型を使用する対象として宣言し、クライアント アプリケーションが HttpChannel を使用するように指定していますが、.NET Framework リモート処理システムがクライアントの代わりに適切なポートを検出できるようにもしています。

<configuration>
   <system.runtime.remoting>
      <application>
         <client>
            <wellknown 
               type="RemoteType, RemoteAssembly"
               url="http://computername:8080/RemoteType.rem"
            />
         </client>
         <channels>
            <channel
               ref="http" 
               port="0"
            />
         </channels>
      </application>
   </system.runtime.remoting>
</configuration>

参照

リファレンス

リモート処理設定スキーマ
<client>

概念

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

ビルド日:2010-02-13