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

Definizione

Spazio dei nomi:
System.Xml
Assembly:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Origine:
XmlTextReader.cs
Origine:
XmlTextReader.cs
Origine:
XmlTextReader.cs
Origine:
XmlTextReader.cs
Origine:
XmlTextReader.cs

Legge il contenuto e restituisce i BinHex byte binari decodificati.

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 in 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.

Valori restituiti

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 o nell'indice + conteggio è maggiore della dimensione del buffer allocata.

NotSupportedException

L'implementazione XmlTextReader non supporta questo metodo.

Commenti

Note

È consigliabile creare XmlReader istanze usando il XmlReader.Create metodo per sfruttare le nuove funzionalità.

Questo metodo trasmette il contenuto, decodifica il BinHex contenuto 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.

Note

Non è consigliabile accedere alle proprietà del lettore tra le chiamate al metodo fino a ReadContentAsBinHex quando il metodo non restituisce il valore 0.

Questo metodo ha il comportamento seguente:

  • ReadContentAsBinHex restituisce il valore 0 quando ha raggiunto la fine del flusso di byte su cui operava. Il lettore è posizionato sul primo nodo non di contenuto.

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

  • ReadContentAsBinHexnon è supportato nei tipi di nodo XML seguenti: Element, XmlDeclarationNone, Document, DocumentType, Notation, Entity. DocumentFragment

Si applica a

Vedi anche