XmlValidatingReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> intPublic Overrides Function ReadElementContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As IntegerParametri
- 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
Numero di byte scritti nel buffer.
Eccezioni
Il valore buffer è null.
Il nodo corrente non è un nodo elemento.
L'indice nel buffer o nell'indice + conteggio è maggiore della dimensione del buffer allocata.
L'implementazione XmlValidatingReader non supporta questo metodo.
L'elemento contiene contenuto misto.
Il contenuto non può essere convertito nel tipo richiesto.
Commenti
Note
La XmlValidatingReader classe è obsoleta in .NET Framework 2.0. È possibile creare un'istanza di convalida XmlReader usando la XmlReaderSettings classe e il Create metodo . Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.
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, spazi vuoti, spazi vuoti significativi, sezioni CDATA, commenti ed istruzioni di elaborazione. Può anche contenere riferimenti all'entità, che vengono espansi automaticamente. L'elemento non può avere elementi figlio.
Questo metodo è molto simile al metodo, ad eccezione del ReadContentAsBinHex fatto che può essere chiamato solo sui tipi di nodo di elemento.
Se il count valore è maggiore del numero di byte nel documento o se è uguale al numero di byte nel documento, XmlValidatingReader legge tutti i byte rimanenti nel documento e restituisce il numero di byte letti. La chiamata al metodo successivo XmlValidatingReader restituisce zero e sposta il lettore nel nodo che segue .EndElement
Se si chiama Read prima che venga utilizzato tutto il contenuto dell'elemento, il lettore può comportarsi come se il primo contenuto fosse utilizzato e quindi Read il metodo è stato chiamato. Ciò significa che il lettore leggerà tutto il testo fino a quando non viene rilevato l'elemento finale. Leggerà quindi il nodo del tag finale, leggerà il nodo successivo e quindi si posizionerà sul nodo successivo.
