Inherits System::Xml::XmlReader, System::Xml::IXmlLineInfo, and System::Xml::IXmlNamespaceResolver.

Public Types
using	Ptr = SharedPtr< XmlTextReader >
	An alias for shared pointer to an instance of this class. More...

Public Types inherited from System::Xml::XmlReader
using	Ptr = SharedPtr< XmlReader >
	An alias for shared pointer to an instance of this class. More...

Public Types inherited from System::Object
typedef SmartPtr< Object >	ptr
	Alias for smart pointer type. More...

Public Member Functions
ASPOSECPP_SHARED_API XmlNodeType	get_NodeType () override

ASPOSECPP_SHARED_API String	get_Name () override

ASPOSECPP_SHARED_API String	get_LocalName () override

ASPOSECPP_SHARED_API String	get_NamespaceURI () override

ASPOSECPP_SHARED_API String	get_Prefix () override

ASPOSECPP_SHARED_API bool	get_HasValue () override

ASPOSECPP_SHARED_API String	get_Value () override

ASPOSECPP_SHARED_API int32_t	get_Depth () override

ASPOSECPP_SHARED_API String	get_BaseURI () override

ASPOSECPP_SHARED_API bool	get_IsEmptyElement () override

ASPOSECPP_SHARED_API bool	get_IsDefault () override

ASPOSECPP_SHARED_API char16_t	get_QuoteChar () override

ASPOSECPP_SHARED_API System::Xml::XmlSpace	get_XmlSpace () override

ASPOSECPP_SHARED_API String	get_XmlLang () override

ASPOSECPP_SHARED_API int32_t	get_AttributeCount () override

ASPOSECPP_SHARED_API bool	get_EOF () override

ASPOSECPP_SHARED_API System::Xml::ReadState	get_ReadState () override

ASPOSECPP_SHARED_API SharedPtr< XmlNameTable >	get_NameTable () override

ASPOSECPP_SHARED_API bool	get_CanResolveEntity () override

ASPOSECPP_SHARED_API bool	get_CanReadBinaryContent () override

ASPOSECPP_SHARED_API bool	get_CanReadValueChunk () override

ASPOSECPP_SHARED_API int32_t	get_LineNumber () override

ASPOSECPP_SHARED_API int32_t	get_LinePosition () override

ASPOSECPP_SHARED_API bool	get_Namespaces ()

ASPOSECPP_SHARED_API void	set_Namespaces (bool value)

ASPOSECPP_SHARED_API bool	get_Normalization ()

ASPOSECPP_SHARED_API void	set_Normalization (bool value)

ASPOSECPP_SHARED_API SharedPtr< System::Text::Encoding >	get_Encoding ()

ASPOSECPP_SHARED_API System::Xml::WhitespaceHandling	get_WhitespaceHandling ()

ASPOSECPP_SHARED_API void	set_WhitespaceHandling (System::Xml::WhitespaceHandling value)

ASPOSECPP_SHARED_API bool	get_ProhibitDtd ()

ASPOSECPP_SHARED_API void	set_ProhibitDtd (bool value)

ASPOSECPP_SHARED_API System::Xml::DtdProcessing	get_DtdProcessing ()

ASPOSECPP_SHARED_API void	set_DtdProcessing (System::Xml::DtdProcessing value)

ASPOSECPP_SHARED_API System::Xml::EntityHandling	get_EntityHandling ()

ASPOSECPP_SHARED_API void	set_EntityHandling (System::Xml::EntityHandling value)

ASPOSECPP_SHARED_API void	set_XmlResolver (const SharedPtr< System::Xml::XmlResolver > &value)

ASPOSECPP_SHARED_API	XmlTextReader (const SharedPtr< IO::Stream > &input)

ASPOSECPP_SHARED_API	XmlTextReader (const String &url, const SharedPtr< IO::Stream > &input)

ASPOSECPP_SHARED_API	XmlTextReader (const SharedPtr< IO::Stream > &input, const SharedPtr< XmlNameTable > &nt)

ASPOSECPP_SHARED_API	XmlTextReader (const String &url, const SharedPtr< IO::Stream > &input, const SharedPtr< XmlNameTable > &nt)

ASPOSECPP_SHARED_API	XmlTextReader (const SharedPtr< IO::TextReader > &input)

ASPOSECPP_SHARED_API	XmlTextReader (const String &url, const SharedPtr< IO::TextReader > &input)

ASPOSECPP_SHARED_API	XmlTextReader (const SharedPtr< IO::TextReader > &input, const SharedPtr< XmlNameTable > &nt)

ASPOSECPP_SHARED_API	XmlTextReader (const String &url, const SharedPtr< IO::TextReader > &input, const SharedPtr< XmlNameTable > &nt)

ASPOSECPP_SHARED_API	XmlTextReader (const SharedPtr< IO::Stream > &xmlFragment, XmlNodeType fragType, const SharedPtr< XmlParserContext > &context)

ASPOSECPP_SHARED_API	XmlTextReader (const String &xmlFragment, XmlNodeType fragType, const SharedPtr< XmlParserContext > &context)

ASPOSECPP_SHARED_API	XmlTextReader (const String &url)

ASPOSECPP_SHARED_API	XmlTextReader (const String &url, const SharedPtr< XmlNameTable > &nt)

ASPOSECPP_SHARED_API String	GetAttribute (String name) override

ASPOSECPP_SHARED_API String	GetAttribute (String localName, String namespaceURI) override

ASPOSECPP_SHARED_API String	GetAttribute (int32_t i) override

ASPOSECPP_SHARED_API bool	MoveToAttribute (String name) override

ASPOSECPP_SHARED_API bool	MoveToAttribute (String localName, String namespaceURI) override

ASPOSECPP_SHARED_API void	MoveToAttribute (int32_t i) override

ASPOSECPP_SHARED_API bool	MoveToFirstAttribute () override

ASPOSECPP_SHARED_API bool	MoveToNextAttribute () override

ASPOSECPP_SHARED_API bool	MoveToElement () override

ASPOSECPP_SHARED_API bool	ReadAttributeValue () override

ASPOSECPP_SHARED_API bool	Read () override

ASPOSECPP_SHARED_API void	Close () override
	Changes the XmlReader::get_ReadState to `Closed`. More...

ASPOSECPP_SHARED_API void	Skip () override
	Skips the children of the current node. More...

ASPOSECPP_SHARED_API String	LookupNamespace (const String &prefix) override

ASPOSECPP_SHARED_API void	ResolveEntity () override
	Resolves the entity reference for `EntityReference` nodes. More...

ASPOSECPP_SHARED_API int32_t	ReadContentAsBase64 (ArrayPtr< uint8_t > buffer, int32_t index, int32_t count) override

ASPOSECPP_SHARED_API int32_t	ReadElementContentAsBase64 (ArrayPtr< uint8_t > buffer, int32_t index, int32_t count) override

ASPOSECPP_SHARED_API int32_t	ReadContentAsBinHex (ArrayPtr< uint8_t > buffer, int32_t index, int32_t count) override

ASPOSECPP_SHARED_API int32_t	ReadElementContentAsBinHex (ArrayPtr< uint8_t > buffer, int32_t index, int32_t count) override

ASPOSECPP_SHARED_API String	ReadString () override

ASPOSECPP_SHARED_API bool	HasLineInfo () override

ASPOSECPP_SHARED_API SharedPtr< Collections::Generic::IDictionary< String, String > >	GetNamespacesInScope (XmlNamespaceScope scope) override

ASPOSECPP_SHARED_API void	ResetState ()

ASPOSECPP_SHARED_API SharedPtr< IO::TextReader >	GetRemainder ()

ASPOSECPP_SHARED_API int32_t	ReadChars (const ArrayPtr< char16_t > &buffer, int32_t index, int32_t count)

ASPOSECPP_SHARED_API int32_t	ReadBase64 (const ArrayPtr< uint8_t > &array, int32_t offset, int32_t len)

ASPOSECPP_SHARED_API int32_t	ReadBinHex (const ArrayPtr< uint8_t > &array, int32_t offset, int32_t len)

Public Member Functions inherited from System::Xml::XmlReader
virtual ASPOSECPP_SHARED_API SharedPtr< XmlReaderSettings >	get_Settings ()

virtual ASPOSECPP_SHARED_API SharedPtr< Schema::IXmlSchemaInfo >	get_SchemaInfo ()

virtual ASPOSECPP_SHARED_API TypeInfo	get_ValueType ()

virtual ASPOSECPP_SHARED_API bool	get_HasAttributes ()

virtual ASPOSECPP_SHARED_API SharedPtr< Object >	ReadContentAsObject ()

virtual ASPOSECPP_SHARED_API bool	ReadContentAsBoolean ()

virtual ASPOSECPP_SHARED_API DateTime	ReadContentAsDateTime ()

virtual ASPOSECPP_SHARED_API DateTimeOffset	ReadContentAsDateTimeOffset ()

virtual ASPOSECPP_SHARED_API double	ReadContentAsDouble ()

virtual ASPOSECPP_SHARED_API float	ReadContentAsFloat ()

virtual ASPOSECPP_SHARED_API Decimal	ReadContentAsDecimal ()

virtual ASPOSECPP_SHARED_API int32_t	ReadContentAsInt ()

virtual ASPOSECPP_SHARED_API int64_t	ReadContentAsLong ()

virtual ASPOSECPP_SHARED_API String	ReadContentAsString ()

virtual ASPOSECPP_SHARED_API SharedPtr< Object >	ReadContentAs (const TypeInfo &returnType, SharedPtr< IXmlNamespaceResolver > namespaceResolver)

virtual ASPOSECPP_SHARED_API SharedPtr< Object >	ReadElementContentAsObject ()

virtual ASPOSECPP_SHARED_API SharedPtr< Object >	ReadElementContentAsObject (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API bool	ReadElementContentAsBoolean ()

virtual ASPOSECPP_SHARED_API bool	ReadElementContentAsBoolean (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API DateTime	ReadElementContentAsDateTime ()

virtual ASPOSECPP_SHARED_API DateTime	ReadElementContentAsDateTime (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API double	ReadElementContentAsDouble ()

virtual ASPOSECPP_SHARED_API double	ReadElementContentAsDouble (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API float	ReadElementContentAsFloat ()

virtual ASPOSECPP_SHARED_API float	ReadElementContentAsFloat (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API Decimal	ReadElementContentAsDecimal ()

virtual ASPOSECPP_SHARED_API Decimal	ReadElementContentAsDecimal (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API int32_t	ReadElementContentAsInt ()

virtual ASPOSECPP_SHARED_API int32_t	ReadElementContentAsInt (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API int64_t	ReadElementContentAsLong ()

virtual ASPOSECPP_SHARED_API int64_t	ReadElementContentAsLong (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API String	ReadElementContentAsString ()

virtual ASPOSECPP_SHARED_API String	ReadElementContentAsString (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API SharedPtr< Object >	ReadElementContentAs (const TypeInfo &returnType, SharedPtr< IXmlNamespaceResolver > namespaceResolver)

virtual ASPOSECPP_SHARED_API SharedPtr< Object >	ReadElementContentAs (const TypeInfo &returnType, SharedPtr< IXmlNamespaceResolver > namespaceResolver, String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API String	idx_get (int32_t i)

virtual ASPOSECPP_SHARED_API String	idx_get (String name)

virtual ASPOSECPP_SHARED_API String	idx_get (String name, String namespaceURI)

virtual ASPOSECPP_SHARED_API int32_t	ReadValueChunk (ArrayPtr< char16_t > buffer, int32_t index, int32_t count)

virtual ASPOSECPP_SHARED_API XmlNodeType	MoveToContent ()

virtual ASPOSECPP_SHARED_API void	ReadStartElement ()

virtual ASPOSECPP_SHARED_API void	ReadStartElement (String name)

virtual ASPOSECPP_SHARED_API void	ReadStartElement (String localname, String ns)

virtual ASPOSECPP_SHARED_API String	ReadElementString ()

virtual ASPOSECPP_SHARED_API String	ReadElementString (String name)

virtual ASPOSECPP_SHARED_API String	ReadElementString (String localname, String ns)

virtual ASPOSECPP_SHARED_API void	ReadEndElement ()

virtual ASPOSECPP_SHARED_API bool	IsStartElement ()

virtual ASPOSECPP_SHARED_API bool	IsStartElement (String name)

virtual ASPOSECPP_SHARED_API bool	IsStartElement (String localname, String ns)

virtual ASPOSECPP_SHARED_API bool	ReadToFollowing (String name)

virtual ASPOSECPP_SHARED_API bool	ReadToFollowing (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API bool	ReadToDescendant (String name)

virtual ASPOSECPP_SHARED_API bool	ReadToDescendant (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API bool	ReadToNextSibling (String name)

virtual ASPOSECPP_SHARED_API bool	ReadToNextSibling (String localName, String namespaceURI)

virtual ASPOSECPP_SHARED_API String	ReadInnerXml ()

virtual ASPOSECPP_SHARED_API String	ReadOuterXml ()

virtual ASPOSECPP_SHARED_API SharedPtr< XmlReader >	ReadSubtree ()

ASPOSECPP_SHARED_API void	Dispose () override
	Releases all resources used by the current instance of the XmlReader class. More...

Public Member Functions inherited from System::Object
ASPOSECPP_SHARED_API	Object ()
	Creates object. Initializes all internal data structures. More...

virtual ASPOSECPP_SHARED_API	~Object ()
	Destroys object. Frees all internal data structures. More...

ASPOSECPP_SHARED_API	Object (Object const &x)
	Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...

Object &	operator= (Object const &x)
	Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...

Object *	SharedRefAdded ()
	Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

int	SharedRefRemovedSafe ()
	Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

int	RemovedSharedRefs (int count)
	Decreases shared reference count by specified value. More...

Detail::SmartPtrCounter *	WeakRefAdded ()
	Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

void	WeakRefRemoved ()
	Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...

Detail::SmartPtrCounter *	GetCounter ()
	Gets reference counter data structure associated with the object. More...

int	SharedCount () const
	Gets current value of shared reference counter. More...

ASPOSECPP_SHARED_API void	Lock ()
	Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...

ASPOSECPP_SHARED_API void	Unlock ()
	Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...

virtual ASPOSECPP_SHARED_API bool	Equals (ptr obj)
	Compares objects using C# Object.Equals semantics. More...

virtual ASPOSECPP_SHARED_API int32_t	GetHashCode () const
	Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...

virtual ASPOSECPP_SHARED_API String	ToString () const
	Analog of C# Object.ToString() method. Enables converting custom objects to string. More...

virtual ASPOSECPP_SHARED_API ptr	MemberwiseClone () const
	Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...

virtual ASPOSECPP_SHARED_API const TypeInfo &	GetType () const
	Gets actual type of object. Analog of C# System.Object.GetType() call. More...

virtual ASPOSECPP_SHARED_API bool	Is (const TypeInfo &targetType) const
	Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...

virtual ASPOSECPP_SHARED_API void	SetTemplateWeakPtr (uint32_t argument)
	Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...

virtual ASPOSECPP_SHARED_API bool	FastCast (const Details::FastRttiBase &helper, void **out_ptr) const
	For internal purposes only. More...

template<>
bool	Equals (float const &objA, float const &objB)

template<>
bool	Equals (double const &objA, double const &objB)

template<>
bool	ReferenceEquals (String const &str, std::nullptr_t)

template<>
bool	ReferenceEquals (String const &str1, String const &str2)

Additional Inherited Members
Static Public Member Functions inherited from System::Xml::XmlReader
static ASPOSECPP_SHARED_API bool	IsName (const String &str)

static ASPOSECPP_SHARED_API bool	IsNameToken (const String &str)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const String &inputUri)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const String &inputUri, const SharedPtr< XmlReaderSettings > &settings)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const String &inputUri, SharedPtr< XmlReaderSettings > settings, const SharedPtr< XmlParserContext > &inputContext)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const SharedPtr< IO::Stream > &input)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const SharedPtr< IO::Stream > &input, const SharedPtr< XmlReaderSettings > &settings)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const SharedPtr< IO::Stream > &input, SharedPtr< XmlReaderSettings > settings, const String &baseUri)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const SharedPtr< IO::Stream > &input, SharedPtr< XmlReaderSettings > settings, const SharedPtr< XmlParserContext > &inputContext)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const SharedPtr< IO::TextReader > &input)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const SharedPtr< IO::TextReader > &input, const SharedPtr< XmlReaderSettings > &settings)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const SharedPtr< IO::TextReader > &input, SharedPtr< XmlReaderSettings > settings, const String &baseUri)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const SharedPtr< IO::TextReader > &input, SharedPtr< XmlReaderSettings > settings, const SharedPtr< XmlParserContext > &inputContext)

static ASPOSECPP_SHARED_API SharedPtr< XmlReader >	Create (const SharedPtr< XmlReader > &reader, SharedPtr< XmlReaderSettings > settings)

Static Public Member Functions inherited from System::Object
static bool	ReferenceEquals (ptr const &objA, ptr const &objB)
	Compares objects by reference. More...

template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type	ReferenceEquals (T const &objA, T const &objB)
	Compares objects by reference. More...

template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type	ReferenceEquals (T const &objA, std::nullptr_t)
	Reference-compares value type object with nullptr. More...

template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type	Equals (T1 const &objA, T2 const &objB)
	Compares reference type objects in C# style. More...

template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type	Equals (T1 const &objA, T2 const &objB)
	Compares value type objects in C# style. More...

static const TypeInfo &	Type ()
	Implements C# typeof(System.Object) construct. More...

Detailed Description

Represents a reader that provides fast, non-cached, forward-only access to XML data.

Remarks: It is recommended to use the XmlReader class instead.

Attention: Objects of this class should only be allocated using System::MakeObject() function. Never create instances of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument.

Member Typedef Documentation

◆ Ptr

using System::Xml::XmlTextReader::Ptr = SharedPtr<XmlTextReader>

An alias for shared pointer to an instance of this class.

Constructor & Destructor Documentation

◆ XmlTextReader() [1/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader ( const SharedPtr< IO::Stream > & input )

Initializes a new instance of the XmlTextReader class with the specified stream.

Parameters

input The stream containing the XML data to read.

Exceptions

ArgumentNullException input is nullptr.

◆ XmlTextReader() [2/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader	(	const String &	url,
		const SharedPtr< IO::Stream > &	input
	)

Initializes a new instance of the XmlTextReader class with the specified URL and stream.

Parameters

url	The URL to use for resolving external resources. The XmlTextReader::get_BaseURI is set to this value.
input	The stream containing the XML data to read.

Exceptions

ArgumentNullException input is nullptr.

◆ XmlTextReader() [3/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader	(	const SharedPtr< IO::Stream > &	input,
		const SharedPtr< XmlNameTable > &	nt
	)

Initializes a new instance of the XmlTextReader class with the specified stream and XmlNameTable.

Parameters

input	The stream containing the XML data to read.
nt	The XmlNameTable to use.

Exceptions

NullReferenceException The input or nt value is nullptr.

◆ XmlTextReader() [4/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader	(	const String &	url,
		const SharedPtr< IO::Stream > &	input,
		const SharedPtr< XmlNameTable > &	nt
	)

Initializes a new instance of the XmlTextReader class with the specified URL, stream and XmlNameTable.

Parameters

url	The URL to use for resolving external resources. The XmlTextReader::get_BaseURI is set to this value. If `url` is `nullptr`, `BaseURI` is set to String::Empty.
input	The stream containing the XML data to read.
nt	The XmlNameTable to use.

Exceptions

NullReferenceException The input or nt value is nullptr.

◆ XmlTextReader() [5/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader ( const SharedPtr< IO::TextReader > & input )

Initializes a new instance of the XmlTextReader class with the specified TextReader.

Parameters

input The TextReader containing the XML data to read.

◆ XmlTextReader() [6/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader	(	const String &	url,
		const SharedPtr< IO::TextReader > &	input
	)

Initializes a new instance of the XmlTextReader class with the specified URL and TextReader.

Parameters

url	The URL to use for resolving external resources. The XmlTextReader::get_BaseURI is set to this value.
input	The TextReader containing the XML data to read.

◆ XmlTextReader() [7/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader	(	const SharedPtr< IO::TextReader > &	input,
		const SharedPtr< XmlNameTable > &	nt
	)

Initializes a new instance of the XmlTextReader class with the specified TextReader and XmlNameTable.

Parameters

input	The TextReader containing the XML data to read.
nt	The XmlNameTable to use.

Exceptions

NullReferenceException The nt value is nullptr.

◆ XmlTextReader() [8/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader	(	const String &	url,
		const SharedPtr< IO::TextReader > &	input,
		const SharedPtr< XmlNameTable > &	nt
	)

Initializes a new instance of the XmlTextReader class with the specified URL, TextReader and XmlNameTable.

Parameters

url	The URL to use for resolving external resources. The XmlTextReader::get_BaseURI is set to this value. If `url` is `nullptr`, `BaseURI` is set to String::Empty.
input	The TextReader containing the XML data to read.
nt	The XmlNameTable to use.

Exceptions

ArgumentNullException The nt value is nullptr.

◆ XmlTextReader() [9/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader	(	const SharedPtr< IO::Stream > &	xmlFragment,
		XmlNodeType	fragType,
		const SharedPtr< XmlParserContext > &	context
	)

Initializes a new instance of the XmlTextReader class with the specified stream, XmlNodeType, and XmlParserContext.

Parameters

xmlFragment	The stream containing the XML fragment to parse.
fragType	The XmlNodeType of the XML fragment. This also determines what the fragment can contain.
context	The XmlParserContext in which the `xmlFragment` is to be parsed. This includes the XmlNameTable to use, encoding, namespace scope, the current `xml:lang`, and the `xml:space` scope.

Exceptions

XmlException	`fragType` is not an Element, Attribute, or Document XmlNodeType::
ArgumentNullException	`xmlFragment` is `nullptr`.

◆ XmlTextReader() [10/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader	(	const String &	xmlFragment,
		XmlNodeType	fragType,
		const SharedPtr< XmlParserContext > &	context
	)

Initializes a new instance of the XmlTextReader class with the specified string, XmlNodeType, and XmlParserContext.

Parameters

xmlFragment	The string containing the XML fragment to parse.
fragType	The XmlNodeType of the XML fragment. This also determines what the fragment string can contain.
context	The XmlParserContext in which the `xmlFragment` is to be parsed. This includes the XmlNameTable to use, encoding, namespace scope, the current `xml:lang`, and the `xml:space` scope.

Exceptions

XmlException	`fragType` is not an `Element`, `Attribute`, or `DocumentXmlNodeType`.
ArgumentNullException	`xmlFragment` is `nullptr`.

◆ XmlTextReader() [11/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader ( const String & url )

Initializes a new instance of the XmlTextReader class with the specified file.

Parameters

url	The URL for the file containing the XML data. The XmlTextReader::get_BaseURI is set to this value.

Exceptions

FileNotFoundException	The specified file cannot be found.
DirectoryNotFoundException	Part of the filename or directory cannot be found.
InvalidOperationException	`url` is an empty string.
WebException	The remote filename cannot be resolved. An error occurred while processing the request.
UriFormatException	`url` is not a valid URI.

◆ XmlTextReader() [12/12]

ASPOSECPP_SHARED_API System::Xml::XmlTextReader::XmlTextReader	(	const String &	url,
		const SharedPtr< XmlNameTable > &	nt
	)

Initializes a new instance of the XmlTextReader class with the specified file and XmlNameTable.

Parameters

url	The URL for the file containing the XML data to read.
nt	The XmlNameTable to use.

Exceptions

NullReferenceException	The `nt` value is `nullptr`.
FileNotFoundException	The specified file cannot be found.
DirectoryNotFoundException	Part of the filename or directory cannot be found.
InvalidOperationException	`url` is an empty string.
WebException	The remote filename cannot be resolved. An error occurred while processing the request.
UriFormatException	`url` is not a valid URI.

Member Function Documentation

◆ Close()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::Close ( )

overridevirtual

Changes the XmlReader::get_ReadState to Closed.

Reimplemented from System::Xml::XmlReader.

◆ get_AttributeCount()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::get_AttributeCount ( )

overridevirtual

Returns the number of attributes on the current node.

Returns: The number of attributes on the current node.

Implements System::Xml::XmlReader.

◆ get_BaseURI()

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::get_BaseURI ( )

overridevirtual

Returns the base URI of the current node.

Returns: The base URI of the current node.

Implements System::Xml::XmlReader.

◆ get_CanReadBinaryContent()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_CanReadBinaryContent ( )

overridevirtual

Returns a value indicating whether the XmlTextReader implements the binary content read methods.

Returns: true if the binary content read methods are implemented; otherwise false. The XmlTextReader class always returns true.

Reimplemented from System::Xml::XmlReader.

◆ get_CanReadValueChunk()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_CanReadValueChunk ( )

overridevirtual

Returns a value indicating whether the XmlTextReader implements the XmlReader::ReadValueChunk method.

Returns: true if the XmlTextReader implements the XmlReader::ReadValueChunk method; otherwise false. The XmlTextReader class always returns false.

Reimplemented from System::Xml::XmlReader.

◆ get_CanResolveEntity()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_CanResolveEntity ( )

overridevirtual

Returns a value indicating whether this reader can parse and resolve entities.

Returns: true if the reader can parse and resolve entities; otherwise, false. The XmlTextReader class always returns true.

Reimplemented from System::Xml::XmlReader.

◆ get_Depth()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::get_Depth ( )

overridevirtual

Returns the depth of the current node in the XML document.

Returns: The depth of the current node in the XML document.

Implements System::Xml::XmlReader.

◆ get_DtdProcessing()

ASPOSECPP_SHARED_API System::Xml::DtdProcessing System::Xml::XmlTextReader::get_DtdProcessing ( )

Returns the DtdProcessing enumeration.

Returns: The DtdProcessing enumeration.

◆ get_Encoding()

ASPOSECPP_SHARED_API SharedPtr<System::Text::Encoding> System::Xml::XmlTextReader::get_Encoding ( )

Returns the encoding of the document.

Returns: The encoding value. If no encoding attribute exists, and there is no byte-order mark, this defaults to UTF-8.

◆ get_EntityHandling()

ASPOSECPP_SHARED_API System::Xml::EntityHandling System::Xml::XmlTextReader::get_EntityHandling ( )

Returns a value that specifies how the reader handles entities.

Returns: One of the EntityHandling values. If no EntityHandling is specified, it defaults to EntityHandling::ExpandCharEntities.

◆ get_EOF()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_EOF ( )

overridevirtual

Returns a value indicating whether the reader is positioned at the end of the stream.

Returns: true if the reader is positioned at the end of the stream; otherwise, false.

Implements System::Xml::XmlReader.

◆ get_HasValue()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_HasValue ( )

overridevirtual

Returns a value indicating whether the current node can have a XmlTextReader::get_Value other than String::Empty.

Returns: true if the node on which the reader is currently positioned can have a Value; otherwise, false.

Reimplemented from System::Xml::XmlReader.

◆ get_IsDefault()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_IsDefault ( )

overridevirtual

Returns a value indicating whether the current node is an attribute that was generated from the default value defined in the DTD or schema.

Returns: This method always returns false. (XmlTextReader does not expand default attributes.)

Reimplemented from System::Xml::XmlReader.

◆ get_IsEmptyElement()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_IsEmptyElement ( )

overridevirtual

Returns a value indicating whether the current node is an empty element (for example, <MyElement/>).

Returns: true if the current node is an element (XmlTextReader::get_NodeType value equals XmlNodeType::Element) that ends with />; otherwise, false.

Implements System::Xml::XmlReader.

◆ get_LineNumber()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::get_LineNumber ( )

overridevirtual

Returns the current line number.

Returns: The current line number.

Implements System::Xml::IXmlLineInfo.

◆ get_LinePosition()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::get_LinePosition ( )

overridevirtual

Returns the current line position.

Returns: The current line position.

Implements System::Xml::IXmlLineInfo.

◆ get_LocalName()

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::get_LocalName ( )

overridevirtual

Returns the local name of the current node.

Returns: The name of the current node with the prefix removed. For example, LocalName is book for the element <bk:book>. For node types that do not have a name (like Text, Comment, and so on), this method returns String::Empty.

Implements System::Xml::XmlReader.

◆ get_Name()

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::get_Name ( )

overridevirtual

Returns the qualified name of the current node.

Returns: The qualified name of the current node. For example, Name is bk:book for the element <bk:book>.

The name returned is dependent on the XmlTextReader::get_NodeType value of the node. The following node types return the listed values. All other node types return an empty string.

Node Type	Name
Attribute	The name of the attribute.
DocumentType	The document type name.
Element	The tag name.
EntityReference	The name of the entity referenced.
ProcessingInstruction	The target of the processing instruction.
XmlDeclaration	The literal string `xml`.

Reimplemented from System::Xml::XmlReader.

◆ get_Namespaces()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_Namespaces ( )

Returns a value indicating whether to do namespace support.

Returns: true to do namespace support; otherwise, false. The default is true.

◆ get_NamespaceURI()

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::get_NamespaceURI ( )

overridevirtual

Returns the namespace URI (as defined in the W3C Namespace specification) of the node on which the reader is positioned.

Returns: The namespace URI of the current node; otherwise an empty string.

Implements System::Xml::XmlReader.

◆ get_NameTable()

ASPOSECPP_SHARED_API SharedPtr<XmlNameTable> System::Xml::XmlTextReader::get_NameTable ( )

overridevirtual

Returns the XmlNameTable associated with this implementation.

Returns: The XmlNameTable enabling you to get the atomized version of a string within the node.

Implements System::Xml::XmlReader.

◆ get_NodeType()

ASPOSECPP_SHARED_API XmlNodeType System::Xml::XmlTextReader::get_NodeType ( )

overridevirtual

Returns the type of the current node.

Returns: One of the XmlNodeType values representing the type of the current node.

Implements System::Xml::XmlReader.

◆ get_Normalization()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_Normalization ( )

Returns a value indicating whether to normalize white space and attribute values.

Returns: true to normalize; otherwise, false. The default is false.

◆ get_Prefix()

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::get_Prefix ( )

overridevirtual

Returns the namespace prefix associated with the current node.

Returns: The namespace prefix associated with the current node.

Implements System::Xml::XmlReader.

◆ get_ProhibitDtd()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::get_ProhibitDtd ( )

Returns a value indicating whether to allow DTD processing.

Deprecated:: This method is obsolete. Use XmlTextReader::get_DtdProcessing instead.

Returns: true to disallow DTD processing; otherwise false. The default is false.

◆ get_QuoteChar()

ASPOSECPP_SHARED_API char16_t System::Xml::XmlTextReader::get_QuoteChar ( )

overridevirtual

Returns the quotation mark character used to enclose the value of an attribute node.

Returns: The quotation mark character (" or ') used to enclose the value of an attribute node.

Reimplemented from System::Xml::XmlReader.

◆ get_ReadState()

ASPOSECPP_SHARED_API System::Xml::ReadState System::Xml::XmlTextReader::get_ReadState ( )

overridevirtual

Returns the state of the reader.

Returns: One of the ReadState values.

Implements System::Xml::XmlReader.

◆ get_Value()

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::get_Value ( )

overridevirtual

Returns the text value of the current node.

Returns: The value returned depends on the XmlTextReader::get_NodeType value of the node.

The following table lists node types that have a value to return. All other node types return String::Empty.

Node Type	Value
Attribute	The value of the attribute.
CDATA	The content of the CDATA section.
Comment	The content of the comment.
DocumentType	The internal subset.
ProcessingInstruction	The entire content, excluding the target.
SignificantWhitespace	The white space within an `xml:space='preserve'` scope.
Text	The content of the text node.
Whitespace	The white space between markup.
XmlDeclaration	The content of the declaration.

Implements System::Xml::XmlReader.

◆ get_WhitespaceHandling()

ASPOSECPP_SHARED_API System::Xml::WhitespaceHandling System::Xml::XmlTextReader::get_WhitespaceHandling ( )

Returns a value that specifies how white space is handled.

Returns: One of the WhitespaceHandling values. The default is WhitespaceHandling.All (returns Whitespace and SignificantWhitespace nodes).

Exceptions

ArgumentOutOfRangeException Invalid value specified.

◆ get_XmlLang()

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::get_XmlLang ( )

overridevirtual

Returns the current xml:lang scope.

Returns: The current xml:lang scope.

Reimplemented from System::Xml::XmlReader.

◆ get_XmlSpace()

ASPOSECPP_SHARED_API System::Xml::XmlSpace System::Xml::XmlTextReader::get_XmlSpace ( )

overridevirtual

Returns the current xml:space scope.

Returns: One of the XmlSpace values. If no xml:space scope exists, this value defaults to XmlSpace::None.

Reimplemented from System::Xml::XmlReader.

◆ GetAttribute() [1/3]

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::GetAttribute ( String name )

overridevirtual

Returns the value of the attribute with the specified name.

Parameters

name	The qualified name of the attribute.

Returns: The value of the specified attribute. If the attribute is not found, nullptr is returned.

Implements System::Xml::XmlReader.

◆ GetAttribute() [2/3]

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::GetAttribute	(	String	localName,
		String	namespaceURI
	)

overridevirtual

Returns the value of the attribute with the specified local name and namespace URI.

Parameters

localName	The local name of the attribute.
namespaceURI	The namespace URI of the attribute.

Returns: The value of the specified attribute. If the attribute is not found, nullptr is returned. This method does not move the reader.

Implements System::Xml::XmlReader.

◆ GetAttribute() [3/3]

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::GetAttribute ( int32_t i )

overridevirtual

Returns the value of the attribute with the specified index.

Parameters

i	The index of the attribute. The index is zero-based. (The first attribute has index 0.)

Returns: The value of the specified attribute.

Exceptions

ArgumentOutOfRangeException The i parameter is less than 0 or greater than or equal to XmlTextReader::get_AttributeCount value.

Implements System::Xml::XmlReader.

◆ GetNamespacesInScope()

ASPOSECPP_SHARED_API SharedPtr<Collections::Generic::IDictionary<String, String> > System::Xml::XmlTextReader::GetNamespacesInScope ( XmlNamespaceScope scope )

overridevirtual

Returns a collection that contains all namespaces currently in-scope.

Parameters

scope An XmlNamespaceScope value that specifies the type of namespace nodes to return.

Returns: An IDictionary object that contains all the current in-scope namespaces. If the reader is not positioned on an element, an empty dictionary (no namespaces) is returned.

Implements System::Xml::IXmlNamespaceResolver.

◆ GetRemainder()

ASPOSECPP_SHARED_API SharedPtr<IO::TextReader> System::Xml::XmlTextReader::GetRemainder ( )

Returns the remainder of the buffered XML.

Returns: A TextReader containing the remainder of the buffered XML.

◆ HasLineInfo()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::HasLineInfo ( )

overridevirtual

Returns a value indicating whether the class can return line information.

Returns: true if the class can return line information; otherwise, false.

Implements System::Xml::IXmlLineInfo.

◆ LookupNamespace()

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::LookupNamespace ( const String & prefix )

overridevirtual

Resolves a namespace prefix in the current element's scope.

Parameters

prefix The prefix whose namespace URI you want to resolve. To match the default namespace, pass an empty string. This string does not have to be atomized.

Returns: The namespace URI to which the prefix maps or nullptr if no matching prefix is found.

Exceptions

ArgumentNullException The XmlTextReader::get_Namespaces value is set to true and the prefix value is nullptr.

Implements System::Xml::IXmlNamespaceResolver.

◆ MoveToAttribute() [1/3]

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::MoveToAttribute ( String name )

overridevirtual

Moves to the attribute with the specified name.

Parameters

name	The qualified name of the attribute.

Returns: true if the attribute is found; otherwise, false. If false, the reader's position does not change.

Implements System::Xml::XmlReader.

◆ MoveToAttribute() [2/3]

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::MoveToAttribute	(	String	localName,
		String	namespaceURI
	)

overridevirtual

Moves to the attribute with the specified local name and namespace URI.

Parameters

localName	The local name of the attribute.
namespaceURI	The namespace URI of the attribute.

Returns: true if the attribute is found; otherwise, false. If false, the reader's position does not change.

Implements System::Xml::XmlReader.

◆ MoveToAttribute() [3/3]

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::MoveToAttribute ( int32_t i )

overridevirtual

Moves to the attribute with the specified index.

Parameters

i	The index of the attribute.

Exceptions

ArgumentOutOfRangeException The i parameter is less than 0 or greater than or equal to XmlTextReader::get_AttributeCount value.

Reimplemented from System::Xml::XmlReader.

◆ MoveToElement()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::MoveToElement ( )

overridevirtual

Moves to the element that contains the current attribute node.

Returns: true if the reader is positioned on an attribute (the reader moves to the element that owns the attribute); false if the reader is not positioned on an attribute (the position of the reader does not change).

Implements System::Xml::XmlReader.

◆ MoveToFirstAttribute()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::MoveToFirstAttribute ( )

overridevirtual

Moves to the first attribute.

Returns: true if an attribute exists (the reader moves to the first attribute); otherwise, false (the position of the reader does not change).

Implements System::Xml::XmlReader.

◆ MoveToNextAttribute()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::MoveToNextAttribute ( )

overridevirtual

Moves to the next attribute.

Returns: true if there is a next attribute; false if there are no more attributes.

Implements System::Xml::XmlReader.

◆ Read()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::Read ( )

overridevirtual

Reads the next node from the stream.

Returns: true if the next node was read successfully; false if there are no more nodes to read.

Exceptions

XmlException An error occurred while parsing the XML.

Implements System::Xml::XmlReader.

◆ ReadAttributeValue()

ASPOSECPP_SHARED_API bool System::Xml::XmlTextReader::ReadAttributeValue ( )

overridevirtual

Parses the attribute value into one or more Text, EntityReference, or EndEntity nodes.

Returns: true if there are nodes to return. false if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read. An empty attribute, such as, misc="", returns true with a single node with a value of String::Empty.

Implements System::Xml::XmlReader.

◆ ReadBase64()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::ReadBase64	(	const ArrayPtr< uint8_t > &	array,
		int32_t	offset,
		int32_t	len
	)

Decodes Base64 and returns the decoded binary bytes.

Parameters

array	The array of characters that serves as the buffer to which the text contents are written.
offset	The zero-based index into the array specifying where the method can begin to write to the buffer.
len	The number of bytes to write into the buffer.

Returns: The number of bytes written to the buffer.

Exceptions

XmlException	The Base64 sequence is not valid.
ArgumentNullException	The value of `array` is `nullptr`.
ArgumentOutOfRangeException	`offset` < 0, or `len` < 0, or `len` > `array.get_Length` - `offset`.

◆ ReadBinHex()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::ReadBinHex	(	const ArrayPtr< uint8_t > &	array,
		int32_t	offset,
		int32_t	len
	)

Decodes BinHex and returns the decoded binary bytes.

Parameters

array	The byte array that serves as the buffer to which the decoded binary bytes are written.
offset	The zero-based index into the array specifying where the method can begin to write to the buffer.
len	The number of bytes to write into the buffer.

Returns: The number of bytes written to your buffer.

Exceptions

XmlException	The `BinHex` sequence is not valid.
ArgumentNullException	The value of `array` is `nullptr`.
ArgumentOutOfRangeException	`offset` < 0, or `len` < 0, or `len` > `array.get_Length` - `offset`.

◆ ReadChars()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::ReadChars	(	const ArrayPtr< char16_t > &	buffer,
		int32_t	index,
		int32_t	count
	)

Reads the text contents of an element into a character buffer. This method is designed to read large streams of embedded text by calling it successively.

Parameters

buffer	The array of characters that serves as the buffer to which the text contents are written.
index	The position within `buffer` where the method can begin writing text contents.
count	The number of characters to write into `buffer`.

Returns: The number of characters read. This can be 0 if the reader is not positioned on an element or if there is no more text content to return in the current context.

Exceptions

ArgumentException	`count` is greater than the space specified in the `buffer` (buffer size - `index`).
ArgumentNullException	The `buffer` value is `nullptr`.
ArgumentOutOfRangeException	`index` < 0 or `count` < 0.

◆ ReadContentAsBase64()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::ReadContentAsBase64	(	ArrayPtr< uint8_t >	buffer,
		int32_t	index,
		int32_t	count
	)

overridevirtual

Reads the content and returns the Base64 decoded binary bytes.

Parameters

buffer	The buffer into which to copy the resulting text. This value cannot be `nullptr`.
index	The offset into the buffer where to start copying the result.
count	The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method.

Returns: The number of bytes written to the buffer.

Exceptions

ArgumentNullException	The `buffer` value is `nullptr`.
InvalidOperationException	The call is not supported in the current node.
ArgumentOutOfRangeException	The index into the buffer or index + count is larger than the allocated buffer size.

Reimplemented from System::Xml::XmlReader.

◆ ReadContentAsBinHex()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::ReadContentAsBinHex	(	ArrayPtr< uint8_t >	buffer,
		int32_t	index,
		int32_t	count
	)

overridevirtual

Reads the content and returns the BinHex decoded binary bytes.

Parameters

buffer	The buffer into which to copy the resulting text. This value cannot be `nullptr`.
index	The offset into the buffer where to start copying the result.
count	The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method.

Returns: The number of bytes written to the buffer.

Exceptions

ArgumentNullException	The `buffer` value is `nullptr`.
InvalidOperationException	The call is not supported on the current node.
ArgumentOutOfRangeException	The index into the buffer or index + count is larger than the allocated buffer size.
NotSupportedException	The XmlTextReader implementation does not support this method.

Reimplemented from System::Xml::XmlReader.

◆ ReadElementContentAsBase64()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::ReadElementContentAsBase64	(	ArrayPtr< uint8_t >	buffer,
		int32_t	index,
		int32_t	count
	)

overridevirtual

Reads the element and decodes the Base64 content.

Parameters

buffer	The buffer into which to copy the resulting text. This value cannot be `nullptr`.
index	The offset into the buffer where to start copying the result.
count	The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method.

Returns: The number of bytes written to the buffer.

Exceptions

ArgumentNullException	The `buffer` value is `nullptr`.
InvalidOperationException	The current node is not an element node.
ArgumentOutOfRangeException	The index into the buffer or index + count is larger than the allocated buffer size.
NotSupportedException	The XmlTextReader implementation does not support this method.
XmlException	The element contains mixed-content.
FormatException	The content cannot be converted to the requested type.

Reimplemented from System::Xml::XmlReader.

◆ ReadElementContentAsBinHex()

ASPOSECPP_SHARED_API int32_t System::Xml::XmlTextReader::ReadElementContentAsBinHex	(	ArrayPtr< uint8_t >	buffer,
		int32_t	index,
		int32_t	count
	)

overridevirtual

Reads the element and decodes the BinHex content.

Parameters

buffer	The buffer into which to copy the resulting text. This value cannot be `nullptr`.
index	The offset into the buffer where to start copying the result.
count	The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method.

Returns: The number of bytes written to the buffer.

Exceptions

ArgumentNullException	The `buffer` value is `nullptr`.
InvalidOperationException	The current node is not an element node.
ArgumentOutOfRangeException	The index into the buffer or index + count is larger than the allocated buffer size.
NotSupportedException	The XmlReader implementation does not support this method.
XmlException	The element contains mixed-content.
FormatException	The content cannot be converted to the requested type.

Reimplemented from System::Xml::XmlReader.

◆ ReadString()

ASPOSECPP_SHARED_API String System::Xml::XmlTextReader::ReadString ( )

overridevirtual

Reads the contents of an element or a text node as a string.

Returns: The contents of the element or text node. This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context. Note: The text node can be either an element or an attribute text node.

Exceptions

XmlException	An error occurred while parsing the XML.
InvalidOperationException	An invalid operation was attempted.

Reimplemented from System::Xml::XmlReader.

◆ ResetState()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::ResetState ( )

Resets the state of the reader to ReadState::Initial.

Exceptions

InvalidOperationException	Calling `ResetState` if the reader was constructed using an XmlParserContext.
XmlException	Documents in a single stream do not share the same encoding.

◆ ResolveEntity()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::ResolveEntity ( )

overridevirtual

Resolves the entity reference for EntityReference nodes.

Implements System::Xml::XmlReader.

◆ set_DtdProcessing()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::set_DtdProcessing ( System::Xml::DtdProcessing value )

Sets the DtdProcessing enumeration.

Parameters

value The value to set.

◆ set_EntityHandling()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::set_EntityHandling ( System::Xml::EntityHandling value )

Sets a value that specifies how the reader handles entities.

Parameters

value The value to set.

◆ set_Namespaces()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::set_Namespaces ( bool value )

Sets a value indicating whether to do namespace support.

Parameters

value The value to set.

Exceptions

InvalidOperationException Setting this value after a read operation has occurred (XmlTextReader::get_ReadState is not ReadState::Initial).

◆ set_Normalization()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::set_Normalization ( bool value )

Sets a value indicating whether to normalize white space and attribute values.

Parameters

value The value to set.

Exceptions

InvalidOperationException Setting this value when the reader is closed (XmlTextReader::get_ReadState is ReadState::Closed).

◆ set_ProhibitDtd()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::set_ProhibitDtd ( bool value )

Sets a value indicating whether to allow DTD processing.

Deprecated:: This method is obsolete. Use XmlTextReader::set_DtdProcessing instead.

Parameters

value The value to set.

◆ set_WhitespaceHandling()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::set_WhitespaceHandling ( System::Xml::WhitespaceHandling value )

Sets a value that specifies how white space is handled.

Parameters

value The value to set.

Exceptions

ArgumentOutOfRangeException	Invalid value specified.
InvalidOperationException	Setting this value when the reader is closed (XmlTextReader::get_ReadState is ReadState::Closed).

◆ set_XmlResolver()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::set_XmlResolver ( const SharedPtr< System::Xml::XmlResolver > & value )

Sets the XmlResolver used for resolving DTD references.

Parameters

value The value to set.

◆ Skip()

ASPOSECPP_SHARED_API void System::Xml::XmlTextReader::Skip ( )

overridevirtual

Skips the children of the current node.

Reimplemented from System::Xml::XmlReader.

Public Types

Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Ptr

Constructor & Destructor Documentation

◆ XmlTextReader() [1/12]

◆ XmlTextReader() [2/12]

◆ XmlTextReader() [3/12]

◆ XmlTextReader() [4/12]

◆ XmlTextReader() [5/12]

◆ XmlTextReader() [6/12]

◆ XmlTextReader() [7/12]

◆ XmlTextReader() [8/12]

◆ XmlTextReader() [9/12]

◆ XmlTextReader() [10/12]

◆ XmlTextReader() [11/12]

◆ XmlTextReader() [12/12]

Member Function Documentation

◆ Close()

◆ get_AttributeCount()

◆ get_BaseURI()

◆ get_CanReadBinaryContent()

◆ get_CanReadValueChunk()

◆ get_CanResolveEntity()

◆ get_Depth()

◆ get_DtdProcessing()

◆ get_Encoding()

◆ get_EntityHandling()

◆ get_EOF()

◆ get_HasValue()

◆ get_IsDefault()

◆ get_IsEmptyElement()

◆ get_LineNumber()

◆ get_LinePosition()

◆ get_LocalName()

◆ get_Name()

◆ get_Namespaces()

◆ get_NamespaceURI()

◆ get_NameTable()

◆ get_NodeType()

◆ get_Normalization()

◆ get_Prefix()

◆ get_ProhibitDtd()

◆ get_QuoteChar()

◆ get_ReadState()

◆ get_Value()

◆ get_WhitespaceHandling()

◆ get_XmlLang()

◆ get_XmlSpace()

◆ GetAttribute() [1/3]

◆ GetAttribute() [2/3]

◆ GetAttribute() [3/3]

◆ GetNamespacesInScope()

◆ GetRemainder()

◆ HasLineInfo()

◆ LookupNamespace()

◆ MoveToAttribute() [1/3]

◆ MoveToAttribute() [2/3]

◆ MoveToAttribute() [3/3]

◆ MoveToElement()

◆ MoveToFirstAttribute()

◆ MoveToNextAttribute()

◆ Read()

◆ ReadAttributeValue()

◆ ReadBase64()

◆ ReadBinHex()

◆ ReadChars()

◆ ReadContentAsBase64()

◆ ReadContentAsBinHex()

◆ ReadElementContentAsBase64()

◆ ReadElementContentAsBinHex()

◆ ReadString()

◆ ResetState()

◆ ResolveEntity()

◆ set_DtdProcessing()

◆ set_EntityHandling()

◆ set_Namespaces()

◆ set_Normalization()