XmlReader.ReadContentAsDateTime Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Lê o conteúdo do texto na posição atual como um DateTime objeto.
public:
virtual DateTime ReadContentAsDateTime();
public virtual DateTime ReadContentAsDateTime();
abstract member ReadContentAsDateTime : unit -> DateTime
override this.ReadContentAsDateTime : unit -> DateTime
Public Overridable Function ReadContentAsDateTime () As DateTime
Devoluções
O conteúdo do texto como um DateTime objeto.
Exceções
A tentativa de lançamento não é válida.
O formato da string não é válido.
Um XmlReader método era chamado antes de uma operação assíncrona anterior terminar. Neste caso, InvalidOperationException é lançado com a mensagem "Uma operação assíncrona já está em curso."
Observações
Este método concatena texto, espaços em branco, espaços em branco significativos e secções CDATA, e ignora quaisquer comentários ou instruções de processamento. As referências às entidades são resolvidas automaticamente.
Se o conteúdo for digitado xsd:dateTime, o leitor devolve um objeto sem caixa DateTime . Se o conteúdo não for tipado xsd:dateTime, o leitor tenta convertê-lo num DateTime objeto de acordo com as regras definidas pela recomendação do Esquema XML do W3C Parte 2: Tipos de dados .
Note
Não é possível confiar no DateTime.Year valor quando o conteúdo é digitado como xsd:gMonthDay.
XmlReader neste caso, define sempre o DateTime.Year valor para 1904.
A tabela seguinte descreve como este método trata cada tipo de nó.
| XmlNodeType | Valor de retorno | Comportamento do leitor |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Conteúdo concatenado de texto, CDATA, espaços em branco e nós significativos de espaço em branco convertidos para o tipo solicitado. | Move-se para o próximo elemento inicial ou etiqueta de elemento final. As referências de entidades são automaticamente expandidas. |
Attribute |
É o mesmo que invocar XmlConvert.ToXxx o valor do atributo. |
O leitor mantém-se na posição atual. |
CommentProcessingInstruction |
Ignora a instrução de processamento (PI) ou comentário e lê o texto concatenado que segue o PI ou comentário. | Move-se para o próximo elemento inicial ou etiqueta de elemento final. As referências de entidades são automaticamente expandidas. |
EndElement |
Uma cadeia de caracteres vazia. | O leitor mantém-se na posição atual. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Um InvalidOperationException é jogado. | Indefinido, embora normalmente o leitor permaneça na posição atual. |
Para mais informações, consulte a XmlReader página de referência e a recomendação do Esquema XML do W3C Parte 2: Tipos de dados .