Class StreamExtensions

Namespace

Cuemon.Extensions.Xml

Assembly

Cuemon.Extensions.Xml.dll

Extension methods for the Stream class.

public static class StreamExtensions

Inheritance

object

StreamExtensions

Methods

CopyXmlStream(Stream, Action<XmlWriterSettings>)

Copies the entire XML Stream following the output format of setup.

public static Stream CopyXmlStream(this Stream value, Action<XmlWriterSettings> setup = null)

Parameters

value Stream

The XML Stream to extend.

setup Action<XmlWriterSettings>

The XmlWriterSettings which may be configured.

Returns

Stream

A Stream that is equivalent to value following the output format of setup.

Exceptions

ArgumentNullException

value cannot be null.

RemoveXmlNamespaceDeclarations(Stream, Action<XmlWriterSettings>)

Remove the XML namespace declarations from the specified value.

public static Stream RemoveXmlNamespaceDeclarations(this Stream value, Action<XmlWriterSettings> setup = null)

Parameters

value Stream

The XML Stream to extend.

setup Action<XmlWriterSettings>

The XmlWriterSettings which may be configured.

Returns

Stream

A Stream object representing the specified value, but with no namespace declarations.

ToXmlReader(Stream, Encoding, Action<XmlReaderSettings>)

Converts the given value to an XmlReader.

public static XmlReader ToXmlReader(this Stream value, Encoding encoding = null, Action<XmlReaderSettings> setup = null)

Parameters

value Stream

The XML Stream to extend.

encoding Encoding

The text encoding to use.

setup Action<XmlReaderSettings>

The XmlReaderSettings which may be configured.

Returns

XmlReader

An XmlReader representation of value.

Remarks

If encoding is null, an Encoding object will be attempted resolved by TryDetectXmlEncoding(Stream, out Encoding).

Exceptions

ArgumentNullException

value cannot be null.

TryDetectXmlEncoding(Stream, out Encoding)

Tries to resolve the Encoding level of the XML document from the Stream.

public static bool TryDetectXmlEncoding(this Stream value, out Encoding result)

Parameters

value Stream

The XML Stream to extend.

result Encoding

When this method returns, it contains the Encoding value equivalent to the encoding level of the XML document contained in value, if the conversion succeeded, or a null reference (Nothing in Visual Basic) if the conversion failed. The conversion fails if the value parameter is null, does not contain BOM information or does not contain an XmlDeclaration.

Returns

bool

true if the value parameter was converted successfully; otherwise, false.

Exceptions

ArgumentNullException

value cannot be null.