<channel> 要素 (テンプレート)

[アーティクル]
09/17/2008

アプリケーションがリモートオブジェクトと通信したり、リモートオブジェクトに対する要求を待機したりするために指定および構成できるチャネルテンプレートを指定します。使用するためにチャネルを登録できる場所ならどこででも、そのインスタンスチャネル要素の id 属性を、このテンプレートの ref 属性に設定できます。

<system.runtime.remoting> 要素

<channels> 要素 (テンプレート)

<channel> 要素 (テンプレート)

<channel  
   id="channelID" 
   type="ChannelType, ChannelAssembly"
   displayName="displayName"
   customChannelProperty="customChannelValue"
   <!-- Available only to client configurations -->
   delayLoadAsClientChannel="true|false"
/>

属性および要素

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

属性

属性	説明
customChannelProperty	省略可能属性サポートされているカスタムチャネルプロパティを示します。チャネルがサポートするチャネルプロパティをいくつでも指定できます。カスタムチャネルプロパティは、属性と値のペアで指定します。たとえば、次のようにします。 `<channel id="CustomChannel" type="Namespace.CustomChannel, CustomChannels" customProperty="PropertyValue"/>`
delayLoadAsClientChannel	省略可能属性クライアントがチャネルをアプリケーション用に登録していない場合に、対象のチャネルを読み込むかどうかを示します。この値は Boolean 値で、クライアントの動作にだけ影響します。値が true の場合は、.NET Framework リモート処理が実行時に該当チャネルを調べて、そのチャネルがリモートアクティべーション URL に指定されている特定のプロトコルスキームを使用したクライアント接続をサポートしているかどうかを確認することを示します。値が指定されない場合の既定値は false です。
displayName	省略可能属性このアプリケーションが使用するチャネルのリストを作成するために、.NET Framework 構成ツールによって使用されます。この属性は、.NET Framework リモート処理システムでは使用されません。
id	必須属性チャネルの登録時にアプリケーションがそのチャネルを識別するために使用する文字列を指定します。このチャネルテンプレートを参照するには、この属性の値として、インスタンスチャネル要素の ref 属性の値を指定します。

子要素

要素	説明
<serverProviders>	サーバー側のチャネルシンク呼び出しチェーンに挿入されるシンクのシンクプロバイダを指定します。プロバイダが指定されている場合は、それらのプロバイダによって、チャネルの既定値が完全にオーバーライドされます。<channel> テンプレート要素内に 1 回だけ指定できます。
<clientProviders>	クライアント側のチャネルシンク呼び出しチェーンに挿入されるシンクのシンクプロバイダを指定します。プロバイダが指定されている場合は、それらのプロバイダによって、チャネルの既定値が完全にオーバーライドされます。<channel> テンプレート要素内に 1 回だけ指定できます。

親要素

要素	説明
channels	アプリケーションがリモートオブジェクトと通信するために使用するチャネルテンプレートを指定します。この要素で宣言したチャネルは、チャネルが登録される場所なら、どこからでも参照できます。
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
system.runtime.remoting	ASP.NET 構成セクションのルート要素を指定します。

解説

チャネルテンプレートは、コンピュータの構成ファイル、アプリケーションファイル、または RemotingConfiguration.Configure() の呼び出しによって読み込まれるその他のファイルで指定できます。

例

次の構成ファイルは、<channels> テンプレート要素を使用して、id が "httpbinary" の HttpChannel を宣言し、リモート呼び出しをシリアル化する BinaryClientFormatterSink を使用しています。次に、<application> 要素内の <channel> インスタンス要素に ref="httpbinary" と指定することにより、クライアントアプリケーションが特定のチャネル構成を使用するように要求しています。最後に、"propsetter" チャネルシンクプロバイダを追加し、このチャネルシンクプロバイダによって使用されるカスタム構成要素をいくつか渡します。type 属性を使用してグローバルアセンブリキャッシュにあるアセンブリ内の型を指定するには、バージョン、カルチャ、および公開キーの情報を含む完全な型情報が必要です。次の例の type 属性では、簡略にするためにこの情報が省略されています。

<configuration>
   <system.runtime.remoting>
      <channelSinkProviders>
         <clientProviders>
            <provider 
               id="propsetter" 
               type="ChannelSinkPropertySetterProvider, PropsSink" 
            />
         </clientProviders>
      <channels>
         <channel 
            type="System.Runtime.Remoting.Channels.Http.HttpChannel, System.Runtime.Remoting, ...." 
            id="httpbinary"
         >
            <clientProviders>
               <formatter                   type="System.Runtime.Remoting.Channels.BinaryClientFormatterSinkProvider, System.Runtime.Remoting, ...."
               />
            </clientProviders>
         </channel>
      </channels>
      <application>
         <channels>
            <channel ref="httpbinary">
               <clientProviders>
                  <provider 
                     ref="propsetter" 
                     username="somename" 
                     writeToConsole="true"
                  >
                     <endpoint url="contoso.com:9000" someProperty="xyz" />
                     <endpoint url="contoso.com:9001" someProperty="123" />
                  </provider>
               </clientProviders>
            </channel>
         </channels>
         <client>
            <wellknown 
               url="http://computername:80/RemoteType.rem"
               type="RemoteType, RemoteAssembly"
            />
         </client>
      </application>
   </system.runtime.remoting>
</configuration>

次の方法で共有

<channel> 要素 (テンプレート)

属性および要素

属性

子要素

親要素

解説

例

関連項目

参照

その他のリソース