Compartir a través de


XmlValidatingReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Método

Definición

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 -> int
Public Overrides Function ReadElementContentAsBinHex (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

Int32

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.

La implementación de XmlValidatingReader no admite este método.

El elemento contiene un contenido mixto.

El contenido no puede convertirse en el tipo solicitado.

Comentarios

Nota

La XmlValidatingReader clase está obsoleta en .NET Framework 2.0. Puede crear una instancia de XmlReader validación mediante la XmlReaderSettings clase y el Create método . Para obtener más información, vea la sección Comentarios de la página de referencia de XmlReader.

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 en línea BinHex) en el búfer.

Este método solo puede leer elementos de contenido simple. El elemento puede contener texto, espacio en blanco, espacio en blanco significativo, 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, 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, XmlValidatingReader lee todos los bytes restantes del documento y devuelve el número de bytes leídos. La siguiente XmlValidatingReader llamada al método devuelve un cero y mueve el lector al nodo que sigue a EndElement.

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 leerá todo el texto hasta que se encuentre el elemento final. A continuación, leerá el nodo de etiqueta final, leerá el siguiente nodo y, a continuación, se colocará en el siguiente nodo posterior.

Se aplica a

Consulte también