XmlReader.ReadElementContentAsDateTime Метод

Определение

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

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

Перегрузки

Имя Описание
ReadElementContentAsDateTime()

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

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

ReadElementContentAsDateTime()

Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs

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

Note

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

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

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

ReadElementContentAsDateTime(String, String)

Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs
Исходный код:
XmlReader.cs

Проверяет, соответствует ли указанный локальный и 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 пространства имен не соответствуют URI текущего элемента, считываемого.

Комментарии

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

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

Note

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

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

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