Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe EncoderFallbackBuffer

 

Data di pubblicazione: novembre 2016

Fornisce un buffer che consente a un gestore di fallback di restituire una stringa alternativa a un codificatore quando non è in grado di codificare un carattere di input.

Spazio dei nomi:   System.Text
Assembly:  mscorlib (in mscorlib.dll)


public abstract class EncoderFallbackBuffer

NomeDescrizione
System_CAPS_protmethodEncoderFallbackBuffer()

Inizializza una nuova istanza della classe EncoderFallbackBuffer.

NomeDescrizione
System_CAPS_pubpropertyRemaining

Quando sottoposto a override in una classe derivata, ottiene il numero di caratteri nell'oggetto EncoderFallbackBuffer oggetto da elaborare.

NomeDescrizione
System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.(Ereditato da Object.)

System_CAPS_pubmethodFallback(Char, Char, Int32)

Quando sottoposto a override in una classe derivata, Prepara il buffer di fallback per gestire la coppia di surrogati specificato.

System_CAPS_pubmethodFallback(Char, Int32)

Quando sottoposto a override in una classe derivata, Prepara il buffer di fallback per gestire il carattere di input specificato.

System_CAPS_protmethodFinalize()

Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection.(Ereditato da Object.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetNextChar()

Quando sottoposto a override in una classe derivata, recupera il carattere successivo nel buffer di fallback.

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_pubmethodMovePrevious()

Quando sottoposto a override in una classe derivata, genera la chiamata successiva per il GetNextChar per accedere alla posizione di carattere del buffer di dati precedente alla posizione corrente.

System_CAPS_pubmethodReset()

Inizializza tutte le informazioni di dati e dello stato relative a questo buffer di fallback.

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente.(Ereditato da Object.)

Una codifica definisce un mapping tra un carattere Unicode e una sequenza di byte codificata. Un'operazione di codifica, che converte un carattere di input in una sequenza di byte di output, non riesce se è definito alcun mapping per un determinato carattere.

.NET Framework fornisce un meccanismo, denominato fallback, se non è possibile eseguire una conversione di gestione degli errori. Tutti i gestori di fallback del codificatore devono implementare le operazioni seguenti:

  • Un fallback del codificatore, rappresentato da una classe derivata dalla EncoderFallback classe.

  • Un buffer di fallback del codificatore, rappresentato da un tipo derivato dalla EncoderFallbackBuffer classe che può restituire una stringa per l'operazione di conversione.

I fallback possono utilizzare tre strategie per gestire gli errori di conversione:

  • Fallback con mapping. Il buffer di fallback del codificatore può restituire una stringa che rappresenta un'approssimazione molto vicina al carattere di input. .NET Framework non fornisce un mapping più appropriato pubblico EncoderFallbackBuffer implementazione.

  • Sostituzione. Il buffer di fallback del codificatore può restituire una stringa, ad esempio un punto interrogativo ("?"), che indica che un carattere non può essere codificato. In .NET Framework, il EncoderReplacementFallback e EncoderReplacementFallbackBuffer classi forniscono un'implementazione di buffer di fallback di sostituzione pubblica. Il costruttore della EncoderReplacementFallback classe consente di definire la stringa di sostituzione.

  • Eccezione. Il EncoderFallbackBuffer implementazione genera un'eccezione, che indica che un carattere non può essere codificato e termina l'operazione di codifica. In questo caso, il gestore di fallback è necessario fornire un EncoderFallbackBuffer implementazione, anche se non restituisce una stringa al codificatore. In .NET Framework, il EncoderExceptionFallback e EncoderExceptionFallbackBuffer classi forniscono un'implementazione del fallback di eccezione pubblica che genera un EncoderFallbackException quando un carattere non può essere codificato.

Buffer in un EncoderFallbackBuffer implementazione rappresenta l'intera stringa da restituire al codificatore in risposta a un codificatore di fallback. In genere, le implementazioni includono anche le informazioni sullo stato, ad esempio l'indice del carattere successivo da restituire al codificatore e il numero di caratteri rimanenti da restituire. Poiché EncoderFallbackBuffer è una classe astratta, richiede alle classi derivate di implementare i membri seguenti almeno:

  • Di overload Fallback metodo, che viene chiamato dal codificatore quando non è possibile codificare un carattere. Il codificatore passa due tipi di informazioni per l'implementazione del buffer di fallback: il carattere o coppia di surrogati che non può essere codificato e l'indice del carattere di input. In un gestore di eccezioni di fallback del codificatore, l'eccezione viene generata in questo metodo. In caso contrario, il metodo restituisce true se fornisce un fallback o false in caso contrario.

  • Il GetNextChar (metodo), che viene chiamato ripetutamente dal codificatore se il Fallback restituisce true. Nelle chiamate successive, il gestore deve restituire ogni carattere nel buffer. Se ha restituito tutti i caratteri, dovrebbe restituire U + 0000. Un gestore di eccezioni restituisce sempre U + 0000.

  • Il MovePrevious che tenta di spostare il puntatore alla posizione precedente nel buffer e indica se lo spostamento è riuscito. Restituisce sempre un gestore di eccezioni false.

  • Il Remaining proprietà, che indica il numero di caratteri rimanenti da restituire al codificatore. Un gestore di fallback di eccezione restituisce sempre zero.

Universal Windows Platform
Disponibile da 10
.NET Framework
Disponibile da 2.0

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: