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

Definição

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

Lê o conteúdo e retorna os bytes binários decodificados em 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 no qual copiar o texto resultante. Esse valor não pode ser null.

index
Int32

O deslocamento para o buffer em que começar a copiar o resultado.

count
Int32

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

Retornos

Int32

O número de bytes gravados no buffer.

Exceções

ArgumentNullException

O buffer valor é null.

InvalidOperationException

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

-ou-

Um XmlReader método foi chamado antes de uma operação assíncrona anterior ser concluída. Nesse caso, InvalidOperationException é lançada com a mensagem "Uma operação assíncrona já está em andamento".

ArgumentOutOfRangeException

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

NotSupportedException

A XmlReader implementação 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 de email de internet multiuso) parte um: mecanismos para especificar e descrever o formato de corpos de mensagens da Internet". Você pode obter RFCs no site da Solicitação de Comentários.

Note

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

Esse método tem o seguinte comportamento:

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

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

  • ReadContentAsBase64 não há suporte para os 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