共用方式為

<channel> 項目 (樣板)

  • 發行項

本主題專門說明一項為了在現有應用程式中提供回溯相容性而保留的舊有技術，不建議用於新的開發工作。分散式應用程式應使用 Windows Communication Foundation (WCF) 進行開發。

包含應用程式可以指定及設定的通道樣板，以便與遠端物件的要求進行通訊，或接聽遠端物件的要求。通道可以註冊在任何位置上以供使用，而您可以將該執行個體通道項目的 id 屬性設定為這個樣板的 ref 屬性。這個項目可能出現在應用程式組態檔 (電腦組態檔) 中。

Schema Hierarchy

<configuration>
  <system.runtime.remoting> 項目
    <channels> 項目 (樣板)
      <channel> 項目 (樣板)

語法

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

屬性和元素

下列章節會說明屬性 (Attribute)、子項目和父項目。

屬性

屬性 說明

customChannelProperty

選擇性屬性。

指示支援的自訂通道屬性。您可以指定通道可能支援的任何通道屬性數量。自訂通道屬性可以是以屬性/值配組指定的。例如：

<channel id="CustomChannel" type="Namespace.CustomChannel, CustomChannels" customProperty="PropertyValue"/>

delayLoadAsClientChannel

選擇性屬性。

指示如果用戶端沒有為應用程式註冊通道，是否該載入這個通道。這個值為布林值，並且只會影響用戶端行為。true 值表示 .NET Framework 遠端處理應該在執行階段測試這個通道，檢查它是否支援用戶端連線 (其使用在遠端啟動過程 URL 中指定的特定通訊協定配置)。如果該值不存在，預設值為 false。

displayName

選擇性屬性。

由 .NET Framework 組態工具用來建立這個應用程式所使用的通道清單。.NET Framework 遠端處理系統不使用這個屬性。

id

必要屬性。

提供應用程式用來識別在註冊位置之通道的字串。若要參考這個通道樣板，在執行個體通道項目中將這個屬性指定為 ref 屬性的值。

項目子系

項目 說明

<serverProviders>

包含將插入伺服器端通道接收呼叫鏈結中的接收之接收提供者。如果有指定，這些會完全覆寫通道的預設值。這個項目可以在 <channel> 樣板項目中出現一次。

<clientProviders>

包含將插入用戶端通道接收呼叫鏈結中的接收之接收提供者。如果有指定，這些會完全覆寫通道的預設值。這個項目可以在 <channel> 樣板項目中出現一次。

父項目

項目 說明

channels

包含應用程式用來與遠端物件通訊的通道樣板。只要是已註冊通道的任何位置，就可以參考在此項目底下宣告的通道。

configuration

Common Language Runtime 和 .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>

另請參閱

參考

遠端設定結構描述
HttpChannel
HttpClientChannel
HttpServerChannel
TcpChannel
TcpClientChannel
TcpServerChannel

建置日期：2010-02-13