XmlReader.ReadElementContentAsDateTime Метод

  • Ссылка

Определение

Пространство имен:
System.Xml
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll

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

Перегрузки

ReadElementContentAsDateTime()

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

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

ReadElementContentAsDateTime()

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

public:
 virtual DateTime ReadElementContentAsDateTime();
public virtual DateTime ReadElementContentAsDateTime ();
abstract member ReadElementContentAsDateTime : unit -> DateTime
override this.ReadElementContentAsDateTime : unit -> DateTime
Public Overridable Function ReadElementContentAsDateTime () As DateTime

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

DateTime

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

Исключения

InvalidOperationException

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

-или-

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

XmlException

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

-или-

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

ArgumentNullException

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

Примеры

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

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = reader.ReadElementContentAsDateTime();
  
     // 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 = reader.ReadElementContentAsDateTime()
            
  ' 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>

Комментарии

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

Если содержимое введено xsd:dateTime, средство чтения возвращает несоотвленный DateTime объект. Если содержимое не введено xsd:dateTime, средство чтения пытается преобразовать его в DateTime объект в соответствии с правилами, определенными в рекомендации W3C XML Schema Part 2: Datatypes .

Примечание

Не следует полагаться на значение свойства DateTime.Year, когда содержимое типизируется как xsd:gMonthDay. XmlReader всегда задает DateTime.Year значение 1904 в данном случае.

Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.

Применяется к

ReadElementContentAsDateTime(String, String)

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

public:
 virtual DateTime ReadElementContentAsDateTime(System::String ^ localName, System::String ^ namespaceURI);
public virtual DateTime ReadElementContentAsDateTime (string localName, string namespaceURI);
abstract member ReadElementContentAsDateTime : string * string -> DateTime
override this.ReadElementContentAsDateTime : string * string -> DateTime
Public Overridable Function ReadElementContentAsDateTime (localName As String, namespaceURI As String) As DateTime

Параметры

localName
String

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

namespaceURI
String

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

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

DateTime

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

Исключения

InvalidOperationException

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

-или-

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

XmlException

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

-или-

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

ArgumentNullException

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

ArgumentException

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

Комментарии

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

Если содержимое введено xsd:dateTime, средство чтения возвращает несоотвленный DateTime объект. Если содержимое не введено xsd:dateTime, средство чтения пытается преобразовать его в DateTime объект в соответствии с правилами, определенными в рекомендации W3C XML Schema Part 2: Datatypes .

Примечание

Не следует полагаться на значение свойства DateTime.Year, когда содержимое типизируется как xsd:gMonthDay. XmlReader всегда задает DateTime.Year значение 1904 в данном случае.

Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.

Применяется к