XmlTextReader Класс

Определение

Пространство имен:

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

Исходный код:

XmlTextReader.cs

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

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

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

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

type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface IXmlNamespaceResolver

Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver

Наследование

Object

XmlReader

XmlTextReader

Реализации

IXmlLineInfo IXmlNamespaceResolver

Комментарии

Дополнительные сведения об этом API см. в дополнительных примечаниях API для XmlTextReader.

Примечания для тех, кто наследует этот метод

Этот класс имеет требование наследования. Полное доверие требуется для наследования от XmlTextReader.

Конструкторы

Имя	Описание
XmlTextReader()	Инициализирует новый экземпляр XmlTextReaderобъекта .
XmlTextReader(Stream, XmlNameTable)	Инициализирует новый экземпляр XmlTextReader класса с указанным потоком и XmlNameTable.
XmlTextReader(Stream, XmlNodeType, XmlParserContext)	Инициализирует новый экземпляр XmlTextReader класса с указанным потоком и XmlNodeTypeXmlParserContext.
XmlTextReader(Stream)	Инициализирует новый экземпляр XmlTextReader класса с указанным потоком.
XmlTextReader(String, Stream, XmlNameTable)	Инициализирует новый экземпляр XmlTextReader класса с указанным URL-адресом, потоком и XmlNameTable.
XmlTextReader(String, Stream)	Инициализирует новый экземпляр XmlTextReader класса с указанным URL-адресом и потоком.
XmlTextReader(String, TextReader, XmlNameTable)	Инициализирует новый экземпляр XmlTextReader класса с указанным URL-адресом TextReader и XmlNameTable.
XmlTextReader(String, TextReader)	Инициализирует новый экземпляр XmlTextReader класса с указанным URL-адресом и TextReader.
XmlTextReader(String, XmlNameTable)	Инициализирует новый экземпляр XmlTextReader класса с указанным файлом и XmlNameTable.
XmlTextReader(String, XmlNodeType, XmlParserContext)	Инициализирует новый экземпляр XmlTextReader класса с указанной строкой и XmlNodeTypeXmlParserContext.
XmlTextReader(String)	Инициализирует новый экземпляр XmlTextReader класса с указанным файлом.
XmlTextReader(TextReader, XmlNameTable)	Инициализирует новый экземпляр XmlTextReader класса с указанным TextReader и XmlNameTable.
XmlTextReader(TextReader)	Инициализирует новый экземпляр XmlTextReader класса с указанным TextReader.
XmlTextReader(XmlNameTable)	Инициализирует новый экземпляр XmlTextReader класса с указанным XmlNameTable.

Свойства

Имя	Описание
AttributeCount	Возвращает количество атрибутов на текущем узле.
BaseURI	Возвращает базовый универсальный код ресурса (URI) текущего узла.
CanReadBinaryContent	Возвращает значение, указывающее, реализует ли XmlTextReader методы чтения двоичного содержимого.
CanReadValueChunk	Возвращает значение, указывающее, реализует XmlTextReader ли ReadValueChunk(Char[], Int32, Int32) метод.
CanResolveEntity	Возвращает значение, указывающее, может ли средство чтения анализировать и разрешать сущности.
Depth	Возвращает глубину текущего узла в XML-документе.
DtdProcessing	Возвращает или задает перечисление DtdProcessing .
Encoding	Возвращает кодировку документа.
EntityHandling	Возвращает или задает значение, указывающее, как средство чтения обрабатывает сущности.
EOF	Возвращает значение, указывающее, находится ли средство чтения в конце потока.
HasAttributes	Возвращает значение, указывающее, имеет ли текущий узел какие-либо атрибуты. (Унаследовано от XmlReader)
HasValue	Возвращает значение, указывающее, может ли текущий узел иметь другое ValueString.Emptyзначение.
IsDefault	Возвращает значение, указывающее, является ли текущий узел атрибутом, созданным из значения по умолчанию, определенного в DTD или схеме.
IsEmptyElement	Возвращает значение, указывающее, является ли текущий узел пустым элементом (например, <MyElement/>).
Item[Int32]	При переопределении в производном классе получает значение атрибута с указанным индексом. (Унаследовано от XmlReader)
Item[String, String]	При переопределении в производном классе получает значение атрибута с указанным LocalName и NamespaceURI. (Унаследовано от XmlReader)
Item[String]	При переопределении в производном классе получает значение атрибута с указанным Name. (Унаследовано от XmlReader)
LineNumber	Возвращает текущий номер строки.
LinePosition	Возвращает текущую позицию строки.
LocalName	Возвращает локальное имя текущего узла.
Name	Возвращает полное имя текущего узла.
Namespaces	Возвращает или задает значение, указывающее, следует ли поддерживать пространство имен.
NamespaceURI	Возвращает URI пространства имен (как определено в спецификации пространства имен W3C) узла, на котором размещается средство чтения.
NameTable	Возвращает связанную XmlNameTable с этой реализацией.
NodeType	Возвращает тип текущего узла.
Normalization	Возвращает или задает значение, указывающее, следует ли нормализовать значения пробелов и атрибутов.
Prefix	Возвращает префикс пространства имен, связанный с текущим узлом.
ProhibitDtd	Устаревшие.. Возвращает или задает значение, указывающее, следует ли разрешать обработку DTD. Это свойство устарело. Вместо этого используйте DtdProcessing.
QuoteChar	Возвращает символ кавычки, используемый для заключения значения узла атрибута.
ReadState	Возвращает состояние средства чтения.
SchemaInfo	Возвращает сведения о схеме, назначенные текущему узлу в результате проверки схемы. (Унаследовано от XmlReader)
Settings	Возвращает объект, используемый XmlReaderSettings для создания этого XmlReader экземпляра. (Унаследовано от XmlReader)
Value	Возвращает текстовое значение текущего узла.
ValueType	Возвращает тип среды CLR для текущего узла. (Унаследовано от XmlReader)
WhitespaceHandling	Возвращает или задает значение, указывающее, как обрабатывается пробел.
XmlLang	Возвращает текущую xml:lang область.
XmlResolver	Задает используемый XmlResolver для разрешения ссылок DTD.
XmlSpace	Возвращает текущую xml:space область.

Методы

Имя	Описание
Close()	Изменяет значение ReadStateClosed.
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса XmlReader. (Унаследовано от XmlReader)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые XmlReader и при необходимости освобождает управляемые ресурсы. (Унаследовано от XmlReader)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetAttribute(Int32)	Возвращает значение атрибута с указанным индексом.
GetAttribute(String, String)	Возвращает значение атрибута с указанным локальным именем и URI пространства имен.
GetAttribute(String)	Возвращает значение атрибута с указанным именем.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetNamespacesInScope(XmlNamespaceScope)	Возвращает коллекцию, содержащую все пространства имен в настоящее время в области.
GetRemainder()	Возвращает оставшуюся часть буферизованного XML.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValueAsync()	Асинхронно получает значение текущего узла. (Унаследовано от XmlReader)
HasLineInfo()	Возвращает значение, указывающее, может ли класс возвращать сведения о строке.
IsStartElement()	Вызывает MoveToContent() и проверяет, является ли текущий узел содержимого начальным тегом или пустым тегом элемента. (Унаследовано от XmlReader)
IsStartElement(String, String)	Вызывает MoveToContent() и проверяет, является ли текущий узел содержимого начальным тегом или пустым тегом элемента, а также если LocalNameNamespaceURI найденные свойства элемента соответствуют заданным строкам. (Унаследовано от XmlReader)
IsStartElement(String)	Вызывает MoveToContent() и проверяет, является ли текущий узел содержимого начальным тегом или пустым тегом элемента, и если Name свойство элемента найдено соответствует заданному аргументу. (Унаследовано от XmlReader)
LookupNamespace(String)	Разрешает префикс пространства имен в области текущего элемента.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MoveToAttribute(Int32)	Перемещается к атрибуту с указанным индексом.
MoveToAttribute(String, String)	Перемещается к атрибуту с указанным локальным именем и URI пространства имен.
MoveToAttribute(String)	Перемещается к атрибуту с указанным именем.
MoveToContent()	Проверяет, является ли текущий узел содержимым (текст без пробелов, CDATA, , ElementEndElementили EntityReferenceEndEntity) узла. Если узел не является узлом содержимого, читатель пропускает следующий узел содержимого или конец файла. Он пропускает узлы следующего типа: ProcessingInstruction, DocumentType, Comment, Whitespaceили SignificantWhitespace. (Унаследовано от XmlReader)
MoveToContentAsync()	Асинхронно проверяет, является ли текущий узел узлом содержимого. Если узел не является узлом содержимого, читатель пропускает следующий узел содержимого или конец файла. (Унаследовано от XmlReader)
MoveToElement()	Перемещается в элемент, содержащий текущий узел атрибута.
MoveToFirstAttribute()	Перемещается к первому атрибуту.
MoveToNextAttribute()	Переходит к следующему атрибуту.
Read()	Считывает следующий узел из потока.
ReadAsync()	Асинхронно считывает следующий узел из потока. (Унаследовано от XmlReader)
ReadAttributeValue()	Анализирует значение атрибута на один или несколько TextEntityReferenceузлов или EndEntity узлов.
ReadBase64(Byte[], Int32, Int32)	Декодирует Base64 и возвращает декодированные двоичные байты.
ReadBinHex(Byte[], Int32, Int32)	Декодирует BinHex и возвращает декодированные двоичные байты.
ReadChars(Char[], Int32, Int32)	Считывает текстовое содержимое элемента в буфер символов. Этот метод предназначен для чтения больших потоков внедренного текста путем его последовательного вызова.
ReadContentAs(Type, IXmlNamespaceResolver)	Считывает содержимое в виде объекта указанного типа. (Унаследовано от XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)	Асинхронно считывает содержимое как объект указанного типа. (Унаследовано от XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	Считывает содержимое и возвращает декодированные двоичные Base64 байты.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Асинхронно считывает содержимое и возвращает декодированные двоичные байты Base64. (Унаследовано от XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	Считывает содержимое и возвращает декодированные двоичные BinHex байты.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Асинхронно считывает содержимое и возвращает декодированные двоичные BinHex байты. (Унаследовано от XmlReader)
ReadContentAsBoolean()	Считывает текстовое содержимое в текущей позиции в виде Boolean. (Унаследовано от XmlReader)
ReadContentAsDateTime()	Считывает текстовое содержимое в текущей DateTime позиции в качестве объекта. (Унаследовано от XmlReader)
ReadContentAsDateTimeOffset()	Считывает текстовое содержимое в текущей DateTimeOffset позиции в качестве объекта. (Унаследовано от XmlReader)
ReadContentAsDecimal()	Считывает текстовое содержимое в текущей Decimal позиции в качестве объекта. (Унаследовано от XmlReader)
ReadContentAsDouble()	Считывает текстовое содержимое в текущей позиции в виде числа с плавающей запятой двойной точности. (Унаследовано от XmlReader)
ReadContentAsFloat()	Считывает текстовое содержимое в текущей позиции в виде числа с плавающей запятой с одной точностью. (Унаследовано от XmlReader)
ReadContentAsInt()	Считывает текстовое содержимое в текущей позиции в виде 32-разрядного целого числа со знаком. (Унаследовано от XmlReader)
ReadContentAsLong()	Считывает текстовое содержимое в текущей позиции в виде 64-разрядного целого числа со знаком. (Унаследовано от XmlReader)
ReadContentAsObject()	Считывает текстовое содержимое в текущей позиции в качестве Object. (Унаследовано от XmlReader)
ReadContentAsObjectAsync()	Асинхронно считывает текстовое содержимое в текущей позиции в качестве Object. (Унаследовано от XmlReader)
ReadContentAsString()	Считывает текстовое содержимое в текущей String позиции в качестве объекта. (Унаследовано от XmlReader)
ReadContentAsStringAsync()	Асинхронно считывает текстовое содержимое в текущей String позиции в качестве объекта. (Унаследовано от XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Проверяет, соответствует ли указанный локальный URI и URI пространства имен текущему элементу, а затем считывает содержимое элемента в качестве запрошенного типа. (Унаследовано от XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	Считывает содержимое элемента в качестве запрошенного типа. (Унаследовано от XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Асинхронно считывает содержимое элемента в качестве запрошенного типа. (Унаследовано от XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	Считывает элемент и декодирует содержимое Base64.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Асинхронно считывает элемент и декодирует содержимое Base64 . (Унаследовано от XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	Считывает элемент и декодирует содержимое BinHex .
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Асинхронно считывает элемент и декодирует содержимое BinHex . (Унаследовано от XmlReader)
ReadElementContentAsBoolean()	Считывает текущий элемент и возвращает содержимое в виде Boolean объекта. (Унаследовано от XmlReader)
ReadElementContentAsBoolean(String, String)	Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде Boolean объекта. (Унаследовано от XmlReader)
ReadElementContentAsDateTime()	Считывает текущий элемент и возвращает содержимое в виде DateTime объекта. (Унаследовано от XmlReader)
ReadElementContentAsDateTime(String, String)	Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде DateTime объекта. (Унаследовано от XmlReader)
ReadElementContentAsDecimal()	Считывает текущий элемент и возвращает содержимое в виде Decimal объекта. (Унаследовано от XmlReader)
ReadElementContentAsDecimal(String, String)	Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде Decimal объекта. (Унаследовано от XmlReader)
ReadElementContentAsDouble()	Считывает текущий элемент и возвращает содержимое в виде числа с плавающей запятой двойной точности. (Унаследовано от XmlReader)
ReadElementContentAsDouble(String, String)	Проверяет, соответствует ли указанный локальный URI имени и пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде числа с плавающей запятой двойной точности. (Унаследовано от XmlReader)
ReadElementContentAsFloat()	Считывает текущий элемент и возвращает содержимое в виде числа с плавающей запятой с одной точностью. (Унаследовано от XmlReader)
ReadElementContentAsFloat(String, String)	Проверяет, соответствует ли указанный локальный URI и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде числа с плавающей запятой с одной точностью. (Унаследовано от XmlReader)
ReadElementContentAsInt()	Считывает текущий элемент и возвращает содержимое в виде 32-разрядного целого числа со знаком. (Унаследовано от XmlReader)
ReadElementContentAsInt(String, String)	Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде 32-разрядного целого числа со знаком. (Унаследовано от XmlReader)
ReadElementContentAsLong()	Считывает текущий элемент и возвращает содержимое в виде 64-разрядного целого числа со знаком. (Унаследовано от XmlReader)
ReadElementContentAsLong(String, String)	Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде 64-разрядного целого числа со знаком. (Унаследовано от XmlReader)
ReadElementContentAsObject()	Считывает текущий элемент и возвращает содержимое в виде Object. (Унаследовано от XmlReader)
ReadElementContentAsObject(String, String)	Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде Object. (Унаследовано от XmlReader)
ReadElementContentAsObjectAsync()	Асинхронно считывает текущий элемент и возвращает содержимое в виде Object. (Унаследовано от XmlReader)
ReadElementContentAsString()	Считывает текущий элемент и возвращает содержимое в виде String объекта. (Унаследовано от XmlReader)
ReadElementContentAsString(String, String)	Проверяет, соответствует ли указанный локальный и URI пространства имен текущему элементу, а затем считывает текущий элемент и возвращает содержимое в виде String объекта. (Унаследовано от XmlReader)
ReadElementContentAsStringAsync()	Асинхронно считывает текущий элемент и возвращает содержимое в виде String объекта. (Унаследовано от XmlReader)
ReadElementString()	Считывает элемент только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString() метод, так как он предоставляет более простой способ обработки этой операции. (Унаследовано от XmlReader)
ReadElementString(String, String)	Проверяет, соответствует ли LocalName найденный элемент и NamespaceURI свойства заданным строкам перед чтением элемента только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString(String, String) метод, так как он предоставляет более простой способ обработки этой операции. (Унаследовано от XmlReader)
ReadElementString(String)	Проверяет, соответствует ли Name свойство элемента заданной строке перед чтением элемента только для текста. Однако вместо этого рекомендуется использовать ReadElementContentAsString() метод, так как он предоставляет более простой способ обработки этой операции. (Унаследовано от XmlReader)
ReadEndElement()	Проверяет, является ли текущий узел содержимого конечным тегом и перемещает читателя к следующему узлу. (Унаследовано от XmlReader)
ReadInnerXml()	При переопределении в производном классе считывает все содержимое, включая разметку, в виде строки. (Унаследовано от XmlReader)
ReadInnerXmlAsync()	Асинхронно считывает все содержимое, включая разметку, в виде строки. (Унаследовано от XmlReader)
ReadOuterXml()	При переопределении в производном классе считывает содержимое, включая разметку, представляющую этот узел и все его дочерние элементы. (Унаследовано от XmlReader)
ReadOuterXmlAsync()	Асинхронно считывает содержимое, включая разметку, представляющую этот узел и все его дочерние элементы. (Унаследовано от XmlReader)
ReadStartElement()	Проверяет, является ли текущий узел элементом и перемещает читателя к следующему узлу. (Унаследовано от XmlReader)
ReadStartElement(String, String)	Проверяет, является ли текущий узел содержимого элементом с заданным LocalName и NamespaceURI перемещает читателя к следующему узлу. (Унаследовано от XmlReader)
ReadStartElement(String)	Проверяет, является ли текущий узел содержимого элементом с заданным Name и перемещает читателя к следующему узлу. (Унаследовано от XmlReader)
ReadString()	Считывает содержимое элемента или текстового узла в виде строки.
ReadSubtree()	Возвращает новый XmlReader экземпляр, который можно использовать для чтения текущего узла и всех его потомков. (Унаследовано от XmlReader)
ReadToDescendant(String, String)	XmlReader Перемещается к следующему элементу-потомку с указанным локальным именем и URI пространства имен. (Унаследовано от XmlReader)
ReadToDescendant(String)	XmlReader Перемещается к следующему элементу-потомку с указанным полным именем. (Унаследовано от XmlReader)
ReadToFollowing(String, String)	Считывает, пока не будет найден элемент с указанным локальным именем и URI пространства имен. (Унаследовано от XmlReader)
ReadToFollowing(String)	Считывает до тех пор, пока не будет найден элемент с указанным полным именем. (Унаследовано от XmlReader)
ReadToNextSibling(String, String)	XmlReader Перемещается к следующему элементу с одноуровневыми элементами с указанным локальным именем и URI пространства имен. (Унаследовано от XmlReader)
ReadToNextSibling(String)	XmlReader Перемещается к следующему элементу с одинаковым именем. (Унаследовано от XmlReader)
ReadValueChunk(Char[], Int32, Int32)	Считывает большие потоки текста, внедренного в XML-документ. (Унаследовано от XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	Асинхронно считывает большие потоки текста, внедренного в XML-документ. (Унаследовано от XmlReader)
ResetState()	Сбрасывает состояние средства чтения на ReadState.Initial.
ResolveEntity()	Разрешает ссылку на сущность для EntityReference узлов.
Skip()	Пропускает дочерние элементы текущего узла.
SkipAsync()	Асинхронно пропускает дочерние элементы текущего узла. (Унаследовано от XmlReader)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Явные реализации интерфейса

Имя	Описание
IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	Описание этого элемента см. в разделе GetNamespacesInScope(XmlNamespaceScope).
IXmlNamespaceResolver.LookupNamespace(String)	Описание этого элемента см. в разделе LookupNamespace(String).
IXmlNamespaceResolver.LookupPrefix(String)	Описание этого элемента см. в разделе LookupPrefix(String).

См. также раздел

• XML-документы и данные