Bagikan melalui


MessageBuffer Kelas

Definisi

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
MessageBuffer
Penerapan

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 benar-benar menyimpan seluruh Message instans ke dalam memori.

Instans MessageBuffer dibangun dengan memanggil CreateBufferedCopyMessage instans. Yang baru MessageBuffer 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. Hal ini memungkinkan sumber daya sistem untuk berpotensi dikosongkan lebih cepat.

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

  • Masukkan kode pembersihan Anda di (On)(Begin)Close (dan/atau OnAbort), bukan dalam destruktor.

  • Hindari destruktor: pengompilasi menyebabkan pengompilasi dibuat secara otomatis IDisposable

  • Hindari anggota non-referensi: mereka dapat menyebabkan pengompilasi dibuat secara otomatis IDisposable

  • 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

MessageBuffer()

Menginisialisasi instans baru kelas MessageBuffer.

Properti

BufferSize

Mendapatkan perkiraan jumlah byte yang dikonsumsi oleh ini MessageBuffer.

MessageContentType

Mendapatkan tipe isi pesan yang disimpan dalam buffer ini.

Metode

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)

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

CreateNavigator(Int32, XmlSpace)

Membuat objek baru XPathNavigator untuk menavigasi objek ini, dengan navigator diposisikan pada simpul dan xml:space cakupan 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 instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(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

IDisposable.Dispose()

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

Berlaku untuk