XmlNodeReader.ReadContentAsBinHex(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 contenido y devuelve los bytes binarios descodificados de BinHex.
public:
override int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadContentAsBinHex (byte[] buffer, int index, int count);override this.ReadContentAsBinHex : byte[] * int * int -> intPublic Overrides Function ReadContentAsBinHex (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 método ReadContentAsBinHex(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 características nuevas 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 binHex y devuelve los bytes binarios descodificados (por ejemplo, una imagen GIF codificada binHex insertada) en el búfer. Este método se puede llamar sucesivamente para leer secuencias grandes de texto incrustado.
Nota:
No debe tener acceso a ninguna de las propiedades del lector entre las llamadas al ReadContentAsBinHex método hasta que el método devuelva el valor 0.
Este método tiene el siguiente comportamiento:
ReadContentAsBinHex devuelve el valor 0 cuando ha llegado al final del flujo de bytes en el que estaba funcionando. El lector se coloca en el primer nodo que no es de contenido.
Si solicita menos bytes o el número exacto de bytes que quedan en la secuencia, el lector permanece en su posición actual.
ReadContentAsBinHex no se admite en los siguientes tipos de nodo XML: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, DocumentFragment.
