XmlReader.ReadElementContentAsDateTime Método

  • Referência

Definição

Namespace:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Lê o elemento atual e retorna o conteúdo como um objeto DateTime.

Sobrecargas

ReadElementContentAsDateTime()

Lê o elemento atual e retorna o conteúdo como um objeto DateTime.
ReadElementContentAsDateTime(String, String)

Verifica se o nome do local especificado e o URI de namespace correspondem àqueles do elemento atual, em seguida, lê o elemento atual e retorna o conteúdo como um objeto DateTime.

ReadElementContentAsDateTime()

Lê o elemento atual e retorna o conteúdo como um objeto 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

Retornos

DateTime

O elemento de conteúdo como um objeto DateTime.

Exceções

InvalidOperationException

O XmlReader não está posicionado em um elemento.

- ou -

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

XmlException

O elemento atual contém elementos filho.

- ou -

O conteúdo do elemento não pode ser convertido em um objeto DateTime.

ArgumentNullException

O método é chamado com os argumentos null.

Exemplos

O exemplo a seguir usa o ReadElementContentAsDateTime método para ler o conteúdo do date elemento.

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

O exemplo usa o arquivo dataFile.xml como entrada.

<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>

Comentários

Esse método lê a marca de início, o conteúdo do elemento e move o leitor para além da marca do elemento final. Ele expande entidades e ignora instruções de processamento e comentários. O elemento só pode conter conteúdo simples. Ou seja, não pode ter elementos filho.

Se o conteúdo for digitado xsd:dateTime, o leitor retornará um objeto sem caixa DateTime . Se o conteúdo não for digitado xsd:dateTime, o leitor tentará convertê-lo em um DateTime objeto de acordo com as regras definidas pela recomendação W3C XML Schema Part 2: Datatypes .

Observação

Você não pode depender no valor de DateTime.Year quando o conteúdo está digitado como xsd:gMonthDay. XmlReader sempre define o DateTime.Year valor como 1904 nesse caso.

Para obter mais informações, consulte a seção de Comentários da página de referência XmlReader.

Aplica-se a

ReadElementContentAsDateTime(String, String)

Verifica se o nome do local especificado e o URI de namespace correspondem àqueles do elemento atual, em seguida, lê o elemento atual e retorna o conteúdo como um objeto 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

Parâmetros

localName
String

O nome local do elemento.

namespaceURI
String

O URI do namespace do elemento.

Retornos

DateTime

O conteúdo do elemento como um objeto DateTime.

Exceções

InvalidOperationException

O XmlReader não está posicionado em um elemento.

- ou -

Um método XmlReader foi chamado antes do término de uma operação assíncrona anterior. Nesse caso, InvalidOperationException será gerado com a mensagem “Uma operação assíncrona já está em andamento”.

XmlException

O elemento atual contém elementos filho.

- ou -

Não é possível converter o conteúdo do elemento no tipo solicitado.

ArgumentNullException

O método é chamado com os argumentos null.

ArgumentException

O nome do local especificado e o URI de namespace não correspondem àqueles do elemento atual que está sendo lido.

Comentários

Esse método lê a marca de início, o conteúdo do elemento e move o leitor para além da marca do elemento final. Ele expande entidades e ignora instruções de processamento e comentários. O elemento só pode conter conteúdo simples. Ou seja, não pode ter elementos filho.

Se o conteúdo for digitado xsd:dateTime, o leitor retornará um objeto sem caixa DateTime . Se o conteúdo não for digitado xsd:dateTime, o leitor tentará convertê-lo em um DateTime objeto de acordo com as regras definidas pela recomendação W3C XML Schema Part 2: Datatypes .

Observação

Você não pode depender no valor de DateTime.Year quando o conteúdo está digitado como xsd:gMonthDay. XmlReader sempre define o DateTime.Year valor como 1904 nesse caso.

Para obter mais informações, consulte a seção de Comentários da página de referência XmlReader.

Aplica-se a