IContentHandler.Characters(Char[], Int32, Int32) Méthode

Référence

Définition

Espace de noms:: Org.Xml.Sax

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Recevoir la notification des données de caractère.

[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

Paramètres

ch: Char[]

caractères du document XML

start: Int32

position de début dans le tableau

length: Int32

nombre de caractères à lire à partir du tableau

Attributs: RegisterAttribute

Exceptions

SAXException

toute exception SAX, éventuellement encapsuler une autre exception

Remarques

Recevoir la notification des données de caractère.

L’analyseur appelle cette méthode pour signaler chaque segment de données de caractères. Les analyseurs SAX peuvent retourner toutes les données de caractères contiguës dans un bloc unique, ou les fractionner en plusieurs blocs ; toutefois, tous les caractères d’un événement unique doivent provenir de la même entité externe afin que le localisateur fournit des informations utiles.

L’application ne doit pas tenter de lire à partir du tableau en dehors de la plage spécifiée.

Les caractères individuels peuvent être constitués de plusieurs valeurs Java char . Il existe deux cas importants où cela se produit, car les caractères ne peuvent pas être représentés en seulement seize bits. Dans un cas, les caractères sont représentés dans une <paire</em de substitution em>>, à l’aide de deux valeurs Unicode spéciales. Ces caractères se trouvent dans les « plans Astral », avec un point de code au-dessus de U+FFFF. Un deuxième cas implique des caractères composites, tels qu’un caractère de base combinant avec un ou plusieurs caractères d’accentuation.

Votre code ne doit pas supposer que les algorithmes utilisant chardes idiomes à la fois fonctionnent dans des unités de caractères ; dans certains cas, ils fractionneront des caractères. Cela est pertinent partout où XML autorise les caractères arbitraires, tels que les valeurs d’attribut, le traitement des données d’instruction et les commentaires, ainsi que dans les données signalées à partir de cette méthode. Il est également généralement pertinent chaque fois que le code Java manipule du texte internationalisé ; le problème n’est pas unique au format XML.

Notez que certains analyseurs signalent des espaces blancs dans le contenu de l’élément à l’aide de la #ignorableWhitespace ignorableWhitespace méthode plutôt que de celui-ci (la validation des analyseurs <em>doit</em> le faire).

Documentation Java pour org.xml.sax.ContentHandler.characters(char[], int, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

Voir aussi

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

Partager via