共用方式為

<wellknown> 項目 (服務執行個體)

  • 發行項

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

包含有關應用程式公開給用戶端的伺服器啟動 (已知) 物件之資訊。這個項目可能出現在應用程式組態檔 (電腦組態檔) 中。

Schema Hierarchy

<configuration>
  <system.runtime.remoting> 項目
    <application> 項目
      <service> 項目
        <wellknown> 項目 (服務執行個體)

語法

<wellknown  
   mode="Singleton|SingleCall"
   displayName="name"
   type="type,assembly" 
      objectUri="objectUri" 
/>

屬性和元素

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

屬性

屬性 說明

mode

必要屬性。

指示物件是 Singleton 或 SingleCall 物件。必須選取一個選項。如需詳細資訊，請參閱啟動過程。

objectUrl

必要屬性。

指定物件的統一資源識別元 (URI) 的端點。

type

必要屬性。

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

displayName

選擇性屬性。

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

項目子系

無。

父項目

項目 說明

application

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

configuration

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

service

包含應用程式公開給其他應用程式定義域或內容的物件。

system.runtime.remoting

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

備註

當物件裝載於網際網路資訊服務 (IIS) 時，objectUri 的副檔名必須是 .soap 或 .rem，以便將要求路由至 .NET Framework 遠端處理 IHttpHandler。

範例

下列組態檔宣告伺服器啟動 (已知) 型別、要在其中尋找該型別的物件 URI，以及控制執行個體啟動過程的 WellKnownObjectMode。

<configuration>
   <system.runtime.remoting>
      <application>
         <service>
            <wellknown 
               type="ServerActivatedType, RemoteAssembly" 
               objectUri="ServerType.rem" 
               mode="Singleton" 
            />
         </service>
      </application>
   </system.runtime.remoting>
</configuration>

另請參閱

參考

遠端設定結構描述

概念

遠端物件的啟動過程
遠端應用程式的組態

建置日期：2010-02-13