XmlTextReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Lee el elemento y descodifica el contenido 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 -> intPublic Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As IntegerParámetros
- buffer
- Byte[]
Búfer en el que se va a copiar el texto resultante. Este valor no puede ser null.
- index
- Int32
Desplazamiento en el búfer donde empezar a copiar el 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 de este método.
Devoluciones
Número de bytes escritos en el búfer.
Excepciones
El valor de buffer es null.
El nodo actual no es un nodo de elemento.
El índice en el búfer o índice + recuento es mayor que el tamaño del búfer asignado.
La XmlTextReader implementación no admite este método.
El elemento contiene contenido mixto.
El contenido no se puede convertir al tipo solicitado.
Ejemplos
Vea XmlReader.ReadElementContentAsBase64 para ver un ejemplo mediante este método.
Comentarios
Note
Se recomienda crear XmlReader instancias mediante el XmlReader.Create método para aprovechar las nuevas funcionalidades.
Este método lee el contenido del elemento, lo descodifica mediante la codificación Base64 y devuelve los bytes binarios descodificados (por ejemplo, una imagen GIF codificada en Base64 insertada) en el búfer. 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.
Este método solo puede leer elementos de contenido simple. El elemento puede contener texto, espacio en blanco, espacios en blanco significativos, secciones de CDATA, comentarios e instrucciones de procesamiento. También puede contener referencias de entidad, que se expanden automáticamente. El elemento no puede tener elementos secundarios.
Este método es muy similar al ReadContentAsBase64 método, excepto que solo se puede llamar a en tipos de nodo de elemento.
Si el count valor es mayor que el número de bytes del documento, o si es igual al número de bytes del documento, XmlTextReader lee todos los bytes restantes del documento y devuelve el número de bytes leídos. La siguiente XmlTextReader llamada al método devuelve un cero y mueve el lector al nodo que sigue a EndElement.
Si llama Read a antes de que se consuma todo el contenido del elemento, el lector puede comportarse como si se consuma el primer contenido y, a continuación, se llamó al Read método . Esto significa que el lector lee todo el texto hasta que se encuentra el elemento final. A continuación, lee el nodo de etiqueta final, lee el siguiente nodo y, a continuación, se coloca en el siguiente nodo posterior.
