XmlReader.ReadElementContentAs Метод

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

Перегрузки

Имя	Описание
ReadElementContentAs(Type, IXmlNamespaceResolver)	Считывает содержимое элемента в качестве запрошенного типа.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Проверяет, соответствует ли указанный локальный URI и URI пространства имен текущему элементу, а затем считывает содержимое элемента в качестве запрошенного типа.

ReadElementContentAs(Type, IXmlNamespaceResolver)

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

XmlReader.cs

Считывает содержимое элемента в качестве запрошенного типа.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);

public virtual object ReadElementContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

Параметры

returnType

Type

Тип возвращаемого значения.

Примечание После выпуска .NET Framework 3.5 значение returnType параметра теперь может быть типом DateTimeOffset .

namespaceResolver

IXmlNamespaceResolver

Объект IXmlNamespaceResolver , используемый для разрешения префиксов пространства имен, связанных с преобразованием типов.

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

Object

Содержимое элемента, преобразованное в запрошенный типизированный объект.

Исключения

InvalidOperationException

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

–или–

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

XmlException

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

–или–

Содержимое элемента невозможно преобразовать в запрошенный тип.

ArgumentNullException

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

OverflowException

Чтение Decimal.MaxValue.

Примеры

В следующем примере метод используется ReadElementContentAs для чтения содержимого date узла.

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());	
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
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>

Комментарии

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

Дополнительные сведения см. в разделе "Примечания" эталонной XmlReader страницы и рекомендации по xml-схеме W3C 2.

Сведения об асинхронной версии этого метода см. в разделе ReadElementContentAsAsync.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

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

XmlReader.cs

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

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver, System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver, string localName, string namespaceURI);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As Object

Параметры

returnType

Type

Тип возвращаемого значения.

Примечание После выпуска .NET Framework 3.5 значение returnType параметра теперь может быть типом DateTimeOffset .

namespaceResolver

IXmlNamespaceResolver

Объект IXmlNamespaceResolver , используемый для разрешения префиксов пространства имен, связанных с преобразованием типов.

localName

String

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

namespaceURI

String

URI пространства имен элемента.

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

Object

Содержимое элемента, преобразованное в запрошенный типизированный объект.

Исключения

InvalidOperationException

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

–или–

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

XmlException

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

–или–

Содержимое элемента невозможно преобразовать в запрошенный тип.

ArgumentNullException

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

ArgumentException

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

OverflowException

Чтение Decimal.MaxValue.

Комментарии

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

Дополнительные сведения см. в разделе "Примечания" эталонной XmlReader страницы и рекомендации по xml-схеме W3C 2.