Compartilhar via


XmlTextReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Método

Definição

Lê o elemento e decodifica o conteúdo de Base64.

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

O valor buffer é null.

O nó atual não é um nó de elemento.

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

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

O elemento contém conteúdo misto.

Não é possível converter conteúdo no tipo solicitado.

Exemplos

Confira XmlReader.ReadElementContentAsBase64 um exemplo usando esse método.

Comentários

Observação

A partir do .NET Framework 2.0, recomendamos que você crie XmlReader instâncias usando o XmlReader.Create método para aproveitar a nova funcionalidade.

Esse método lê o conteúdo do elemento, o decodifica usando a codificação Base64 e retorna os bytes binários decodificados (por exemplo, uma imagem GIF codificada em Base64 embutida) no buffer. 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 de Solicitação de Comentários.

Esse método só pode ler elementos de conteúdo simples. O elemento pode conter texto, espaço em branco, espaço em branco significativo, seções CDATA, comentários e instruções de processamento. Ele também pode conter referências de entidade, que são expandidas automaticamente. O elemento não pode ter elementos filho.

Esse método é muito semelhante ao ReadContentAsBase64 método, exceto que ele só pode ser chamado em tipos de nó de elemento.

Se o count valor for maior do que o número de bytes no documento ou se for igual ao número de bytes no documento, ele XmlTextReader lerá todos os bytes restantes no documento e retornará o número de bytes lidos. A próxima XmlTextReader chamada de método retorna um zero e move o leitor para o nó após o EndElement.

Se você chamar Read antes que todo o conteúdo do elemento seja consumido, o leitor poderá se comportar como se o primeiro conteúdo fosse consumido e, em seguida, o Read método fosse chamado. Isso significa que o leitor lê todo o texto até que o elemento final seja encontrado. Em seguida, ele lê o nó de marca final, lê o próximo nó e, em seguida, posiciona-se no próximo nó subsequente.

Aplica-se a

Confira também