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

Definición

Espacio de nombres:
System.Xml
Ensamblados:
System.Xml.dll, System.Xml.ReaderWriter.dll
Ensamblados:
netstandard.dll, System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

Lee el contenido y devuelve los BinHex bytes binarios descodificados.

public:
 virtual int ReadContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public virtual int ReadContentAsBinHex(byte[] buffer, int index, int count);
abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> int
Public Overridable Function ReadContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer

Pará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

Int32

Número de bytes escritos en el búfer.

Excepciones

ArgumentNullException

El valor de buffer es null.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) no se admite en el nodo actual.

O bien

Se llamó a un XmlReader método antes de que finalice una operación asincrónica anterior. En este caso, InvalidOperationException se produce con el mensaje "Una operación asincrónica ya está en curso".

ArgumentOutOfRangeException

El índice en el búfer o índice + recuento es mayor que el tamaño del búfer asignado.

NotSupportedException

La XmlReader implementación no admite este método.

Comentarios

Este método transmite el contenido, descodifica el BinHex contenido y devuelve los bytes binarios descodificados (por ejemplo, una imagen GIF codificada en línea BinHex ) en el búfer. Este método se puede llamar sucesivamente para leer secuencias grandes de texto incrustado.

Note

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 de la secuencia de bytes en la 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

Para obtener la versión asincrónica de este método, vea ReadContentAsBinHexAsync.

Se aplica a

Consulte también