System.Runtime.Remoting 命名空間
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供類別和介面,讓開發人員建立和設定分散式應用程式。 System.Runtime.Remoting 命名空間較重要的類別為 RemotingConfiguration 類別、RemotingServices 類別,以及 ObjRef 類別。
類別
ActivatedClientTypeEntry |
存有物件型別的值,此物件型別在用戶端上登錄為可在伺服器上啟動的型別。 |
ActivatedServiceTypeEntry |
存有物件型別的值,此物件型別在服務端登錄為可依要求從用戶端啟動的型別。 |
InternalRemotingServices |
定義公用程式方法,供 .NET Framework 遠端基礎結構使用。 |
ObjectHandle |
包裝傳值封送處理的物件參考,並允許透過間接取值 (Indirection) 將它們傳回。 |
ObjRef |
儲存產生 Proxy 所需的所有相關資訊,以便與遠端物件通訊。 |
RemotingConfiguration |
提供各種靜態 (Static) 方法來設定遠端基礎結構。 |
RemotingException |
在遠端處理期間情形不對勁時所擲回的例外狀況。 |
RemotingServices |
提供使用和發行遠端物件和 Proxy 的一些方法。 此類別無法獲得繼承。 |
RemotingTimeoutException |
在一段事先指定的時間內無法連絡到伺服器或用戶端時所擲回的例外狀況。 |
ServerException |
向用戶端傳達錯誤的例外狀況,當用戶端連接至無法擲回例外狀況的非 .NET Framework 應用程式時,就會擲回這個例外狀況。 |
SoapServices |
提供了一些方法,以 SOAP 格式使用和發行遠端物件。 |
TypeEntry |
實作基底類別,以保存用來啟動遠端型別的執行個體的組態資訊。 |
WellKnownClientTypeEntry |
存有在用戶端登錄為伺服器啟動型別 (單一呼叫或單一物件) 之物件型別的值。 |
WellKnownServiceTypeEntry |
存有在服務端登錄為伺服器啟動型別物件 (單一呼叫或單一物件) 之物件型別的值。 |
介面
IChannelInfo |
提供隨附於 ObjRef 的自訂通道資訊。 |
IEnvoyInfo |
提供 Envoy 資訊。 |
IObjectHandle |
定義用以從間接取值 (Indirection) 來為傳值封送處理物件解開包裝的介面。 |
IRemotingTypeInfo |
提供物件的型別資訊。 |
列舉
CustomErrorsModes |
指定自訂錯誤的處理方式。 |
WellKnownObjectMode |
定義已知物件如何啟動。 |
備註
RemotingConfiguration類別包含靜態方法,可與設定進行介面互動。 RemotingConfiguration.Configure方法可讓開發人員透過使用 XML 格式化的設定檔來設定遠端基礎結構。 此 RemotingConfiguration 類別也包含數個方法,可供用戶端和伺服器端的用戶端和伺服器端已啟始物件在伺服器上進行用戶端和伺服器端的註冊。
RemotingServices類別提供數種方法,可協助您使用和發行遠端物件。 RemotingServices.Marshal方法會提供功能,以儲存在類別實例中啟用和與遠端物件進行通訊所需的所有相關資訊, ObjRef 以便稍後進行序列化並傳輸到遠端位置。 RemotingServices.Unmarshal方法會反轉這個進程,為遠端物件建立 proxy,讓應用程式可以使用,而不需考慮任何遠端細分。
ObjRef類別會保存啟用和與遠端物件通訊所需的所有相關資訊。 這個類別是物件的可序列化標記法,此物件會使用通道傳送至遠端位置,其中會使用通道來取消封送處理 (請參閱 Unmarshal) ,而且可以用來建立遠端物件的本機 proxy。
注意
傳址傳址物件 (Mbr) 不會無限地存放在記憶體中。 相反地,除非類型會覆寫 MarshalByRefObject.InitializeLifetimeService 來控制其本身的存留期原則,否則每個 MBR 在 .NET Framework 遠端系統開始執行刪除和回收記憶體的程式之前,都有有限的存留期。 如需詳細資訊,請參閱 存留期租用。