XmlReader.ReadContentAsDateTime Método

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Lê o conteúdo de texto na posição atual como um objeto DateTime.

public:
 virtual DateTime ReadContentAsDateTime();

public virtual DateTime ReadContentAsDateTime ();

abstract member ReadContentAsDateTime : unit -> DateTime
override this.ReadContentAsDateTime : unit -> DateTime

Public Overridable Function ReadContentAsDateTime () As DateTime

Retornos

DateTime

O conteúdo de texto como um objeto DateTime.

Exceções

InvalidCastException

A tentativa de conversão não é válida.

FormatException

O formato da cadeia de caracteres não é válido.

InvalidOperationException

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

Comentários

Esse método concatena o texto, o espaço em branco, o espaço em branco significativo e as seções CDATA e ignora quaisquer comentários ou instruções de processamento. As referências de entidade são resolvidas automaticamente.

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.

A tabela a seguir descreve como esse método trata cada tipo de nó.

XmlNodeType	Valor retornado	Comportamento do leitor
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Concatenado conteúdo de texto, de CDATA, de espaço em branco e os nós significativos de espaço em branco convertidos para o tipo solicitado.	Move para a seguir marca de início ou elemento de extremidade. Referências a entidades são automaticamente expandidas.
Attribute	O mesmo que chamar XmlConvert.ToXxx no valor do atributo.	O leitor permanece na posição atual.
Comment ProcessingInstruction	Ignora a instrução de processamento (PI) ou o comentário e ler o conteúdo concatenado de texto que segue o PI ou o comentário.	Move para a seguir marca de início ou elemento de extremidade. Referências a entidades são automaticamente expandidas.
EndElement	Uma cadeia de caracteres vazia.	O leitor permanece na posição atual.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	InvalidOperationException é lançada.	Indefinido, embora geralmente o leitor permaneça na posição atual.

Para obter mais informações, consulte a XmlReader página de referência e a recomendação W3C XML Schema Part 2: Datatypes .