Aracılığıyla paylaş


MessageBuffer Sınıf

Tanım

Gelecekteki tüketim için 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ı kullanmanız MessageBuffer gerekir.

ÖrnekMessageBuffer, bir Message örnek çağrılarak CreateBufferedCopy oluşturulur. Ardından 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 potansiyel olarak daha erken serbest olması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 (On)(Begin)Close (ve/veya OnAbort) içine yerleştirin.
  • Yıkıcılardan kaçının: derleyicinin otomatik olarak oluşturmasına IDisposableneden olurlar.
  • Başvuru olmayan üyelerden kaçının: derleyicinin otomatik olarak oluşturmasına IDisposableneden olabilirler.
  • 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ı (On)(Begin)Close (ve/veya OnAbort) öğesinden gizlemeniz gerekir.

Oluşturucular

Name Description
MessageBuffer()

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

Özellikler

Name Description
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

Name Description
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, XmlSpace)

Bu nesnede gezinmek için yeni bir XPathNavigator nesne oluşturur ve gezgin belirtilen düğümde ve xml:space kapsamda konumlandırılır.

CreateNavigator(Int32)

Bu nesnede gezinmek için yeni XPathNavigator bir nesne oluşturur ve gezgin belirtilen düğümde konumlandırılır.

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()

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

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

Geçerli Objectbasit bir kopyasını oluşturur.

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

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

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

Bu arabelleğin içeriğinin tamamını belirtilen GÇ akışına yazar.

Belirtik Arabirim Kullanımları

Name Description
IDisposable.Dispose()

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

Şunlara uygulanır