System::Xml::XmlReader класс

XmlReader class

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

class XmlReader : public System::IDisposable

Методы

МетодОписание
virtual Close()При переопределении в производном классе изменяет XmlReader::get_ReadState на ReadState::Closed.
static Create(const String&)Создаёт новый экземпляр XmlReader с указанным URI.
static Create(const String&, const SharedPtr<XmlReaderSettings>&)Создаёт новый экземпляр XmlReader, используя указанные URI и параметры.
static Create(const String&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)Создаёт новый экземпляр XmlReader, используя указанные URI, параметры и контекстную информацию для разбора.
static Create(const SharedPtr<IO::Stream>&)Создаёт новый экземпляр XmlReader, используя указанный поток с настройками по умолчанию.
static Create(const SharedPtr<IO::Stream>&, const SharedPtr<XmlReaderSettings>&)Создаёт новый экземпляр XmlReader с указанным потоком и параметрами.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const String&)Создаёт новый экземпляр XmlReader, используя указанный поток, базовый URI и параметры.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)Создаёт новый экземпляр XmlReader, используя указанный поток, параметры и контекстную информацию для разбора.
static Create(const SharedPtr<IO::TextReader>&)Создаёт новый экземпляр XmlReader, используя указанный текстовый читатель.
static Create(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlReaderSettings>&)Создаёт новый экземпляр XmlReader, используя указанный текстовый читатель и параметры.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const String&)Создаёт новый экземпляр XmlReader, используя указанный текстовый читатель, параметры и базовый URI.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)Создаёт новый экземпляр XmlReader, используя указанный текстовый читатель, параметры и контекстную информацию для разбора.
static Create(const SharedPtr<XmlReader>&, SharedPtr<XmlReaderSettings>)Создаёт новый экземпляр XmlReader, используя указанный XML‑читатель и параметры.
Dispose() overrideОсвобождает все ресурсы, используемые текущим экземпляром класса XmlReader.
virtual get_AttributeCount()При переопределении в производном классе получает количество атрибутов текущего узла.
virtual get_BaseURI()При переопределении в производном классе получает базовый URI текущего узла.
virtual get_CanReadBinaryContent()Возвращает значение, указывающее, реализует ли XmlReader методы чтения двоичного содержимого.
virtual get_CanReadValueChunk()Возвращает значение, указывающее, реализует ли XmlReader метод XmlReader::ReadValueChunk.
virtual get_CanResolveEntity()Возвращает значение, указывающее, может ли этот читатель разбирать и разрешать сущности.
virtual get_Depth()При переопределении в производном классе получает глубину текущего узла в XML‑документе.
virtual get_EOF()При переопределении в производном классе получает значение, указывающее, находится ли считыватель в конце потока.
virtual get_HasAttributes()Возвращает значение, указывающее, имеет ли текущий узел какие-либо атрибуты.
virtual get_HasValue()При переопределении в производном классе получает значение, указывающее, может ли текущий узел иметь значение XmlReader::get_Value.
virtual get_IsDefault()При переопределении в производном классе получает значение, указывающее, является ли текущий узел атрибутом, сгенерированным из значения по умолчанию, определённого в DTD или схеме.
virtual get_IsEmptyElement()При переопределении в производном классе получает значение, указывающее, является ли текущий узел пустым элементом (например, ).
virtual get_LocalName()При переопределении в производном классе получает локальное имя текущего узла.
virtual get_Name()При переопределении в производном классе получает квалифицированное имя текущего узла.
virtual get_NamespaceURI()При переопределении в производном классе получает URI пространства имён (как определено в спецификации W3C Namespace) узла, на котором находится считыватель.
virtual get_NameTable()При переопределении в производном классе получает XmlNameTable, связанную с этой реализацией.
virtual get_NodeType()При переопределении в производном классе получает тип текущего узла.
virtual get_Prefix()При переопределении в производном классе получает префикс пространства имён, связанный с текущим узлом.
virtual get_QuoteChar()При переопределении в производном классе получает символ кавычки, используемый для заключения значения узла‑атрибута.
virtual get_ReadState()При переопределении в производном классе получает состояние считывателя.
virtual get_SchemaInfo()Возвращает информацию схемы, назначенную текущему узлу в результате проверки схемы.
virtual get_Settings()Возвращает объект XmlReaderSettings, используемый для создания этого экземпляра XmlReader.
virtual get_Value()При переопределении в производном классе получает текстовое значение текущего узла.
virtual get_ValueType()Возвращает тип текущего узла.
virtual get_XmlLang()При переопределении в производном классе получает текущую область действия xml:lang.
virtual get_XmlSpace()При переопределении в производном классе получает текущую область действия xml:space.
virtual GetAttribute(String)При переопределении в производном классе получает значение атрибута с указанным значением XmlReader::get_Name.
virtual GetAttribute(String, String)При переопределении в производном классе получает значение атрибута с указанными значениями XmlReader::get_LocalName и XmlReader::get_NamespaceURI.
virtual GetAttribute(int32_t)При переопределении в производном классе получает значение атрибута с указанным индексом.
virtual idx_get(int32_t)При переопределении в производном классе получает значение атрибута с указанным индексом.
virtual idx_get(String)При переопределении в производном классе получает значение атрибута с указанным значением XmlReader::get_Name.
virtual idx_get(String, String)При переопределении в производном классе получает значение атрибута с указанными значениями XmlReader::get_LocalName и XmlReader::get_NamespaceURI.
static IsName(const String&)Возвращает значение, указывающее, является ли строковый аргумент допустимым именем XML.
static IsNameToken(const String&)Возвращает значение, указывающее, является ли строковый аргумент допустимым токеном имени XML.
virtual IsStartElement()Вызывает XmlReader::MoveToContent и проверяет, является ли текущий узел содержимого стартовым тегом или тегом пустого элемента.
virtual IsStartElement(String)Вызывает XmlReader::MoveToContent и проверяет, является ли текущий узел содержимого стартовым тегом или тегом пустого элемента, а также совпадает ли значение XmlReader::get_Name найденного элемента с переданным аргументом.
virtual IsStartElement(String, String)Вызывает XmlReader::MoveToContent и проверяет, является ли текущий узел содержимого стартовым тегом или тегом пустого элемента, а также совпадают ли значения XmlReader::get_LocalName и XmlReader::get_NamespaceURI найденного элемента с заданными строками.
virtual LookupNamespace(const String&)При переопределении в производном классе разрешает префикс пространства имён в области действия текущего элемента.
virtual MoveToAttribute(String)При переопределении в производном классе переходит к атрибуту с указанным значением XmlReader::get_Name.
virtual MoveToAttribute(String, String)При переопределении в производном классе переходит к атрибуту с указанными значениями XmlReader::get_LocalName и XmlReader::get_NamespaceURI.
virtual MoveToAttribute(int32_t)При переопределении в производном классе переходит к атрибуту с указанным индексом.
virtual MoveToContent()Проверяет, является ли текущий узел узлом содержимого (текст без пробелов, CDATA, Element, EndElement, EntityReference или EndEntity). Если узел не является узлом содержимого, читатель пропускает его до следующего узла содержимого или до конца файла. Он пропускает узлы следующих типов: ProcessingInstruction, DocumentType, Comment, Whitespace или SignificantWhitespace.
virtual MoveToElement()При переопределении в производном классе переходит к элементу, содержащему текущий узел атрибута.
virtual MoveToFirstAttribute()При переопределении в производном классе переходит к первому атрибуту.
virtual MoveToNextAttribute()При переопределении в производном классе переходит к следующему атрибуту.
virtual Read()При переопределении в производном классе считывает следующий узел из потока.
virtual ReadAttributeValue()При переопределении в производном классе разбирает значение атрибута в один или несколько узлов Text, EntityReference или EndEntity.
virtual ReadContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)Считывает содержимое как объект указанного типа.
virtual ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)Читает содержимое и возвращает бинарные байты, декодированные из Base64.
virtual ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)Считывает содержимое и возвращает декодированные из BinHex двоичные байты.
virtual ReadContentAsBoolean()Считывает текстовое содержимое в текущей позиции как Boolean.
virtual ReadContentAsDateTime()Считывает текстовое содержимое в текущей позиции как объект DateTime.
virtual ReadContentAsDateTimeOffset()Считывает текстовое содержимое в текущей позиции как объект DateTimeOffset.
virtual ReadContentAsDecimal()Считывает текстовое содержимое в текущей позиции как объект Decimal.
virtual ReadContentAsDouble()Считывает текстовое содержимое в текущей позиции как число двойной точности с плавающей запятой.
virtual ReadContentAsFloat()Считывает текстовое содержимое в текущей позиции как число одинарной точности с плавающей запятой.
virtual ReadContentAsInt()Считывает текстовое содержимое в текущей позиции как 32-битное знаковое целое число.
virtual ReadContentAsLong()Считывает текстовое содержимое в текущей позиции как 64-битное знаковое целое число.
virtual ReadContentAsObject()Считывает текстовое содержимое в текущей позиции как Object.
virtual ReadContentAsString()Считывает текстовое содержимое в текущей позиции как объект String.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)Считывает содержимое элемента как запрошенный тип.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>, String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает содержимое элемента как запрошенный тип.
virtual ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)Считывает элемент и декодирует содержимое Base64.
virtual ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)Считывает элемент и декодирует содержимое BinHex.
virtual ReadElementContentAsBoolean()Считывает текущий элемент и возвращает содержимое как объект Boolean.
virtual ReadElementContentAsBoolean(String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает текущий элемент и возвращает содержимое как объект Boolean.
virtual ReadElementContentAsDateTime()Считывает текущий элемент и возвращает содержимое как объект DateTime.
virtual ReadElementContentAsDateTime(String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает текущий элемент и возвращает содержимое как объект DateTime.
virtual ReadElementContentAsDecimal()Считывает текущий элемент и возвращает содержимое как объект Decimal.
virtual ReadElementContentAsDecimal(String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает текущий элемент и возвращает содержимое как объект Decimal.
virtual ReadElementContentAsDouble()Считывает текущий элемент и возвращает содержимое как число двойной точности с плавающей запятой.
virtual ReadElementContentAsDouble(String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает текущий элемент и возвращает содержимое как число двойной точности с плавающей запятой.
virtual ReadElementContentAsFloat()Считывает текущий элемент и возвращает содержимое как число одинарной точности с плавающей запятой.
virtual ReadElementContentAsFloat(String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает текущий элемент и возвращает содержимое как число одинарной точности с плавающей запятой.
virtual ReadElementContentAsInt()Считывает текущий элемент и возвращает содержимое как 32‑битное знаковое целое число.
virtual ReadElementContentAsInt(String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает текущий элемент и возвращает содержимое как 32‑битное знаковое целое число.
virtual ReadElementContentAsLong()Считывает текущий элемент и возвращает содержимое как 64‑битное знаковое целое число.
virtual ReadElementContentAsLong(String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает текущий элемент и возвращает содержимое как 64‑битное знаковое целое число.
virtual ReadElementContentAsObject()Считывает текущий элемент и возвращает содержимое как объект Object.
virtual ReadElementContentAsObject(String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает текущий элемент и возвращает содержимое как объект Object.
virtual ReadElementContentAsString()Считывает текущий элемент и возвращает содержимое как объект String.
virtual ReadElementContentAsString(String, String)Проверяет, что указанные локальное имя и URI пространства имён соответствуют текущему элементу, затем считывает текущий элемент и возвращает содержимое как объект String.
virtual ReadElementString()Считывает элемент, содержащий только текст. Однако рекомендуется использовать метод XmlReader::ReadElementContentAsString, так как он предоставляет более простой способ выполнения этой операции.
virtual ReadElementString(String)Проверяет, что значение XmlReader::get_Name найденного элемента соответствует заданной строке перед считыванием элемента, содержащего только текст. Однако рекомендуется использовать метод XmlReader::ReadElementContentAsString, так как он предоставляет более простой способ выполнения этой операции.
virtual ReadElementString(String, String)Проверяет, что значения XmlReader::get_LocalName и XmlReader::get_NamespaceURI найденного элемента соответствуют заданным строкам перед считыванием элемента, содержащего только текст. Однако рекомендуется использовать метод XmlReader::ReadElementContentAsString, так как он предоставляет более простой способ выполнения этой операции.
virtual ReadEndElement()Проверяет, что текущий узел содержимого является закрывающим тегом, и перемещает читатель к следующему узлу.
virtual ReadInnerXml()При переопределении в производном классе читает всё содержимое, включая разметку, как строку.
virtual ReadOuterXml()При переопределении в производном классе читает содержимое, включая разметку, представляющее этот узел и всех его потомков.
virtual ReadStartElement()Проверяет, что текущий узел является элементом, и перемещает читатель к следующему узлу.
virtual ReadStartElement(String)Проверяет, что текущий узел содержимого является элементом с заданным значением XmlReader::get_Name, и перемещает читатель к следующему узлу.
virtual ReadStartElement(String, String)Проверяет, что текущий узел содержимого является элементом с заданными значениями XmlReader::get_LocalName и XmlReader::get_NamespaceURI, и перемещает читатель к следующему узлу.
virtual ReadString()При переопределении в производном классе читает содержимое элемента или текстового узла как строку. Однако рекомендуется использовать метод XmlReader::ReadElementContentAsString, поскольку он предоставляет более простой способ выполнения этой операции.
virtual ReadSubtree()Возвращает новый экземпляр XmlReader, который можно использовать для чтения текущего узла и всех его потомков.
virtual ReadToDescendant(String)Перемещает XmlReader к следующему дочернему элементу с указанным квалифицированным именем.
virtual ReadToDescendant(String, String)Перемещает XmlReader к следующему дочернему элементу с указанным локальным именем и URI пространства имён.
virtual ReadToFollowing(String)Читает до тех пор, пока не будет найден элемент с указанным квалифицированным именем.
virtual ReadToFollowing(String, String)Читает до тех пор, пока не будет найден элемент с указанным локальным именем и URI пространства имён.
virtual ReadToNextSibling(String)Перемещает XmlReader к следующему соседнему элементу с указанным квалифицированным именем.
virtual ReadToNextSibling(String, String)Перемещает XmlReader к следующему соседнему элементу с указанным локальным именем и URI пространства имён.
virtual ReadValueChunk(ArrayPtr<char16_t>, int32_t, int32_t)Читает большие потоки текста, встроенные в XML‑документ.
virtual ResolveEntity()При переопределении в производном классе разрешает ссылку на сущность для узлов EntityReference.
virtual Skip()Пропускает дочерние узлы текущего узла.

Typedefs

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

См. также