XmlNodeReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Lê o elemento e decodifica o conteúdo 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 -> intPublic Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As IntegerParâ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
O número de bytes gravados no buffer.
Exceções
O buffer valor é null.
O nó atual não é um nó de elemento.
O índice no buffer ou índice + contagem é maior que o tamanho do buffer alocado.
O elemento contém conteúdo misto.
O conteúdo não pode ser convertido no tipo solicitado.
Exemplos
Confira XmlReader.ReadElementContentAsBase64 um exemplo usando esse método.
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 lê o conteúdo, 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 da 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 pelo fato de que ele só pode ser chamado em tipos de nó de elemento.
Se o valor de contagem for maior que o número de bytes no documento ou se for igual ao número de bytes no documento, lerá XmlNodeReader todos os bytes restantes no documento e retornará o número de bytes lidos. A próxima ReadElementContentAsBase64 chamada de método retorna um zero e move o leitor para o nó após o EndElement nó.
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.