XmlValidatingReader.ReadContentAsBinHex(Byte[], Int32, Int32) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Legge il contenuto e restituisce i byte binari decodificati 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

Parametri

buffer
Byte[]

Buffer in cui copiare il testo risultante. Questo valore non può essere null.

index
Int32

Offset nel buffer a partire da cui iniziare a copiare il risultato.

count
Int32

Numero massimo di byte da copiare nel buffer. Il numero effettivo di byte copiati viene restituito da questo metodo.

Restituisce

Int32

Numero di byte scritti nel buffer.

Eccezioni

ArgumentNullException

Il valore buffer è null.

InvalidOperationException

ReadContentAsBinHex(Byte[], Int32, Int32) non è supportato nel nodo corrente.

ArgumentOutOfRangeException

L'indice nel buffer oppure la somma di indice e numero è superiore alla dimensione del buffer allocato.

NotSupportedException

L'implementazione di XmlValidatingReader non supporta questo metodo.

Commenti

Nota

La XmlValidatingReader classe è obsoleta in .NET Framework 2.0. È possibile creare un'istanza di convalida XmlReader usando la classe e il Create XmlReaderSettings metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

Questo metodo trasmette il contenuto, decodifica il contenuto BinHex e restituisce i byte binari decodificati (ad esempio un'immagine GIF codificata inline BinHex) nel buffer. Questo metodo può essere chiamato successivamente per leggere flussi di testo incorporati di grandi dimensioni.

Nota

Non è consigliabile accedere alle proprietà del lettore tra chiamate al ReadContentAsBinHex metodo finché il metodo restituisce il valore 0.

Questo metodo ha il comportamento seguente:

  • ReadContentAsBinHex restituisce il valore 0 quando ha raggiunto la fine del flusso di byte in cui è stato eseguito. Il lettore viene posizionato nel primo nodo non contenuto.

  • Se si chiede meno, o il numero esatto, di byte che sono rimasti nel flusso, il lettore rimane nella posizione corrente.

  • ReadContentAsBinHex non è supportato nei tipi di nodo XML seguenti: Elemento, XmlDeclaration, None, Document, DocumentType, Notation, Entity e DocumentFragment.

Si applica a

Vedi anche