MessageBuffer Sınıf

Tanım

Gelecekte kullanılmak üzere iletinin tamamını depolayan bir bellek arabelleği temsil eder.

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
Devralma
MessageBuffer
Uygulamalar

Açıklamalar

Bir örneğin gövdesi yalnızca bir Message kez kullanılabilir veya yazılabilir. Bir Message örneği birden çok kez kullanmak istiyorsanız, bir örneğin tamamını Message belleğe depolamak için sınıfını MessageBuffer kullanmanız gerekir.

ÖrnekMessageBuffer, bir Message örnek çağrılarak CreateBufferedCopy oluşturulur. Daha sonra yeni MessageBuffer bir oluşturulur ve döndürülür; bu, öğesinin sahipliğini Message varsayar ve tüm içeriği belleğe okur.

dosyasından MessageBufferbir Message kopyasını almak için yöntemini MessageBufferçağırmanız CreateMessage gerekir. Bu, sağladığınız özgün Message örneğin özdeş bir kopyasını döndürür.

İstediğiniz bayt sayısı üst sınırına ayarlayarak BufferSize arabellek boyutunun üst sınırını denetleyebilirsiniz. Bu sayı, arabelleğin oluşturulmasıyla ilgili geçici ayırmaları veya iletiye eklenen özellikleri kapsamaz.

Bir örneği çalışmayı bitirdiğinizde her zaman çağırarak Close kapatmalısınızMessageBuffer. Bu, sistem kaynaklarının daha erken boşaltılmasını sağlar.

Bu sınıftan türetilen Yönetilen C++ kullanıcıları için özel not:

  • Temizleme kodunuzu bir yıkıcıya değil (Açık)(Başlangıç)Close (ve/veya OnAbort) içine yerleştirin.

  • Yıkıcılardan kaçının: derleyicinin otomatik olarak oluşturmasına neden olurlar IDisposable

  • Başvuru olmayan üyelerden kaçının: derleyicinin otomatik olarak oluşturmasına neden olabilirler IDisposable

  • Sonlandırıcılardan kaçının; ancak bir tane eklerseniz, otomatik olarak oluşturulan IDisposable davranışa öykünmek için derleme uyarısını ve çağrısını SuppressFinalize(Object) ve sonlandırıcıyı (Açık)(Başlangıç)Kapat (ve/veya OnAbort) öğesinden gizlemeniz gerekir.

Oluşturucular

MessageBuffer()

MessageBuffer sınıfının yeni bir örneğini başlatır.

Özellikler

BufferSize

Bu MessageBuffertarafından tüketilen yaklaşık bayt sayısını alır.

MessageContentType

Bu arabellekte depolanan ileti içeriğinin türünü alır.

Yöntemler

Close()

Arabellekle çalışmayı tamamlar.

CreateMessage()

Özgün iletinin bir kopyasını döndürür.

CreateNavigator()

Bu nesnede gezinmek için yeni XPathNavigator bir nesne oluşturur. Bu yöntem devralınamaz.

CreateNavigator(Int32)

Gezgin belirtilen düğümde konumlandırılmış şekilde bu nesnede gezinmek için yeni XPathNavigator bir nesne oluşturur.

CreateNavigator(Int32, XmlSpace)

Gezgin belirtilen düğümde ve xml:space kapsamda konumlandırılmış şekilde bu nesnede gezinmek için yeni XPathNavigator bir nesne oluşturur.

CreateNavigator(XmlSpace)

Belirtilen xml:space kapsamla bu nesnede gezinmek için yeni XPathNavigator bir nesne oluşturur.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
WriteMessage(Stream)

Bu arabelleğin tüm içeriğini belirtilen GÇ akışına yazar.

Belirtik Arabirim Kullanımları

IDisposable.Dispose()

MessageBuffer tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. Bu yöntem devralınamaz.

Şunlara uygulanır