IContentHandler.Characters(Char[], Int32, Int32) Metodo

Riferimento

Definizione

Spazio dei nomi:: Org.Xml.Sax

Assembly:: Mono.Android.dll

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.

Ricevere la notifica dei dati di tipo carattere.

[Android.Runtime.Register("characters", "([CII)V", "GetCharacters_arrayCIIHandler:Org.Xml.Sax.IContentHandlerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public void Characters (char[]? ch, int start, int length);

[<Android.Runtime.Register("characters", "([CII)V", "GetCharacters_arrayCIIHandler:Org.Xml.Sax.IContentHandlerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member Characters : char[] * int * int -> unit

Parametri

ch: Char[]

caratteri del documento XML

start: Int32

posizione iniziale nella matrice

length: Int32

numero di caratteri da leggere dalla matrice

Attributi: RegisterAttribute

Eccezioni

SAXException

qualsiasi eccezione SAX, eventualmente con wrapping di un'altra eccezione

Commenti

Ricevere la notifica dei dati di tipo carattere.

Il parser chiamerà questo metodo per segnalare ogni blocco di dati di tipo carattere. I parser SAX possono restituire tutti i dati di tipo carattere contigui in un singolo blocco oppure possono suddividerli in diversi blocchi; Tuttavia, tutti i caratteri in qualsiasi singolo evento devono provenire dalla stessa entità esterna in modo che il localizzatore fornisca informazioni utili.

L'applicazione non deve tentare di leggere dalla matrice all'esterno dell'intervallo specificato.

I singoli caratteri possono essere costituiti da più di un valore Java char . Ci sono due casi importanti in cui ciò accade, perché i caratteri non possono essere rappresentati in soli sedici bit. In un caso, i caratteri vengono rappresentati in una <coppia< surrogata em>/em>, usando due valori Unicode speciali. Tali caratteri si trovano nei cosiddetti "Piani astrali", con un punto di codice sopra U+FFFFFF. Un secondo caso prevede caratteri compositi, ad esempio un carattere di base che combina uno o più caratteri accentari.

Il codice non deve presupporre che gli algoritmi che usano charidiomi -at-a-time funzionino in unità di caratteri; in alcuni casi divideranno i caratteri. Questo è rilevante ovunque XML consenta caratteri arbitrari, ad esempio valori di attributo, dati di istruzioni di elaborazione e commenti, nonché nei dati segnalati da questo metodo. È anche in genere rilevante ogni volta che il codice Java modifica il testo internazionalizzato; il problema non è univoco per XML.

Si noti che alcuni parser segnalano spazi vuoti nel contenuto dell'elemento usando il #ignorableWhitespace ignorableWhitespace metodo anziché questo (convalidando i parser <em>deve</em> farlo).

Documentazione java per org.xml.sax.ContentHandler.characters(char[], int, int).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica a

Vedi anche

<xref:Org.Xml.Sax.IContentHandler.IgnorableWhitespace(System.Char%5b%5d%2c+System.Int32%2c+System.Int32)>
ILocator

Condividi tramite