CharsetEncoder Clase

Definición

Espacio de nombres:

Java.Nio.Charset

Ensamblado:

Mono.Android.dll

Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico.

[Android.Runtime.Register("java/nio/charset/CharsetEncoder", DoNotGenerateAcw=true)]
public abstract class CharsetEncoder : Java.Lang.Object

[<Android.Runtime.Register("java/nio/charset/CharsetEncoder", DoNotGenerateAcw=true)>]
type CharsetEncoder = class
    inherit Object

Herencia

Object

JavaObject

Object

CharsetEncoder

Atributos

RegisterAttribute

Comentarios

Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico.

"pasos">

La secuencia de caracteres de entrada se proporciona en un búfer de caracteres o en una serie de dichos búferes. La secuencia de bytes de salida se escribe en un búfer de bytes o en una serie de dichos búferes. Un codificador siempre debe utilizarse realizando la siguiente secuencia de invocaciones de método, denominada en adelante como una operación de codificación:

<Ol>

<Li>

Restablezca el codificador a través del #reset reset método , a menos que no se haya usado antes;

</Li>

<Li>

Invoque el #encode encode método cero o más veces, siempre que la entrada adicional esté disponible, pasando false para el endOfInput argumento y rellenando el búfer de entrada y vaciando el búfer de salida entre invocaciones;

</Li>

<Li>

Invoque el #encode encode método una vez final, pase true para el endOfInput argumento y, a continuación,

</Li>

<Li>

Invoque el #flush flush método para que el codificador pueda vaciar cualquier estado interno en el búfer de salida.

</Li>

</Ol>

Cada invocación del #encode encode método codificará tantos caracteres como sea posible desde el búfer de entrada, escribiendo los bytes resultantes en el búfer de salida. El #encode encode método devuelve cuando se requiere más entrada, cuando no hay suficiente espacio en el búfer de salida o cuando se ha producido un error de codificación. En cada caso, se devuelve un CoderResult objeto para describir el motivo de la terminación. Un invocador puede examinar este objeto y rellenar el búfer de entrada, vaciar el búfer de salida o intentar recuperarse de un error de codificación, según corresponda, e intentarlo de nuevo.

"ce">

Hay dos tipos generales de errores de codificación. Si la secuencia de caracteres de entrada no es una secuencia Unicode legal de dieciséis bits, la entrada se considera incorrecta. Si la secuencia de caracteres de entrada es legal, pero no se puede asignar a una secuencia de bytes válida en el conjunto de caracteres especificado, se ha encontrado un carácter no aplicable.

"cae">

La forma en que se controla un error de codificación depende de la acción solicitada para ese tipo de error, que se describe mediante una instancia de la CodingErrorAction clase . Las posibles acciones de error son codificarErrorAction#IGNORE omitir la entrada errónea, CodingErrorAction#REPORT notifica el error al invocador a través del objeto devuelto CoderResult o CodingErrorAction#REPLACE reemplaza la entrada errónea por el valor actual de la matriz de bytes de reemplazo. Reemplazo

se establece inicialmente en el reemplazo predeterminado del codificador, que a menudo (pero no siempre) tiene el valor inicial { (byte)'?' };

su valor se puede cambiar a través del #replaceWith(byte[]) replaceWith método .

La acción predeterminada para los errores de entrada incorrecta y de caracteres no válidos es codificarErrorAction#REPORT notificarlos. La acción de error de entrada con formato incorrecto se puede cambiar a través del #onMalformedInput(CodingErrorAction) onMalformedInput método ; la acción unmappable-character puede cambiarse a través del #onUnmappableCharacter(CodingErrorAction) onUnmappableCharacter método .

Esta clase está diseñada para controlar muchos de los detalles del proceso de codificación, incluida la implementación de acciones de error. Un codificador para un conjunto de caracteres específico, que es una subclase concreta de esta clase, solo necesita implementar el método abstracto #encodeLoop encodeLoop , que encapsula el bucle de codificación básico. Una subclase que mantiene el estado interno debe, además, invalidar los #implFlush implFlush métodos y #implReset implReset .

Las instancias de esta clase no son seguras para su uso por varios subprocesos simultáneos.

Agregado en la versión 1.4.

Documentación de Java para java.nio.charset.CharsetEncoder.

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.

Constructores

Nombre	Description
CharsetEncoder(Charset, Single, Single, Byte[])	Inicializa un nuevo codificador.
CharsetEncoder(Charset, Single, Single)	Inicializa un nuevo codificador.
CharsetEncoder(IntPtr, JniHandleOwnership)	Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución.

Propiedades

Nombre	Description
Class	Devuelve la clase en tiempo de ejecución de este Objectobjeto . (Heredado de Object)
Handle	Identificador de la instancia de Android subyacente. (Heredado de Object)
JniIdentityHashCode	Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object)
JniManagedPeerState	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
JniPeerMembers	Obtiene los metadatos de JNI usados para invocar miembros de este Java del mismo nivel.
PeerReference	Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object)
ThresholdClass	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.
ThresholdType	Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código.

Métodos

Nombre	Description
AverageBytesPerChar()	Devuelve el número medio de bytes que se producirán para cada carácter de entrada.
CanEncode(Char)	Indica si este codificador puede codificar o no el carácter especificado.
CanEncode(ICharSequence)	Indica si este codificador puede codificar o no la secuencia de caracteres especificada.
CanEncode(String)	Indica si este codificador puede codificar o no la secuencia de caracteres especificada.
Charset()	Devuelve el conjunto de caracteres que creó este codificador.
Clone()	Crea y devuelve una copia de este objeto. (Heredado de Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
Dispose()	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
Dispose(Boolean)	Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object)
DisposeUnlessReferenced()	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
Encode(CharBuffer, ByteBuffer, Boolean)	Codifica tantos caracteres como sea posible desde el búfer de entrada especificado, escribiendo los resultados en el búfer de salida especificado.
Encode(CharBuffer)	Método de conveniencia que codifica el contenido restante de un único búfer de caracteres de entrada en un búfer de bytes recién asignado.
EncodeLoop(CharBuffer, ByteBuffer)	Codifica uno o varios caracteres en uno o varios bytes.
Equals(Object)	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
Equals(Object)	Indica si algún otro objeto es "igual a" este. (Heredado de Object)
Flush(ByteBuffer)	Vacía este codificador.
GetHashCode()	Devuelve un valor de código hash del objeto. (Heredado de Object)
ImplFlush(ByteBuffer)	Vacía este codificador.
ImplOnMalformedInput(CodingErrorAction)	Informa de un cambio en la acción de entrada incorrecta de este codificador.
ImplOnUnmappableCharacter(CodingErrorAction)	Informa de un cambio en la acción unmappable-character de este codificador.
ImplReplaceWith(Byte[])	Informa de un cambio en el valor de reemplazo de este codificador.
ImplReset()	Restablece este codificador, borrando cualquier estado interno específico del conjunto de caracteres.
IsLegalReplacement(Byte[])	Indica si la matriz de bytes especificada es un valor de reemplazo legal para este codificador.
JavaFinalize()	Obsoletos. Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object)
MalformedInputAction()	Devuelve la acción actual de este codificador para los errores de entrada con formato incorrecto.
MaxBytesPerChar()	Devuelve el número máximo de bytes que se generarán para cada carácter de entrada.
Notify()	Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object)
NotifyAll()	Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object)
OnMalformedInput(CodingErrorAction)	Cambia la acción de este codificador para los errores de entrada incorrectos.
OnUnmappableCharacter(CodingErrorAction)	Cambia la acción de este codificador para los errores de caracteres que no se pueden aplicar.
Replacement()	Devuelve el valor de reemplazo de este codificador.
ReplaceWith(Byte[])	Cambia el valor de reemplazo de este codificador.
Reset()	Restablece este codificador, borrando cualquier estado interno.
SetHandle(IntPtr, JniHandleOwnership)	Establece la propiedad Handle. (Heredado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
ToArray<T>()	Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object)
ToString()	Devuelve una representación de cadena del objeto. (Heredado de Object)
UnmappableCharacterAction()	Devuelve la acción actual de este codificador para los errores de caracteres que no se pueden aplicar.
UnregisterFromRuntime()	Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object)
Wait()	Hace que el subproceso actual espere hasta que se despierta, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object)
Wait(Int64, Int32)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)
Wait(Int64)	Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object)

Implementaciones de interfaz explícitas

Nombre	Description
IJavaPeerable.Disposed()	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
IJavaPeerable.Finalized()	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico. (Heredado de JavaObject)

Métodos de extensión

Nombre	Description
GetJniTypeName(IJavaPeerable)	Obtiene el nombre JNI del tipo de la instancia self.
JavaAs<TResult>(IJavaPeerable)	Intente coerción self para escribir TResult, comprobando que la coerción es válida en el lado de Java.
JavaCast<TResult>(IJavaObject)	Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.
JavaCast<TResult>(IJavaObject)	Un motor que puede transformar una secuencia de dieciséis caracteres Unicode de dieciséis bits en una secuencia de bytes en un conjunto de caracteres específico.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Intente coerción self para escribir TResult, comprobando que la coerción es válida en el lado de Java.