Message.GetReaderAtBodyContents Method

Definition

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the XML dictionary reader that accesses the body content of this message.

C#
public System.Xml.XmlDictionaryReader GetReaderAtBodyContents();

Returns

A XmlDictionaryReader object that accesses the body content of this message.

Exceptions

The message is closed.

The message is empty, or has been copied, read or written.

Remarks

A Message instance has a body that corresponds to the SOAP body. It can be accessed as an XmlDictionaryReader by calling GetReaderAtBodyContents. It is initially positioned directly after the <S:Body> element. Alternatively, if you expect the body to contain a serialized object, you can call GetBody instead. You should be aware that a message body can only be accessed once and a message can only be written once. If you want to access the body multiple times, use CreateBufferedCopy to create a MessageBuffer instance.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (package-provided)
UWP 10.0