XmlReader.ReadElementContentAsString Метод

Определение

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

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Считывает текущий элемент и возвращает содержимое объекта String.

Перегрузки

ReadElementContentAsString(String, String)	Проверяет соответствие указанного URI локального имени и пространства имен с URI текущего элемента, затем считывает текущий элемент и возвращает содержимое как объект String.
ReadElementContentAsString()	Считывает текущий элемент и возвращает содержимое объекта String.

ReadElementContentAsString(String, String)

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

XmlReader.cs

Проверяет соответствие указанного URI локального имени и пространства имен с URI текущего элемента, затем считывает текущий элемент и возвращает содержимое как объект String.

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);

public virtual string ReadElementContentAsString (string localName, string namespaceURI);

abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string

Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

Параметры

localName

String

Локальное имя элемента.

namespaceURI

String

Универсальный код ресурса (URI) пространства имен элемента.

Возвращаемое значение

String

Содержимое элемента в виде объекта String.

Исключения

InvalidOperationException

Объект XmlReader не расположен на элементе.

-или-

Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

XmlException

Текущий элемент содержит дочерние элементы.

-или-

Содержимое элемента нельзя преобразовать в объект String.

ArgumentNullException

Метод вызван с аргументами null.

ArgumentException

Указанное локальное имя и URI пространства имен не совпадают с аналогичными параметрами текущего считываемого элемента.

Примеры

В следующем примере считывается stringValue элемент и возвращается текстовое содержимое (игнорируя комментарий и инструкцию по обработке).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

В примере в качестве входных данных используется файл dataFile.xml.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Комментарии

Этот метод считывает тег start, содержимое элемента и перемещает средство чтения за тег конечного элемента. Он расширяет сущности и игнорирует инструкции и комментарии по обработке. Элемент может содержать только простое содержимое. То есть он не может содержать дочерние элементы.

Дополнительные сведения см. в разделе "Примечания" справочной XmlReader страницы и в рекомендации W3C XML Schema Part 2: Datatypes (Схема XML W3C, часть 2. Типы данных ).

ReadElementContentAsString()

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

XmlReader.cs

Считывает текущий элемент и возвращает содержимое объекта String.

public:
 virtual System::String ^ ReadElementContentAsString();

public virtual string ReadElementContentAsString ();

abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string

Public Overridable Function ReadElementContentAsString () As String

Возвращаемое значение

String

Содержимое элемента в виде объекта String.

Исключения

InvalidOperationException

Объект XmlReader не расположен на элементе.

-или-

Метод XmlReader вызван перед завершением предыдущей асинхронной операции. В этом случае возникает исключение InvalidOperationException с сообщением "Асинхронная операция уже выполняется".

XmlException

Текущий элемент содержит дочерние элементы.

-или-

Содержимое элемента нельзя преобразовать в объект String.

ArgumentNullException

Метод вызван с аргументами null.

Примеры

В следующем примере считывается stringValue элемент и возвращается текстовое содержимое (игнорируя комментарий и инструкцию по обработке).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

В примере в качестве входных данных используется файл dataFile.xml.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Комментарии

Этот метод считывает тег start, содержимое элемента и перемещает средство чтения за тег конечного элемента. Он расширяет сущности и игнорирует инструкции и комментарии по обработке. Элемент может содержать только простое содержимое. То есть он не может содержать дочерние элементы.

Дополнительные сведения см. в разделе "Примечания" справочной XmlReader страницы и в рекомендации W3C XML Schema Part 2: Datatypes (Схема XML W3C, часть 2. Типы данных ).

Асинхронную версию этого метода см. в разделе ReadElementContentAsStringAsync.