SoapClientFormatterSinkProvider 類別

定義

命名空間:

System.Runtime.Remoting.Channels

組件:

System.Runtime.Remoting.dll

提供用戶端格式子 (Formatter) 接收提供者的實作。

public ref class SoapClientFormatterSinkProvider : System::Runtime::Remoting::Channels::IClientFormatterSinkProvider

public class SoapClientFormatterSinkProvider : System.Runtime.Remoting.Channels.IClientFormatterSinkProvider

type SoapClientFormatterSinkProvider = class
    interface IClientFormatterSinkProvider
    interface IClientChannelSinkProvider

Public Class SoapClientFormatterSinkProvider
Implements IClientFormatterSinkProvider

繼承

Object

SoapClientFormatterSinkProvider

實作

IClientChannelSinkProvider IClientFormatterSinkProvider

備註

會 SoapClientFormatterSinkProvider 建立用戶端格式器接收，用來 SoapFormatter 串行化遠端訊息流程之用戶端通道的訊息。

格式器接收的功能是產生所需的標頭，並序列化訊息到資料流。 到達格式器接收之後，會 IMessage 透過 ProcessMessage 或 AsyncProcessRequest 呼叫，將 轉送到通道接收鏈結中的所有接收。 在這個階段中，訊息已經串行化，且僅提供為資訊。 需要建立或修改訊息的接收必須放在接收鏈結中，格式器之前。 實作 IMessageSink 和 IClientChannelSink 介面即可達成此目的。 格式器接收稍後可以放在接收鏈結中。

格式器接收會使用接收組態屬性在運行時間設定通道。 接收屬性可以在 組態檔中指定，或以程序設計方式在 內部 IDictionary指定。 在組態檔中，所有值都是以字串表示，但在以程式設計方式建置屬性 IDictionary 時，可以使用其原生值或字串來指定實值型別。

下表顯示可指定給目前接收提供者的接收組態屬性。

屬性	描述
includeVersions	指定格式器是否將包含版本設定資訊。 true值為 或 false。

重要

搭配不受信任的數據或跨不安全通道使用這個對象的實例是安全性風險。 只搭配受信任的數據和跨安全通道使用此物件。 如需詳細資訊，請參閱 驗證所有輸入。

建構函式

SoapClientFormatterSinkProvider()	使用預設值，初始化 SoapClientFormatterSinkProvider 類別的新執行個體。
SoapClientFormatterSinkProvider(IDictionary, ICollection)	使用指定屬性和提供者資料，初始化 SoapClientFormatterSinkProvider 類別的新執行個體。

屬性

Next	取得或設定接收提供者鏈結中的下一個 IClientChannelSinkProvider。

方法

CreateSink(IChannelSender, String, Object)	建立接收鏈結。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• BinaryFormatter
• 通道和格式子組態屬性
• 接收與接收鏈結