Metodo XmlTextReader.ReadContentAsBinHex (System.Xml)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Metodo XmlTextReader.ReadContentAsBinHex

Nota: questo metodo è stato introdotto con .NET Framework versione 2.0.

Legge il contenuto e restituisce byte binari decodificati BinHex.

Spazio dei nomi: System.Xml
Assembly: System.Xml (in system.xml.dll)

Sintassi
Visual Basic - (Dichiarazione)
Public Overrides Function ReadContentAsBinHex ( _
	buffer As Byte(), _
	index As Integer, _
	count As Integer _
) As Integer
Visual Basic (Utilizzo)
Dim instance As XmlTextReader
Dim buffer As Byte()
Dim index As Integer
Dim count As Integer
Dim returnValue As Integer

returnValue = instance.ReadContentAsBinHex(buffer, index, count)
C#
public override int ReadContentAsBinHex (
	byte[] buffer,
	int index,
	int count
)
C++
public:
virtual int ReadContentAsBinHex (
	array<unsigned char>^ buffer, 
	int index, 
	int count
) override
J#
public int ReadContentAsBinHex (
	byte[] buffer, 
	int index, 
	int count
)
JScript
public override function ReadContentAsBinHex (
	buffer : byte[], 
	index : int, 
	count : int
) : int

Parametri

buffer

Buffer in cui deve essere copiato il testo risultante. Questo valore non può essere riferimento null (Nothing in Visual Basic).

index

Offset nel buffer a partire dal quale deve essere copiato il risultato.

count

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

Valore restituito

Numero di byte scritti nel buffer.
Eccezioni
Tipo di eccezione Condizione

ArgumentNullException

Il valore buffer è riferimento null (Nothing in Visual Basic).

InvalidOperationException

ReadContentAsBinHex 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 XmlTextReader non supporta questo metodo.
Note
NotaNota

Nella versione Microsoft .NET Framework versione 2.0 è consigliabile creare istanze di XmlReader utilizzando il metodo System.Xml.XmlReader.Create. In questo modo è possibile sfruttare completamente le nuove funzionalità introdotte in questa versione. Per ulteriori informazioni, vedere Creazione di lettori XML.

Questo metodo crea un flusso del contenuto, decodifica il contenuto BinHex e restituisce nel buffer i byte binari decodificati, ad esempio un'immagine GIF con codifica BinHex inline. Questo metodo può essere chiamato successivamente per leggere flussi di grandi dimensioni di testo incorporato.

NotaNota

Non è consigliabile accedere a proprietà del visualizzatore tra le chiamate al metodo ReadContentAsBinHex, finché il metodo non restituisce il valore 0.

Questo metodo presenta il seguente comportamento:

  • ReadContentAsBinHex restituisce il valore 0 una volta raggiunta la fine del flusso di byte su cui è stato eseguito. Il visualizzatore è posizionato in corrispondenza del primo nodo non di contenuto.

  • Se si richiede un numero di byte minore o uguale al numero dei byte ancora presenti nel flusso, il visualizzatore resta nella posizione corrente.

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

Piattaforme

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

Informazioni sulla versione

.NET Framework

Supportato in: 2.0

.NET Compact Framework

Supportato in: 2.0
Vedere anche