Message.CreateBufferedCopy(Int32) 方法

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.Primitives.dll

組件:

System.ServiceModel.dll

將整個 Message 儲存到記憶體緩衝區中，以供未來存取。

public:
 System::ServiceModel::Channels::MessageBuffer ^ CreateBufferedCopy(int maxBufferSize);

public System.ServiceModel.Channels.MessageBuffer CreateBufferedCopy (int maxBufferSize);

member this.CreateBufferedCopy : int -> System.ServiceModel.Channels.MessageBuffer

Public Function CreateBufferedCopy (maxBufferSize As Integer) As MessageBuffer

參數

maxBufferSize

Int32

要建立之緩衝區的大小上限。

傳回

MessageBuffer

新建立的 MessageBuffer 物件。

例外狀況

ArgumentOutOfRangeException

maxBufferSize小於零。

ObjectDisposedException

已關閉訊息。

InvalidOperationException

已複製、讀取或寫入訊息。

備註

Message 執行個體的本文只能存取或寫入一次。 如果要存取 Message 執行個體超過一次，您應該使用 MessageBuffer 類別，將整個 Message 執行個體完全儲存到記憶體中。 呼叫 MessageBuffer 執行個體的 CreateBufferedCopy，即可建構 Message 執行個體。

注意

如果 Version 相等於 None，這個方法便只會將訊息的本文 (而非整個訊息) 儲存到記憶體緩衝區中。