Condividi tramite


XmlNodeReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Metodo

Definizione

Legge l'elemento e decodifica il contenuto BinHex.

public:
 override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);
public override int ReadElementContentAsBinHex (byte[] buffer, int index, int count);
override this.ReadElementContentAsBinHex : byte[] * int * int -> int
Public Overrides Function ReadElementContentAsBinHex (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

Il valore buffer è null.

Il nodo corrente non è un nodo elemento.

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

L'elemento include contenuto misto.

Il contenuto non può essere convertito nel tipo richiesto.

Esempio

Vedere XmlReader.ReadElementContentAsBinHex per visualizzare un esempio usando questo metodo.

Commenti

Nota

Nella .NET Framework 2.0, la procedura consigliata consiste nel creare XmlReader istanze usando la classe e il XmlReaderSettings Create metodo . Ciò consente di sfruttare al meglio tutte le nuove funzionalità introdotte nella .NET Framework. Per altre informazioni, vedere la sezione Osservazioni nella XmlReader pagina di riferimento.

Questo metodo legge il contenuto dell'elemento, lo decodifica usando la codifica BinHex e restituisce i byte binari decodificati (ad esempio un'immagine GIF codificata inline BinHex) nel buffer.

Questo metodo può leggere solo elementi di contenuto semplice. L'elemento può contenere testo, spazio vuoto, spazi vuoti significativi, sezioni CDATA, commenti ed istruzioni di elaborazione. Può anche contenere riferimenti alle entità, che vengono espansi automaticamente. L'elemento non può avere elementi figlio.

Questo metodo è molto simile al ReadContentAsBinHex metodo, ad eccezione del fatto che può essere chiamato solo sui tipi di nodi di elemento.

Se il valore del conteggio è superiore al numero di byte nel documento o se è uguale al numero di byte nel documento, XmlNodeReader il valore legge tutti i byte rimanenti nel documento e restituisce il numero di byte letti. La chiamata al metodo successivo XmlNodeReader restituisce uno zero e sposta il lettore nel nodo che segue il EndElement nodo.

Se si chiama Read prima che venga utilizzato tutto il contenuto dell'elemento, il lettore può comportarsi come se il primo contenuto è stato utilizzato e quindi il Read metodo è stato chiamato. Ciò significa che il lettore legge tutto il testo fino a quando non viene rilevato l'elemento finale. Legge quindi il nodo del tag finale, legge il nodo successivo e quindi si posiziona sul nodo successivo.

Si applica a

Vedi anche