XmlReader.ReadContentAsDateTime Método

Referência

Definição

Namespace:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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 .

Aplica-se a

Compartilhar via