XmlReader.ReadElementContentAsDateTime Метод

Определение

Считывает текущий элемент и возвращает содержимое объекта 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.

Исключения

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

-или-

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

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

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

Метод вызван с аргументами 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, часть 2: типы данных.

Примечание

Не следует полагаться на значение свойства 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.

Исключения

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

-или-

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

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

-или-

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

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

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

Комментарии

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

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

Примечание

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

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

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