IContentHandler.Characters(Char[], Int32, Int32) 方法

定義

命名空間:

Org.Xml.Sax

組件:

Mono.Android.dll

接收字元數據的通知。

[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

參數

ch

Char[]

XML 檔案中的字元

start

Int32

陣列中的開始位置

length

Int32

要從數位讀取的字元數

屬性

RegisterAttribute

例外狀況

SAXException

任何 SAX 例外狀況，可能包裝另一個例外狀況

備註

接收字元數據的通知。

剖析器會呼叫此方法來報告每個字元數據區塊。 SAX 剖析器可能會傳回單一區塊中的所有連續字元數據，或將其分割成數個區塊;不過，任何單一事件中的所有字元都必須來自相同的外部實體，讓定位器提供有用的資訊。

應用程式不得嘗試從指定範圍以外的陣列讀取。

個別字元可能包含多個 Java char 值。 發生此情況有兩個重要案例，因為字元不能只以16位表示。 在一種情況下，字元會以em>Surrogate Pair</em> 表示，使用兩個<特殊的 Unicode 值。 這類字元位於所謂的「星形平面」中，其代碼點高於U+FFFF。 第二個案例牽涉到複合字元，例如結合一或多個輔色字元的基底字元。

您的程式代碼不應該假設使用 char-at-a-time 慣用語的演算法會以字元單位運作;在某些情況下，它們會分割字元。 無論 XML 允許任意字元，例如屬性值、處理指令數據和批註，以及在此方法所報告的數據中，這都相關。 每當 Java 程式代碼操作國際化文字時，它通常也會相關;問題不是唯一的 XML。

請注意，某些剖析器會使用 #ignorableWhitespace ignorableWhitespace 方法來報告元素內容中的空格符，而不是這個方法（驗證剖析器 <em>必須</em> 這樣做）。

的 org.xml.sax.ContentHandler.characters(char[], int, int)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

另請參閱

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