CharsetEncoder Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico.
[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
- Ereditarietà
- Attributi
Commenti
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico.
"passaggi">
La sequenza di caratteri di input viene fornita in un buffer di caratteri o in una serie di tali buffer. La sequenza di byte di output viene scritta in un buffer di byte o in una serie di tali buffer. È consigliabile usare sempre un codificatore eseguendo la sequenza di chiamate al metodo seguente, in seguito denominata operazione di codifica:
<Ol>
<li>
Reimpostare il codificatore tramite il #reset reset
metodo, a meno che non sia stato usato in precedenza;
</li>
<li>
Richiamare il #encode encode
metodo zero o più volte, purché sia disponibile un input aggiuntivo, passando false
per l'argomento endOfInput
e compilando il buffer di input e scaricando il buffer di output tra le chiamate;
</li>
<li>
Richiamare il #encode encode
metodo una volta finale, passando true
per l'argomento endOfInput
e quindi
</li>
<li>
Richiamare il #flush flush
metodo in modo che il codificatore possa scaricare qualsiasi stato interno nel buffer di output.
</li>
</Ol>
Ogni chiamata del #encode encode
metodo codifica il maggior numero possibile di caratteri dal buffer di input, scrivendo i byte risultanti nel buffer di output. Il #encode encode
metodo restituisce quando è necessario più input, quando non è presente spazio sufficiente nel buffer di output o quando si è verificato un errore di codifica. In ogni caso viene restituito un CoderResult
oggetto per descrivere il motivo della chiusura. Un invoker può esaminare questo oggetto e riempire il buffer di input, scaricare il buffer di output o tentare di eseguire il ripristino da un errore di codifica, in base alle esigenze e riprovare.
"ce">
Esistono due tipi generali di errori di codifica. Se la sequenza di caratteri di input non è una sequenza Unicode a sedici bit legale, l'input viene considerato in formato non valido. Se la sequenza di caratteri di input è legale ma non può essere mappata a una sequenza di byte valida nel set di caratteri specificato, è stato rilevato un carattere non verificabile .
"cae">
La modalità di gestione di un errore di codifica dipende dall'azione richiesta per quel tipo di errore, descritto da un'istanza della CodingErrorAction
classe . Le azioni di errore possibili riguardano CodingErrorAction#IGNORE ignorano l'input errato, CodingErrorAction#REPORT segnalano l'errore al invoker tramite l'oggetto restituito CoderResult
oppure CodingErrorAction#REPLACE sostituiscono l'input errato con il valore corrente della matrice di byte sostitutiva. Sostituzione
inizialmente è impostato sulla sostituzione predefinita del codificatore, che spesso (ma non sempre) ha il valore iniziale {
(byte)'?'
}
;
il relativo valore può essere modificato tramite il #replaceWith(byte[]) replaceWith
metodo .
L'azione predefinita per gli errori di input non valido e caratteri non modificabili consiste nel segnalarli a CodingErrorAction#REPORT. L'azione di errore di input in formato non valido può essere modificata tramite il #onMalformedInput(CodingErrorAction) onMalformedInput
metodo . L'azione non modificabile-carattere può essere modificata tramite il #onUnmappableCharacter(CodingErrorAction) onUnmappableCharacter
metodo .
Questa classe è progettata per gestire molti dettagli del processo di codifica, inclusa l'implementazione di azioni di errore. Un codificatore per un set di caratteri specifico, ovvero una sottoclasse concreta di questa classe, deve implementare solo il metodo astratto #encodeLoop encodeLoop
, che incapsula il ciclo di codifica di base. Una sottoclasse che gestisce lo stato interno deve anche eseguire l'override dei #implFlush implFlush
metodi e #implReset implReset
.
Le istanze di questa classe non sono sicure per l'uso da parte di più thread simultanei.
Aggiunta nella versione 1.4.
Documentazione java per java.nio.charset.CharsetEncoder
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal Android e usato in base ai termini descritti in 2.5 Attribution License Creative Commons 2.5 Attribution License.
Costruttori
CharsetEncoder(Charset, Single, Single) |
Inizializza un nuovo codificatore. |
CharsetEncoder(Charset, Single, Single, Byte[]) |
Inizializza un nuovo codificatore. |
CharsetEncoder(IntPtr, JniHandleOwnership) |
Costruttore utilizzato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime. |
Proprietà
Class |
Restituisce la classe di runtime di questo |
Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
JniIdentityHashCode |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
JniPeerMembers |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. |
PeerReference |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
ThresholdClass |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
ThresholdType |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
Metodi
AverageBytesPerChar() |
Restituisce il numero medio di byte che verranno generati per ogni carattere di input. |
CanEncode(Char) |
Indica se questo codificatore può codificare il carattere specificato. |
CanEncode(ICharSequence) |
Indica se questo codificatore può codificare la sequenza di caratteri specificata. |
CanEncode(String) |
Indica se questo codificatore può codificare la sequenza di caratteri specificata. |
Charset() |
Restituisce il set di caratteri che ha creato questo codificatore. |
Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da Object) |
Dispose() |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
Dispose(Boolean) |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
Encode(CharBuffer) |
Metodo pratico che codifica il contenuto rimanente di un singolo buffer di caratteri di input in un buffer di byte appena allocato. |
Encode(CharBuffer, ByteBuffer, Boolean) |
Codifica il maggior numero possibile di caratteri dal buffer di input specificato, scrivendo i risultati nel buffer di output specificato. |
EncodeLoop(CharBuffer, ByteBuffer) |
Codifica uno o più caratteri in uno o più byte. |
Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
Flush(ByteBuffer) |
Scarica questo codificatore. |
GetHashCode() |
Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object) |
ImplFlush(ByteBuffer) |
Scarica questo codificatore. |
ImplOnMalformedInput(CodingErrorAction) |
Segnala una modifica all'azione di input non valida del codificatore. |
ImplOnUnmappableCharacter(CodingErrorAction) |
Segnala una modifica all'azione non modificabile del codificatore. |
ImplReplaceWith(Byte[]) |
Segnala una modifica al valore di sostituzione del codificatore. |
ImplReset() |
Reimposta questo codificatore, cancellando qualsiasi stato interno specifico del set di caratteri. |
IsLegalReplacement(Byte[]) |
Indica se la matrice di byte specificata è un valore di sostituzione legale per questo codificatore. |
JavaFinalize() |
Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object) |
MalformedInputAction() |
Restituisce l'azione corrente del codificatore per gli errori di input in formato non valido. |
MaxBytesPerChar() |
Restituisce il numero massimo di byte che verranno generati per ogni carattere di input. |
Notify() |
Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
NotifyAll() |
Riattiva tutti i thread in attesa del monitoraggio di questo oggetto. (Ereditato da Object) |
OnMalformedInput(CodingErrorAction) |
Modifica l'azione del codificatore per gli errori di input in formato non valido. |
OnUnmappableCharacter(CodingErrorAction) |
Modifica l'azione del codificatore per gli errori di caratteri non verificabili. |
Replacement() |
Restituisce il valore di sostituzione del codificatore. |
ReplaceWith(Byte[]) |
Modifica il valore di sostituzione del codificatore. |
Reset() |
Reimposta questo codificatore, cancellando qualsiasi stato interno. |
SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
ToArray<T>() |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
ToString() |
Restituisce una rappresentazione in formato stringa dell'oggetto. (Ereditato da Object) |
UnmappableCharacterAction() |
Restituisce l'azione corrente del codificatore per errori di caratteri non verificabili. |
UnregisterFromRuntime() |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una>notifica</em> o <em>interrotto</em>. (Ereditato da Object) |
Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una notifica</>em> o <em>interrotto</em> o fino a quando non è trascorsa una certa quantità di tempo reale. (Ereditato da Object) |
Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere eseguendo <una notifica</>em> o <em>interrotto</em> o fino a quando non è trascorsa una certa quantità di tempo reale. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
IJavaPeerable.Disposed() |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
IJavaPeerable.DisposeUnlessReferenced() |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
IJavaPeerable.Finalized() |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
IJavaPeerable.JniManagedPeerState |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
IJavaPeerable.SetPeerReference(JniObjectReference) |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. (Ereditato da Object) |
Metodi di estensione
JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo verificato dal runtime Android. |
JavaCast<TResult>(IJavaObject) |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. |
GetJniTypeName(IJavaPeerable) |
Motore in grado di trasformare una sequenza di caratteri Unicode a sedici bit in una sequenza di byte in un set di caratteri specifico. |