MessageBuffer.Close Метод

Определение

Пространство имен:

System.ServiceModel.Channels

Сборка:

System.ServiceModel.Primitives.dll

Пакет:

System.ServiceModel.Primitives v8.0.0

Исходный код:

MessageBuffer.cs

Завершает работу с буфером.

public:
 abstract void Close();

public abstract void Close ();

abstract member Close : unit -> unit

Public MustOverride Sub Close ()

Примеры

В следующем примере показано, как правильно закрыть буфер сообщения.

public void AfterReceiveReply(ref Message reply, object correlationState)  
{  
    // Create the buffer.
    MessageBuffer buffer = reply.CreateBufferedCopy(13000);  
    // Inspect the response (for example, extract the body contents).
    Message thisReply = buffer.CreateMessage();
    XmlDictionaryReader reader = thisReply.GetReaderAtBodyContents();
    var info = new StringBuilder();
    XmlWriter writer = XmlWriter.Create(info);  
    writer.WriteNode(reader, true);  
    writer.Close();  
    // Resolution:  Re-create the message from the buffer before  
    // closing.  
    reply = buffer.CreateMessage();  
    // You can close the buffer after the message has been recreated.  
    buffer.Close();
}

Комментарии

Следует всегда закрывать экземпляр класса MessageBuffer с помощью метода Close по окончании работы с этим объектом. Потенциально это позволяет освободить системные ресурсы быстрее.

После вызова метода CreateBufferedCopy для создания буфера сообщения и анализа сообщения с использованием метода CreateMessage при попытке закрытия буфера с помощью этого метода будет создано исключение InvalidOperationException. Чтобы избежать этой проблемы, необходимо повторно создать сообщение из буфера перед закрытием буфера. Пример кода см. в образце кода, предоставленном для предыдущего сценария.