IContentHandler.Characters(Char[], Int32, Int32) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Recibir notificación de datos de caracteres.
[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 -> unitParámetros
- ch
- Char[]
los caracteres del documento XML
- start
- Int32
la posición inicial de la matriz
- length
- Int32
el número de caracteres que se van a leer de la matriz
- Atributos
Excepciones
cualquier excepción SAX, posiblemente encapsulando otra excepción
Comentarios
Recibir notificación de datos de caracteres.
El analizador llamará a este método para notificar cada fragmento de datos de caracteres. Los analizadores SAX pueden devolver todos los datos de caracteres contiguos en un solo fragmento, o pueden dividirlos en varios fragmentos; sin embargo, todos los caracteres de cualquier evento único deben proceder de la misma entidad externa para que el localizador proporcione información útil.
La aplicación no debe intentar leer desde la matriz fuera del intervalo especificado.
Los caracteres individuales pueden constar de más de un valor de Java char . Hay dos casos importantes en los que esto sucede, ya que los caracteres no se pueden representar en solo dieciséis bits. En un caso, los caracteres se representan en un <par<> suplente em>, usando dos valores Unicode especiales. Estos caracteres están en el denominado "Planos Astral", con un punto de código por encima de U+FFFF. Un segundo caso implica caracteres compuestos, como un carácter base que combina con uno o varios caracteres de énfasis.
El código no debe suponer que los algoritmos que usan charlas expresiones -at-a-time funcionarán en unidades de caracteres; en algunos casos dividirán caracteres. Esto es relevante siempre que XML permita caracteres arbitrarios, como valores de atributo, procesamiento de datos de instrucciones y comentarios, así como en los datos notificados desde este método. También es generalmente relevante siempre que el código Java manipula texto internacionalizado; el problema no es único para XML.
Tenga en cuenta que algunos analizadores notificarán espacios en blanco en el contenido del elemento mediante el #ignorableWhitespace ignorableWhitespace método en lugar de este (validar analizadores <em>debe</em> hacerlo).
Documentación de Java para org.xml.sax.ContentHandler.characters(char[], int, int).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Se aplica a
Consulte también
- <xref:Org.Xml.Sax.IContentHandler.IgnorableWhitespace(System.Char%5b%5d%2c+System.Int32%2c+System.Int32)>
- ILocator