<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" password="xyz" />
                     <endpoint url="contoso.com:9001" password="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 クラス