XmlNodeReader.ReadElementContentAsBinHex(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 BinHex.
public:
override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBinHex (byte[] buffer, int index, int count);override this.ReadElementContentAsBinHex : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As IntegerPará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 nodo actual no es un nodo de elemento.
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.
El elemento contiene contenido mixto.
El contenido no puede convertirse en el tipo solicitado.
Ejemplos
Consulte XmlReader.ReadElementContentAsBinHex para ver un ejemplo con este método.
Comentarios
Nota
En el .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 el .NET Framework. Para obtener más información, vea la sección Comentarios de la página de XmlReader referencia.
Este método lee el contenido del elemento, lo descodifica mediante la codificación BinHex y devuelve los bytes binarios descodificados (por ejemplo, una imagen GIF codificada binHex insertada) en el búfer.
Este método solo puede leer elementos de contenido simple. El elemento puede contener texto, espacios en blanco, espacios en blanco significativos, secciones 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 ReadContentAsBinHex método, salvo que solo se puede llamar a en tipos de nodo de elemento.
Si el valor de recuento es mayor que el número de bytes del documento, o si es igual al número de bytes del documento, XmlNodeReader lee todos los bytes restantes del documento y devuelve el número de bytes leídos. La siguiente XmlNodeReader llamada al método devuelve un cero y mueve el lector al nodo que sigue al EndElement nodo.
Si llama a Read 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 llamara 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.