XmlTextReader Класс

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

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

XmlTextReader.cs

Предоставляет средство чтения, обеспечивающее быстрый прямой доступ (без кэширования) к данным XML.

Начиная с .NET Framework версии 2.0 рекомендуется использовать класс 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)	Инициализирует новый экземпляр класса XmlTextReader с указанным потоком.
XmlTextReader(Stream, XmlNameTable)	Инициализирует новый экземпляр класса XmlTextReader с указанными потоком и XmlNameTable.
XmlTextReader(Stream, XmlNodeType, XmlParserContext)	Инициализирует новый экземпляр класса XmlTextReader с указанными потоком, XmlNodeType и XmlParserContext.
XmlTextReader(String)	Инициализирует новый экземпляр класса XmlTextReader указанным именем файла.
XmlTextReader(String, Stream)	Инициализирует новый экземпляр класса XmlTextReader с указанным URL-адресом и потоком.
XmlTextReader(String, Stream, XmlNameTable)	Инициализирует новый экземпляр класса XmlTextReader с указанными URL-адресом, потоком и XmlNameTable.
XmlTextReader(String, TextReader)	Инициализирует новый экземпляр класса XmlTextReader с указанным URL-адресом и TextReader.
XmlTextReader(String, TextReader, XmlNameTable)	Инициализирует новый экземпляр класса XmlTextReader с указанным URL-адресом, TextReader и XmlNameTable.
XmlTextReader(String, XmlNameTable)	Инициализирует новый экземпляр класса XmlTextReader с указанным файлом и XmlNameTable.
XmlTextReader(String, XmlNodeType, XmlParserContext)	Инициализирует новый экземпляр класса XmlTextReader с указанной строкой, XmlNodeType и XmlParserContext.
XmlTextReader(TextReader)	Инициализирует новый экземпляр класса XmlTextReader указанным значением TextReader.
XmlTextReader(TextReader, XmlNameTable)	Инициализирует новый экземпляр класса XmlTextReader с заданными свойствами TextReader и XmlNameTable.
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	Возвращает значение, определяющие наличие у текущего узла свойства Value, значение которого отличается от String.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 Namespace) узла, на который позиционировано средство чтения.
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()	Изменяет значение свойства ReadState на Closed.
Dispose()	Освобождает все ресурсы, используемые текущим экземпляром класса XmlReader. (Унаследовано от XmlReader)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом XmlReader, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от XmlReader)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetAttribute(Int32)	Возвращает значение атрибута по заданному индексу.
GetAttribute(String)	Возвращает значение атрибута с указанным именем.
GetAttribute(String, String)	Возвращает значение атрибута с указанным локальным именем и универсальным кодом ресурса (URI) пространства имен.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetNamespacesInScope(XmlNamespaceScope)	Возвращает коллекцию, содержащую все пространства имен, которые в настоящий момент находятся в области видимости.
GetRemainder()	Возвращает оставшуюся часть XML-кода, находящегося в буфере.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetValueAsync()	Асинхронно возвращает значение текущего узла. (Унаследовано от XmlReader)
HasLineInfo()	Возвращает значение, определяющее возможность возвращения классом сведений о строке.
IsStartElement()	Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента. (Унаследовано от XmlReader)
IsStartElement(String)	Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента, а также соответствует ли значение свойства Name элемента заданному аргументу. (Унаследовано от XmlReader)
IsStartElement(String, String)	Вызывает метод MoveToContent() и проверяет, является ли текущий узел содержимого открывающим тегом или пустым тегом элемента, а также соответствуют ли значения свойств LocalName и NamespaceURI элемента заданным строкам. (Унаследовано от XmlReader)
LookupNamespace(String)	Разрешает префикс пространства имен в области видимости текущего элемента.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
MoveToAttribute(Int32)	Переходит к атрибуту с указанным индексом.
MoveToAttribute(String)	Переходит к атрибуту с указанным именем.
MoveToAttribute(String, String)	Переходит к атрибуту с указанным локальным именем и URI пространства имен.
MoveToContent()	Проверяет, является ли текущий узел узлом содержимого (текст без пустого пространства, CDATA, Element, EndElement, EntityReference или EndEntity). Если узел не является узлом содержимого, средство чтения пропускает этот узел и переходит к следующему узлу содержимого или в конец файла. Пропускаются узлы следующих типов: ProcessingInstruction, DocumentType, Comment, Whitespace и SignificantWhitespace. (Унаследовано от XmlReader)
MoveToContentAsync()	В асинхронном режиме проверяет, является ли текущий узел узлом содержимого. Если узел не является узлом содержимого, средство чтения пропускает этот узел и переходит к следующему узлу содержимого или в конец файла. (Унаследовано от XmlReader)
MoveToElement()	Переходит к элементу, содержащему текущий узел атрибута.
MoveToFirstAttribute()	Переходит к первому атрибуту.
MoveToNextAttribute()	Переходит к следующему атрибуту.
Read()	Считывает следующий узел из потока.
ReadAsync()	Асинхронно считывает следующий узел из потока. (Унаследовано от XmlReader)
ReadAttributeValue()	Разбирает значение атрибута в один или несколько узлов Text, EntityReference или 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)	Считывает содержимое элемента в качестве требуемого типа. (Унаследовано от XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Проверяет, совпадают ли указанные локальное имя и URI пространства имен с таковыми для текущего элемента, затем считывает содержимое элемента как требуемый тип. (Унаследовано от 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 локального имени и пространства имен с URI текущего элемента, затем считывает текущий элемент и возвращает содержимое как объект Boolean. (Унаследовано от XmlReader)
ReadElementContentAsDateTime()	Считывает текущий элемент и возвращает содержимое объекта DateTime. (Унаследовано от XmlReader)
ReadElementContentAsDateTime(String, String)	Проверяет соответствие указанного URI локального имени и пространства имен с URI текущего элемента, затем считывает текущий элемент и возвращает содержимое как объект DateTime. (Унаследовано от XmlReader)
ReadElementContentAsDecimal()	Считывает текущий элемент и возвращает содержимое объекта Decimal. (Унаследовано от XmlReader)
ReadElementContentAsDecimal(String, String)	Проверяет соответствие указанного URI локального имени и пространства имен с URI текущего элемента, затем считывает текущий элемент и возвращает содержимое как объект Decimal. (Унаследовано от XmlReader)
ReadElementContentAsDouble()	Считывает текущий элемент и возвращает содержимое как число с плавающей запятой двойной точности. (Унаследовано от XmlReader)
ReadElementContentAsDouble(String, String)	Проверяет, совпадают ли указанные локальное имя и URI пространства имен с таковыми для текущего элемента, затем считывает текущий элемент и возвращает содержимое как число с плавающей запятой двойной точности. (Унаследовано от XmlReader)
ReadElementContentAsFloat()	Считывает текущий элемент и возвращает содержимое как число с плавающей запятой одиночной точности. (Унаследовано от XmlReader)
ReadElementContentAsFloat(String, String)	Проверяет, совпадают ли указанные локальное имя и 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 локального имени и пространства имен с URI текущего элемента, затем считывает текущий элемент и возвращает содержимое как объект Object. (Унаследовано от XmlReader)
ReadElementContentAsObjectAsync()	Асинхронно считывает текущий элемент и возвращает содержимое как объект Object. (Унаследовано от XmlReader)
ReadElementContentAsString()	Считывает текущий элемент и возвращает содержимое объекта String. (Унаследовано от XmlReader)
ReadElementContentAsString(String, String)	Проверяет соответствие указанного URI локального имени и пространства имен с URI текущего элемента, затем считывает текущий элемент и возвращает содержимое как объект String. (Унаследовано от XmlReader)
ReadElementContentAsStringAsync()	Асинхронно считывает текущий элемент и возвращает содержимое как объект String. (Унаследовано от XmlReader)
ReadElementString()	Считывает элемент, предназначенный только для чтения. Однако рекомендуем использовать вместо этого метод ReadElementContentAsString(), предполагающий более простой способ обработки данной операции. (Унаследовано от XmlReader)
ReadElementString(String)	Проверяет перед чтением текстового элемента соответствие значения свойства Name найденного элемента и заданной строки. Однако рекомендуем использовать вместо этого метод ReadElementContentAsString(), предполагающий более простой способ обработки данной операции. (Унаследовано от XmlReader)
ReadElementString(String, String)	Проверяет перед чтением текстового элемента соответствие значений свойств LocalName и NamespaceURI найденного элемента и заданных строк. Однако рекомендуем использовать вместо этого метод ReadElementContentAsString(String, String), предполагающий более простой способ обработки данной операции. (Унаследовано от XmlReader)
ReadEndElement()	Проверяет, является ли текущий узел содержимого закрывающим тегом, и позиционирует средство чтения на следующий узел. (Унаследовано от XmlReader)
ReadInnerXml()	Когда переопределено в производном классе, считывает как строку все содержимое, включая разметку. (Унаследовано от XmlReader)
ReadInnerXmlAsync()	Асинхронно считывает в виде строки все содержимое, включая разметку. (Унаследовано от XmlReader)
ReadOuterXml()	Когда переопределено в производном классе, считывает содержимое, включая разметку, представляющую этот узел и все его дочерние узлы. (Унаследовано от XmlReader)
ReadOuterXmlAsync()	Асинхронно считывает содержимое, включая разметку, представляющее этот узел и все его дочерние узлы. (Унаследовано от XmlReader)
ReadStartElement()	Проверяет, является ли текущий узел элементом и перемещает модуль чтения к следующему узлу. (Унаследовано от XmlReader)
ReadStartElement(String)	Проверяет, является ли текущий узел элементом с заданным Name, и перемещает средство чтения на следующий узел. (Унаследовано от XmlReader)
ReadStartElement(String, String)	Проверяет, является ли текущий узел элементом с заданным LocalName и NamespaceURI, и перемещает средство чтения на следующий узел. (Унаследовано от XmlReader)
ReadString()	Считывает содержимое элемента или текстового узла в виде строки.
ReadSubtree()	Возвращает новый экземпляр XmlReader, который может использоваться для считывания текущего узла и всех его потомков. (Унаследовано от XmlReader)
ReadToDescendant(String)	Переводит XmlReader к следующему сопоставленному элементу-потомку с указанным проверенным именем. (Унаследовано от XmlReader)
ReadToDescendant(String, String)	Переводит XmlReader к следующему элементу-потомку с указанным локальным именем и URI пространства имен. (Унаследовано от XmlReader)
ReadToFollowing(String)	Выполняет чтение до обнаружения элемента с указанным полным именем. (Унаследовано от XmlReader)
ReadToFollowing(String, String)	Выполняет чтение до обнаружения указанных локального имени и URI пространства имен. (Унаследовано от XmlReader)
ReadToNextSibling(String)	Переводит XmlReader к следующему сопоставленному родственному элементу с указанным проверенным именем. (Унаследовано от XmlReader)
ReadToNextSibling(String, String)	Переводит XmlReader к следующему элементу того же уровня с указанным локальным именем и URI пространства имен. (Унаследовано от 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-документы и данные