XmlTextReader.ReadContentAsBinHex(Byte[], Int32, Int32) Método

  • Referencia

Definición

Espacio de nombres:
System.Xml
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll
Source:
XmlTextReader.cs
Source:
XmlTextReader.cs
Source:
XmlTextReader.cs

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

ArgumentNullException

El valor buffer es null.

InvalidOperationException

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

ArgumentOutOfRangeException

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.

NotSupportedException

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

Comentarios

Nota:

A partir de .NET Framework 2.0, se recomienda crear XmlReader instancias mediante el XmlReader.Create método para aprovechar las nuevas funcionalidades.

Este método transmite el contenido, descodifica el BinHex contenido y devuelve los bytes binarios descodificados (por ejemplo, una imagen GIF codificada insertada BinHex ) 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.

  • ReadContentAsBinHexno se admite en los siguientes tipos de nodo XML: Element, XmlDeclaration, NoneDocument, DocumentType, Notation, , Entity, . DocumentFragment

Se aplica a

Consulte también