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

Definição

Espaço de Nomes:
System.Xml
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll

Lê o conteúdo e devolve 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 para onde copiar o texto resultante. Este valor não pode ser null.

index
Int32

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

count
Int32

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

Devoluções

Int32

O número de bytes escritos no buffer.

Exceções

ArgumentNullException

O buffer valor é null.

InvalidOperationException

ReadContentAsBase64(Byte[], Int32, Int32) não é suportado no nó atual.

ArgumentOutOfRangeException

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

Observações

Note

A classe XmlValidatingReader está obsoleta no .NET Framework 2.0. Pode criar uma instância de validação XmlReader usando a XmlReaderSettings classe e o Create método. Para obter mais informações, consulte a seção Comentários da XmlReader página de referência.

Este método transmite o conteúdo, descodifica o conteúdo Base64 e devolve os bytes binários decodificados (por exemplo, uma imagem GIF codificada em Base64 inline) para o buffer. Este método pode ser chamado sucessivamente para ler grandes fluxos de texto embutido. Para mais informações, consulte o RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Parte Um: Mecanismos para Especificar e Descrever o Formato dos Corpos de Mensagens na Internet". Pode obter RFCs no site de Pedido de Comentários.

Note

Não deve aceder a nenhuma das propriedades do leitor entre chamadas ao ReadContentAsBase64 método até que este devolva o valor 0.

Este método apresenta o seguinte comportamento:

  • ReadContentAsBase64 devolve o valor 0 quando atinge o fim do fluxo de bytes em que estava a operar. O leitor posiciona-se no primeiro nó não-conteúdo.

  • Se pedir menos, ou o número exato, de bytes do que restam no fluxo, o leitor mantém-se na sua posição atual.

  • ReadContentAsBase64 não é suportado nos seguintes tipos de nós XML: Element, XmlDeclaration, Nenhum, Documento, DocumentType, Notation, Entity e DocumentFragment.

Aplica-se a

Ver também