XmlReader.ReadContentAsBase64(Byte[], Int32, Int32) Método

  • Referência

Definição

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

Lê o conteúdo e retorna os bytes binários decodificados de Base64.

public:
 virtual int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBase64 (byte[] buffer, int index, int count);
abstract member ReadContentAsBase64 : byte[] * int * int -> int
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overridable Function ReadContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As Integer

Parâmetros

buffer
Byte[]

O buffer para o qual o texto resultante será copiado. Este valor pode não ser null.

index
Int32

O deslocamento do buffer no qual o resultado começará a ser copiado.

count
Int32

O número máximo de bytes a serem copiados para o buffer. O número real de bytes copiados é retornado deste método.

Retornos

Int32

O número de bytes gravados no buffer.

Exceções

ArgumentNullException

O valor buffer é null.

InvalidOperationException

Não há suporte para ReadContentAsBase64(Byte[], Int32, Int32) no nó atual.

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

ArgumentOutOfRangeException

O índice de buffer ou de índice + contagem é maior que o tamanho do buffer alocado.

NotSupportedException

A implementação XmlReader não dá suporte a esse método.

Comentários

Esse método transmite o conteúdo, decodifica o Base64 conteúdo e retorna os bytes binários decodificados (por exemplo, uma imagem GIF codificada embutida Base64 ) no buffer. Esse método pode ser chamado sucessivamente para ler grandes fluxos de texto inserido. Para obter mais informações, consulte RFC 1521, "MIME (Extensões multiuso do Internet Mail) Parte Um: mecanismos para especificar e descrever o formato de corpos de mensagens da Internet". Você pode obter RFCs no site de Solicitação de Comentários.

Observação

Você não deve acessar nenhuma das propriedades do leitor entre chamadas ao método até que ReadContentAsBase64 o método retorne o valor 0.

Esse método tem o seguinte comportamento:

  • ReadContentAsBase64 retorna o valor 0 quando ele chegou ao final do fluxo de bytes em que estava operando. O leitor está posicionado no primeiro nó sem conteúdo.

  • Se você pedir menos ou o número exato de bytes que são deixados no fluxo, o leitor permanecerá em sua posição atual.

  • ReadContentAsBase64 não há suporte nos seguintes tipos de nó XML: Element, , XmlDeclaration, None, , Document, DocumentType, Notation, , Entity, DocumentFragment.

Para obter a versão assíncrona deste método, consulte ReadContentAsBase64Async.

Aplica-se a

Confira também