共用方式為

<wellknown> 項目 (用戶端執行個體)

  • 發行項

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

包含有關應用程式要使用的伺服器啟動 (已知) 物件之資訊。當用戶端使用 <wellknown> 項目時，父代 <client> 項目就不需要 url 屬性。這個項目可能出現在應用程式組態檔 (電腦組態檔) 中。

Schema Hierarchy

<configuration>
  <system.runtime.remoting> 項目
    <application> 項目
      <client> 項目
        <wellknown> 項目 (用戶端執行個體)

語法

<wellknown  
   url="url" 
   displayName="displayName" 
   type="type,assembly"
/>

屬性和元素

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

屬性

屬性 說明

type

必要屬性。

在用戶端上指定物件的完整型別名稱，以及型別實作的組件名稱。如果包含組件是在全域組件快取中，這個名稱包含版本、文化特性和公開金鑰 (Public Key) 資訊。

url

必要屬性。

指定伺服器啟動型別的完整 URL，包括物件統一資源識別元 (URI)。

displayName

選擇性屬性。

由.NET Framework 組態工具用來建立這個用戶端已註冊要呼叫的伺服器啟動物件清單。.NET Framework 遠端處理系統不使用這個屬性。

項目子系

無。

父項目

項目 說明

application

包含有關應用程式使用及公開遠端物件的資訊。

client

包含應用程式使用的物件。由於 url 屬性對用戶端啟動型別為必要項，但是對伺服器啟動型別則非必要項，因此每一個唯一的 URL 將會有自己的用戶端項目，包含在該位置所發行的用戶端啟動型別。

configuration

Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。

system.runtime.remoting

包含有關遠端物件和通道的資訊。

範例

下列組態檔宣告使用的伺服器啟動 (已知) 遠端型別，以及指定用戶端應用程式要使用 HttpChannel，但允許 .NET Framework 遠端處理系統代表用戶端尋找合適的通訊埠。

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

另請參閱

參考

遠端設定結構描述

概念

遠端物件的啟動過程

建置日期：2010-02-13