Compartir vía


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

Definición

Lee el contenido y devuelve los bytes binarios descodificados en 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[]

Búfer donde se va a copiar el texto resultante. Este valor no puede ser null.

index
Int32

Posición de desplazamiento en el búfer donde debe comenzar la copia del resultado.

count
Int32

Número máximo de bytes que se van a copiar en el búfer. El número real de bytes copiados se devuelve a partir de este método.

Devoluciones

Número de bytes escritos en el búfer.

Excepciones

El valor buffer es null.

El método ReadContentAsBase64(Byte[], Int32, Int32) no es compatible con el nodo actual.

El índice del búfer (index) o la suma del índice y el recuento (index + count) es mayor que el tamaño de búfer asignado.

Comentarios

Nota

En .NET Framework 2.0, la práctica recomendada es crear XmlReader instancias mediante la XmlReaderSettings clase y el Create método . Esto le permite aprovechar al máximo todas las nuevas características introducidas en .NET Framework. Para obtener más información, vea la sección Comentarios de la página de XmlReader referencia.

Este método transmite el contenido, descodifica el contenido de Base64 y devuelve los bytes binarios descodificados (por ejemplo, una imagen GIF codificada en Base64 insertada) en el búfer. Este método se puede llamar sucesivamente para leer secuencias grandes de texto incrustado. Para obtener más información, vea RFC 1521, "MIME (Extensiones multipropósito de correo de Internet) Parte Uno: Mecanismos para especificar y describir el formato de los cuerpos de mensajes de Internet". Puede obtener RFC del sitio web solicitud de comentarios.

Nota

No debe tener acceso a ninguna de las propiedades del lector entre las llamadas al ReadContentAsBase64 método hasta que el método devuelva el valor 0.

Este método tiene el siguiente comportamiento:

  • ReadContentAsBase64 devuelve el valor 0 cuando ha alcanzado el final de la secuencia de bytes en la que estaba funcionando. El lector se coloca en el primer nodo que no es de contenido.

  • Si solicita menos o el número exacto de bytes que quedan en la secuencia, el lector permanece en su posición actual.

  • ReadContentAsBase64 no se admite en los siguientes tipos de nodo XML: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.

Se aplica a

Consulte también