MessageBuffer Kelas

Definisi

Ruang nama:

System.ServiceModel.Channels

Rakitan:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v6.2.0

Sumber:

MessageBuffer.cs

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

public ref class MessageBuffer abstract : IDisposable

public abstract class MessageBuffer : IDisposable

type MessageBuffer = class
    interface IDisposable

Public MustInherit Class MessageBuffer
Implements IDisposable

Warisan

Object

MessageBuffer

Penerapan

IDisposable

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.
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.