<channel> 項目 (執行個體)

發行項
01/04/2008

設定應用程式用來與遠端物件通訊的通道。您也可以宣告及設定不是通道樣板的新通道。

<system.runtime.remoting> 項目

<application> 項目

<channels> 項目 (執行個體)

<channel> 項目 (執行個體)

<!-- Either reference a channel template --> 
<channel  
   ref="channelRef" 
   displayName="name"
   port="port"
/>
<!-- Or declare a particular channel instance -->
<channel 
   type="ChannelType, ChannelAssembly"
   displayName="name"
   port="port"
   customChannelProperty="propertyValue"
/>

屬性和項目

下列章節將說明屬性、子項目和父項目。

屬性

屬性	說明
ref	選擇性屬性。指示您用戶端打算用來註冊的通道樣板 id。如果指定 ref 屬性，則不需要指定 type 屬性。 .NET Framework 遠端處理提供三種通道實作："http"、"tcp" 和 "ipc"。如需選擇通道實作的詳細資訊，請參閱選擇通道。
displayName	選擇性屬性。由 .NET Framework 組態工具用來建立這個應用程式已註冊的通道清單。.NET Framework 遠端處理系統不使用這個屬性。
type	選擇性屬性。指示通道的完整型別名稱和通道實作所在的組件名稱。如果包含組件是在全域組件快取中，這個名稱包含任何版本、文化特性 (Culture) 和公開金鑰資訊。如果您沒有使用 ref 屬性，則這個屬性為必要項。 .NET Framework 遠端處理提供三種通道實作："http"、"tcp" 和 "ipc"。如需選擇通道實作的詳細資訊，請參閱選擇通道。
port	選擇性屬性。指示合適的通訊埠屬性。例如，如果您想要通道接聽連接埠，可以指定連接埠屬性。某些通道，如 TcpChannel，需要連接埠規格。其他通道，如 HttpChannel，有預設的連接埠，所以不需要這個屬性。如果您是建立用戶端，而且指定 0 (零) 做為連接埠，則 .NET Framework 遠端處理系統將會為您選擇合適的連接埠。如果您沒有為用戶端通道指定連接埠，那麼用戶端將無法從遠端物件接收回呼函式。
portName	IpcChannel 或 IpcServerChannel 的必要屬性。指定伺服器將會公開的連接埠名稱。
<customChannelProperty>	選擇性屬性。指示支援的自訂通道屬性。您可以指定通道可能支援的任何通道屬性數量。自訂通道屬性可以是以屬性/值配組指定的。例如： `<channel ref="CustomChannel" port="61000" customProperty="PropertyValue" />`
useIpAddress	布林值 (true 或 false)，指定在發行集 URL 中是否使用 IP 位址來取代電腦名稱。例如，無線網路在通過網路時，通常會將可攜式電腦的 IP 位址移動。將這個值指定為 false 將造成使用電腦名稱而不使用位址，因此在漫遊時，遠端通訊將不會中斷連接。預設為 true。當搭配伺服器通道使用 machineName 屬性時，該屬性會覆寫此值。
machineName	指定與目前通道共用的電腦名稱的字串。如果搭配伺服器通道使用，則會覆寫 useIpAddress。注意：一般而言，使用電腦的網域名稱系統 (DNS) 名稱是個好主意，但若是特定網路介面卡 (NIC) (通常是無線 NIC) 的 IP 位址會快速變更，您就必須將應用程式設定成使用 machineName，以啟用遠端處理透過 DNS 來找尋電腦。但是，當電腦名稱不是以合理的速度進行解析 (或完全不合理)，且電腦有一個以上的 NIC 時，不論是實體或虛擬 (在撥號連線或 VPN 網路介面卡時通常是後者)，您都應該將 machineName 屬性設定為目前供連線使用的 NIC 的 IP 位址。

子項目

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

父項目

項目	說明
application	包含應用程式使用和公開之遠端物件的相關資訊。
channels	包含應用程式用來與遠端物件通訊的通道。這個項目設定通道樣板，或宣告與指定應用程式一起使用的新通道。
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.runtime.remoting	包含有關遠端物件和通道的資訊。

備註

系統提供的 HttpChannel、TcpChannel 和 IpcChannel 都是在電腦組態檔中指定的。它們的 id 屬性分別是 "http"、"tcp" 和 "ipc"。

範例

下列組態檔為用戶端應用程式宣告遠端型別的位置，並且使用 <channels> 執行個體項目來指定 .NET Framework 遠端處理系統應該從要連接到伺服器物件的來源尋找合適的連接埠，以及應該使用預設的 HttpChannel。

<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>

請參閱

參考

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

Footer image

共用方式為

<channel> 項目 (執行個體)

屬性和項目

屬性

子項目

父項目

備註

範例

請參閱

參考

其他資源