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

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Origem:

XmlNodeReader.cs

Lê o conteúdo e retorna os bytes binários decodificados de 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 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

ArgumentNullException

O valor buffer é null.

InvalidOperationException

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

ArgumentOutOfRangeException

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

Comentários

Observação

No .NET Framework 2.0, a prática recomendada é criar XmlReader instâncias usando a XmlReaderSettings classe e o Create método . Isso permite que você aproveite ao máximo todos os novos recursos introduzidos no .NET Framework. 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 (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". Você pode obter RFCs no site solicitação de comentários.

Observação

Você não deve acessar nenhuma das propriedades de leitor entre chamadas para o 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 ele atingiu o final do fluxo de bytes em que estava operando. O leitor é posicionado no primeiro nó que não é de conteúdo.

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

• ReadContentAsBase64 não há suporte nos seguintes tipos de nó XML: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.

Confira também

• ReadElementContentAsBase64(Byte[], Int32, Int32)
• ReadContentAsBinHex(Byte[], Int32, Int32)