Класс 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 к экземпляру этого класса.

См. также