Класс System::Xml::XmlTextReader

XmlTextReader class

Представляет считыватель, обеспечивающий быстрый, некешированный последовательный доступ только вперёд к XML‑данным.

class XmlTextReader : public System::Xml::XmlReader,
                      public System::Xml::IXmlLineInfo,
                      public System::Xml::IXmlNamespaceResolver

Методы

МетодОписание
Close() overrideИзменяет XmlReader::get_ReadState на Closed.
get_AttributeCount() overrideВозвращает количество атрибутов текущего узла.
get_BaseURI() overrideВозвращает базовый URI текущего узла.
get_CanReadBinaryContent() overrideВозвращает значение, указывающее, реализует ли XmlTextReader методы чтения бинарного содержимого.
get_CanReadValueChunk() overrideВозвращает значение, указывающее, реализует ли XmlTextReader метод XmlReader::ReadValueChunk.
get_CanResolveEntity() overrideВозвращает значение, указывающее, может ли этот читатель разбирать и разрешать сущности.
get_Depth() overrideВозвращает глубину текущего узла в XML-документе.
get_DtdProcessing()Возвращает перечисление DtdProcessing.
get_Encoding()Возвращает кодировку документа.
get_EntityHandling()Возвращает значение, определяющее, как читатель обрабатывает сущности.
get_EOF() overrideВозвращает значение, указывающее, находится ли читатель в конце потока.
get_HasValue() overrideВозвращает значение, указывающее, может ли текущий узел иметь XmlTextReader::get_Value отличное от String::Empty.
get_IsDefault() overrideВозвращает значение, указывающее, является ли текущий узел атрибутом, сгенерированным из значения по умолчанию, определённого в DTD или схеме.
get_IsEmptyElement() overrideВозвращает значение, указывающее, является ли текущий узел пустым элементом (например, ).
get_LineNumber() overrideВозвращает текущий номер строки.
get_LinePosition() overrideВозвращает текущую позицию в строке.
get_LocalName() overrideВозвращает локальное имя текущего узла.
get_Name() overrideВозвращает квалифицированное имя текущего узла.
get_Namespaces()Возвращает значение, указывающее, следует ли поддерживать пространства имён.
get_NamespaceURI() overrideВозвращает URI пространства имён (как определено в спецификации W3C Namespace) узла, на котором находится читатель.
get_NameTable() overrideВозвращает XmlNameTable, связанную с этой реализацией.
get_NodeType() overrideВозвращает тип текущего узла.
get_Normalization()Возвращает значение, указывающее, следует ли нормализовать пробелы и значения атрибутов.
get_Prefix() overrideВозвращает префикс пространства имён, связанный с текущим узлом.
get_ProhibitDtd()Возвращает значение, указывающее, разрешать ли обработку DTD.
get_QuoteChar() overrideВозвращает символ кавычки, используемый для заключения значения узла атрибута.
get_ReadState() overrideВозвращает состояние читателя.
get_Value() overrideВозвращает текстовое значение текущего узла.
get_WhitespaceHandling()Возвращает значение, определяющее, как обрабатываются пробелы.
get_XmlLang() overrideВозвращает текущую область xml:lang.
get_XmlSpace() overrideВозвращает текущую область действия xml:space.
GetAttribute(String) overrideВозвращает значение атрибута с указанным именем.
GetAttribute(String, String) overrideВозвращает значение атрибута с указанным локальным именем и URI пространства имён.
GetAttribute(int32_t) overrideВозвращает значение атрибута с указанным индексом.
GetNamespacesInScope(XmlNamespaceScope) overrideВозвращает коллекцию, содержащую все пространства имён, находящиеся в текущей области видимости.
GetRemainder()Возвращает остаток буферизованного XML.
HasLineInfo() overrideВозвращает значение, указывающее, может ли класс возвращать информацию о строках.
LookupNamespace(const String&) overrideРазрешает префикс пространства имён в области действия текущего элемента.
MoveToAttribute(String) overrideПереходит к атрибуту с указанным именем.
MoveToAttribute(String, String) overrideПереходит к атрибуту с указанным локальным именем и URI пространства имён.
MoveToAttribute(int32_t) overrideПереходит к атрибуту с указанным индексом.
MoveToElement() overrideПереходит к элементу, содержащему текущий узел атрибута.
MoveToFirstAttribute() overrideПереходит к первому атрибуту.
MoveToNextAttribute() overrideПереходит к следующему атрибуту.
Read() overrideЧитает следующий узел из потока.
ReadAttributeValue() overrideРазбирает значение атрибута в один или несколько Text, EntityReference, или EndEntity узлов.
ReadBase64(const ArrayPtr<uint8_t>&, int32_t, int32_t)Декодирует Base64 и возвращает декодированные двоичные байты.
ReadBinHex(const ArrayPtr<uint8_t>&, int32_t, int32_t)Декодирует BinHex и возвращает декодированные двоичные байты.
ReadChars(const ArrayPtr<char16_t>&, int32_t, int32_t)Считывает текстовое содержимое элемента в буфер символов. Этот метод предназначен для последовательного чтения больших потоков встроенного текста.
ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideСчитывает содержимое и возвращает декодированные из Base64 двоичные байты.
ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideСчитывает содержимое и возвращает декодированные из BinHex двоичные байты.
ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideЧитает элемент и декодирует содержимое Base64.
ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideСчитывает элемент и декодирует содержимое BinHex.
ReadString() overrideСчитывает содержимое элемента или текстового узла как строку.
ResetState()Сбрасывает состояние считывателя к ReadState::Initial.
ResolveEntity() overrideРазрешает ссылку на сущность для узлов EntityReference.
set_DtdProcessing(System::Xml::DtdProcessing)Устанавливает перечисление DtdProcessing.
set_EntityHandling(System::Xml::EntityHandling)Устанавливает значение, определяющее, как считыватель обрабатывает сущности.
set_Namespaces(bool)Устанавливает значение, указывающее, следует ли поддерживать пространства имён.
set_Normalization(bool)Устанавливает значение, указывающее, следует ли нормализовать пробелы и значения атрибутов.
set_ProhibitDtd(bool)Устанавливает значение, указывающее, разрешать ли обработку DTD.
set_WhitespaceHandling(System::Xml::WhitespaceHandling)Устанавливает значение, определяющее, как обрабатываются пробелы.
set_XmlResolver(const SharedPtr<System::Xml::XmlResolver>&)Устанавливает XmlResolver, используемый для разрешения ссылок DTD.
Skip() overrideПропускает дочерние узлы текущего узла.
XmlTextReader(const SharedPtr<IO::Stream>&)Инициализирует новый экземпляр класса XmlTextReader с указанным потоком.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&)Инициализирует новый экземпляр класса XmlTextReader с указанным URL и потоком.
XmlTextReader(const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)Инициализирует новый экземпляр класса XmlTextReader с указанным потоком и XmlNameTable.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)Инициализирует новый экземпляр класса XmlTextReader с указанным URL, потоком и XmlNameTable.
XmlTextReader(const SharedPtr<IO::TextReader>&)Инициализирует новый экземпляр класса XmlTextReader с указанным TextReader.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&)Инициализирует новый экземпляр класса XmlTextReader с указанным URL и TextReader.
XmlTextReader(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)Инициализирует новый экземпляр класса XmlTextReader с указанным TextReader и XmlNameTable.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)Инициализирует новый экземпляр класса XmlTextReader с указанным URL, TextReader и XmlNameTable.
XmlTextReader(const SharedPtr<IO::Stream>&, XmlNodeType, const SharedPtr<XmlParserContext>&)Инициализирует новый экземпляр класса XmlTextReader с указанным потоком, XmlNodeType и XmlParserContext.
XmlTextReader(const String&, XmlNodeType, const SharedPtr<XmlParserContext>&)Инициализирует новый экземпляр класса XmlTextReader с указанной строкой, XmlNodeType и XmlParserContext.
XmlTextReader(const String&)Инициализирует новый экземпляр класса XmlTextReader с указанным файлом.
XmlTextReader(const String&, const SharedPtr<XmlNameTable>&)Инициализирует новый экземпляр класса XmlTextReader с указанным файлом и XmlNameTable.

Typedefs

Определение типаОписание
PtrПсевдоним для shared pointer к экземпляру этого класса.

Примечания

Рекомендуется использовать класс XmlReader вместо этого.

Объекты этого класса должны выделяться только с помощью функции System::MakeObject(). Никогда не создавайте экземпляры этого типа в стеке или с помощью оператора new, так как это приведёт к ошибкам времени выполнения и/или сбоям утверждений. Всегда оборачивайте этот класс в указатель System::SmartPtr и используйте этот указатель для передачи его в функции в качестве аргумента.

См. также