Bagikan melalui

MessageBuffer Kelas

Definisi

Ruang nama:
System.ServiceModel.Channels
Rakitan:
System.ServiceModel.dll, System.ServiceModel.Primitives.dll
Rakitan:
System.ServiceModel.Primitives.dll
Rakitan:
System.ServiceModel.dll
Paket:
System.ServiceModel.Primitives v10.0.652802
Sumber:
MessageBuffer.cs
Sumber:
MessageBuffer.cs
Sumber:
MessageBuffer.cs

Mewakili buffer memori yang menyimpan seluruh pesan untuk konsumsi di masa mendatang.

public ref class MessageBuffer abstract : IDisposable
public ref class MessageBuffer abstract : IDisposable, System::Xml::XPath::IXPathNavigable
public abstract class MessageBuffer : IDisposable
public abstract class MessageBuffer : IDisposable, System.Xml.XPath.IXPathNavigable
type MessageBuffer = class
    interface IDisposable
type MessageBuffer = class
    interface IXPathNavigable
    interface IDisposable
Public MustInherit Class MessageBuffer
Implements IDisposable
Public MustInherit Class MessageBuffer
Implements IDisposable, IXPathNavigable
Warisan
Object
MessageBuffer
Penerapan
IDisposable IXPathNavigable

Keterangan

Isi Message instans hanya dapat dikonsumsi atau ditulis sekali. Jika Anda ingin menggunakan Message instans lebih dari sekali, Anda harus menggunakan MessageBuffer kelas untuk sepenuhnya menyimpan seluruh Message instans ke dalam memori.

Instans MessageBuffer dibangun dengan memanggil CreateBufferedCopyMessage instans. MessageBuffer Baru kemudian dibuat dan dikembalikan, yang mengasumsikan kepemilikan Message dan membaca seluruh konten ke dalam memori.

Untuk mengambil salinan Message dari MessageBuffer, Anda harus memanggil CreateMessage metode MessageBuffer. Ini mengembalikan salinan identik dari instans asli Message yang Anda berikan.

Anda dapat mengontrol ukuran maksimum buffer dengan mengatur BufferSize ke jumlah maksimum byte yang diinginkan. Angka ini tidak selalu mencakup alokasi sementara yang terkait dengan pembangunan buffer, atau properti yang dilampirkan ke pesan.

Anda harus selalu menutup MessageBuffer instans dengan memanggil Close ketika selesai bekerja dengannya. Ini memungkinkan sumber daya sistem berpotensi dibebaskan lebih cepat.

Catatan khusus untuk pengguna C++ Terkelola yang berasal dari kelas ini:

  • Masukkan kode pembersihan Anda di (Aktif)(Mulai)Tutup (dan/atau OnAbort), bukan di destruktor.
  • Hindari destruktor: pengompilasi menyebabkan pengompilasi dibuat IDisposablesecara otomatis .
  • Hindari anggota non-referensi: mereka dapat menyebabkan pengompilasi menghasilkan IDisposablesecara otomatis .
  • Hindari finalizer; tetapi jika Anda menyertakannya, Anda harus menekan peringatan build dan panggilan SuppressFinalize(Object) dan finalizer itu sendiri dari (On)(Begin)Close (dan/atau OnAbort) untuk meniru apa yang akan menjadi perilaku yang dihasilkan IDisposable secara otomatis.

Konstruktor

Nama Deskripsi
MessageBuffer()

Menginisialisasi instans baru dari kelas MessageBuffer.

Properti

Nama Deskripsi
BufferSize

Mendapatkan perkiraan jumlah byte yang dikonsumsi oleh ini MessageBuffer.
MessageContentType

Mendapatkan tipe isi pesan yang disimpan dalam buffer ini.

Metode

Nama Deskripsi
Close()

Selesai bekerja dengan buffer.
CreateMessage()

Mengembalikan salinan pesan asli.
CreateNavigator()

Membuat objek baru XPathNavigator untuk menavigasi objek ini. Metode ini tidak dapat diwariskan.
CreateNavigator(Int32, XmlSpace)

Membuat objek baru XPathNavigator untuk menavigasi objek ini, dengan navigator diposisikan pada simpul dan xml:space cakupan yang ditentukan.
CreateNavigator(Int32)

Membuat objek baru XPathNavigator untuk menavigasi objek ini, dengan navigator diposisikan pada simpul yang ditentukan.
CreateNavigator(XmlSpace)

Membuat objek baru XPathNavigator untuk menavigasi objek ini, dengan cakupan yang ditentukan xml:space .
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)
WriteMessage(Stream)

Menulis seluruh konten buffer ini ke aliran IO yang ditentukan.

Implementasi Antarmuka Eksplisit

Nama Deskripsi
IDisposable.Dispose()

Merilis sumber daya yang tidak dikelola yang MessageBuffer digunakan oleh dan secara opsional merilis sumber daya terkelola. Metode ini tidak dapat diwariskan.

Berlaku untuk