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

クライアントまたはサーバーのチャネル シンク チェーンに挿入されるフォーマッタ シンクのチャネル シンク プロバイダを指定します。階層内で、この要素を含めることができる位置は 2 つあります。

<configuration>

<system.runtime.remoting>

<channelSinkProviders>

<clientProviders>

<formatter>

ここで指定されたフォーマッタ プロバイダは、<formatter> インスタンスによって使用されるテンプレートになります。

<configuration>

<system.runtime.remoting>

<channelSinkProviders>

<serverProviders>

<formatter>

ここで指定されたフォーマッタ プロバイダも、<formatter> インスタンスによって使用されるテンプレートになります。

<formatter  
   id="FormatterID"
   type="FormatterSinkProviderType, FormatterAssembly"
   customFormatterProperty="customProperty"
   includeVersions="true"
   strictBinding="false"
...typeFilterLevel="Low | Full"
/>

省略可能属性

<provider id="CustomChannelSinkProvider" type="Namespace.CustomChannelSinkProvider, CustomChannels" customChannelSinkProperty="ChannelSinkPropertyValue"/>

<provider ref="custom">
<extra data="value"/>
<extra data="AnotherValue"/>
</provider>

必要な属性

解説

ここで指定したフォーマッタは、同じ構成ファイルまたは同じアプリケーションによって読み込まれる別の構成ファイルの <formatter> インスタンス要素で参照できます。

includeVersions 属性と strictBinding 属性を両方とも指定した場合に、2 つの属性の間で発生する動作を次の表に示します。

例

次の構成ファイルでは <clientProviders> インスタンスが使用されているため、チャネルが使用するすべてのフォーマッタとプロバイダを指定しておく必要があります。この例では、<formatter> 要素が SoapClientFormatterSink を参照し、<provider> インスタンス要素を使用して、<provider> テンプレート要素で宣言されている "propsetter" および "null" チャネル シンク プロバイダを HttpChannel に割り当てています。また、"propsetter" チャネル シンク プロバイダは、<provider> インスタンス要素の属性として、および子 <endpoint> 属性の名前と値の組み合わせとして指定されたカスタム プロバイダ プロパティを使用して作成されています。

<configuration>
   <system.runtime.remoting>
      <application>
         <client>
            <wellknown 
               type="RemoteType, RemoteAssembly"
               url="http://computername:8080/RemoteType.rem"/>
         </client>
         <channels>
            <channel ref="http">
               <clientProviders>
                  <formatter ref="soap"/>
                  <provider 
                     ref="propsetter" 
                     username="bob" 
                     writeToConsole="true"
                  >
                     <endpoint url="contoso.com:9000" someProperty="xyz" />
                     <endpoint url="contoso.com:9001" someProperty="123" />
                  </provider>
                  <provider ref="null" writeToConsole="true" />
               </clientProviders>
            </channel>
         </channels>
      </application>
      <channelSinkProviders>
         <clientProviders>
            <provider 
               id="propsetter" 
               type="ChannelSinkPropertySetterProvider, SinkAssembly" 
            />
            <provider 
               id="null" 
               type="NullSinkProvider, SinkAssembly" 
            />
         </clientProviders>
      </channelSinkProviders>
      <debug loadTypes="true" />
   </system.runtime.remoting>
</configuration>

要件

構成ファイル : アプリケーション構成ファイル、コンピュータの構成ファイル (Machine.config)

関連項目

参照

リモート処理設定スキーマ
BinaryClientFormatterSink
SoapClientFormatterSink
BinaryServerFormatterSink
SoapServerFormatterSink

Copyright © 2007 by Microsoft Corporation.All rights reserved.