Metodo XmlTextReader.ReadElementContentAsBinHex (System.Xml)

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

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

Legge l'elemento e decodifica il contenuto BinHex.

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

Sintassi
Visual Basic - (Dichiarazione)
Public Overrides Function ReadElementContentAsBinHex ( _
	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.ReadElementContentAsBinHex(buffer, index, count)
C#
public override int ReadElementContentAsBinHex (
	byte[] buffer,
	int index,
	int count
)
C++
public:
virtual int ReadElementContentAsBinHex (
	array<unsigned char>^ buffer, 
	int index, 
	int count
) override
J#
public int ReadElementContentAsBinHex (
	byte[] buffer, 
	int index, 
	int count
)
JScript
public override function ReadElementContentAsBinHex (
	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

Il nodo corrente non è un nodo elemento.

ArgumentOutOfRangeException

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

NotSupportedException

L'implementazione di XmlReader non supporta questo metodo.

XmlException

L'elemento include contenuto misto.

FormatException

Il contenuto non può essere convertito nel tipo richiesto.
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 legge il contenuto dell'elemento, lo decodifica mediante la codifica BinHex e restituisce nel buffer i byte binari decodificati, ad esempio un'immagine GIF con codifica BinHex inline.

Questo metodo può leggere soltanto elementi con contenuto semplice. L'elemento può contenere testo, spazi vuoti, spazi vuoti significativi, sezioni CDATA, commenti e istruzioni di elaborazione. Può inoltre contenere riferimenti a entità, che vengono espansi automaticamente. L'elemento non può disporre di elementi figlio.

Questo metodo è molto simile al metodo ReadContentAsBinHex, con la differenza che può essere chiamato solo in tipi di nodi elemento.

Se il valore di count è maggiore o uguale al numero di byte nel documento, XmlTextReader legge tutti i byte restanti nel documento e restituisce il numero dei byte letti. La successiva chiamata di metodo di XmlTextReader restituisce zero e sposta il visualizzatore in corrispondenza del nodo successivo a EndElement.

Se si chiama Read prima che venga utilizzato tutto il contenuto dell'elemento, il visualizzatore potrebbe comportarsi come se il primo contenuto fosse stato utilizzato e quindi fosse stato chiamato il metodo Read. Di conseguenza, il visualizzatore leggerà tutto il testo fino al raggiungimento dell'elemento di fine. Successivamente leggerà il nodo del tag di fine e il nodo successivo e quindi si posizionerà in corrispondenza del nodo seguente.

Esempio

Per un esempio di utilizzo del metodo, vedere XmlReader.ReadElementContentAsBinHex.

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