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

Referenz

Definition

Namespace:: Org.Xml.Sax

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Empfangen einer Benachrichtigung über Zeichendaten.

[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

Parameter

ch: Char[]

die Zeichen aus dem XML-Dokument

start: Int32

die Startposition im Array

length: Int32

Die Anzahl der Zeichen, die aus dem Array gelesen werden sollen

Attribute: RegisterAttribute

Ausnahmen

SAXException

alle SAX-Ausnahme, möglicherweise eine andere Ausnahme umschließen

Hinweise

Empfangen einer Benachrichtigung über Zeichendaten.

Der Parser ruft diese Methode auf, um jeden Datenabschnitt von Zeichen zu melden. SAX-Parser können alle zusammenhängenden Zeichendaten in einem einzelnen Abschnitt zurückgeben, oder sie können sie in mehrere Blöcke aufteilen; Allerdings müssen alle Zeichen in jedem einzelnen Ereignis aus derselben externen Entität stammen, damit der Locator nützliche Informationen bereitstellt.

Die Anwendung darf nicht versuchen, aus dem Array außerhalb des angegebenen Bereichs zu lesen.

Einzelne Zeichen können aus mehr als einem Java-Wert char bestehen. Es gibt zwei wichtige Fälle, in denen dies geschieht, da Zeichen nicht in nur sechzehn Bits dargestellt werden können. In einem Fall werden Zeichen in einem <surrogate>Pair</em> mit zwei speziellen Unicode-Werten dargestellt. Solche Zeichen befinden sich in den sogenannten "Astralebenen" mit einem Codepunkt über U+FFFF. Ein zweiter Fall umfasst zusammengesetzte Zeichen, z. B. ein Basiszeichen, das mit einem oder mehreren Akzentzeichen kombiniert wird.

Ihr Code sollte nicht davon ausgehen, dass Algorithmen, chardie "-at-a-time"-Idiome verwenden, in Zeicheneinheiten funktionieren; in einigen Fällen werden sie Zeichen aufteilen. Dies ist unabhängig davon relevant, wo XML beliebige Zeichen zulässt, z. B. Attributwerte, Verarbeitungsanweisungsdaten und Kommentare sowie daten, die von dieser Methode gemeldet werden. Es ist auch allgemein relevant, wenn Java-Code internationalisierten Text bearbeitet; das Problem für XML nicht eindeutig ist.

Beachten Sie, dass einige Parser Leerzeichen in Elementinhalten mithilfe der #ignorableWhitespace ignorableWhitespace Methode statt dieser melden (die Überprüfung der Parser <em>muss</em> dies tun).

Java-Dokumentation für org.xml.sax.ContentHandler.characters(char[], int, int).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Weitere Informationen

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

Freigeben über