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

Definição

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

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

public:
 override int ReadContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);
public override int ReadContentAsBase64(byte[] buffer, int index, int count);
override this.ReadContentAsBase64 : byte[] * int * int -> int
Public Overrides 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.

ArgumentOutOfRangeException

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

Comentários

Note

Para aproveitar os recursos mais recentes, a prática recomendada é criar XmlReader instâncias usando a XmlReaderSettings classe e o Create método. Para obter mais informações, consulte a seção Comentários na XmlReader página de referência.

Esse método transmite o conteúdo, decodifica o conteúdo base64 e retorna os bytes binários decodificados (por exemplo, uma imagem GIF codificada em Base64 embutida) 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 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 chegou ao 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 forem deixados 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.

Aplica-se a

Confira também