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

Metodo String.Normalize ()

 

Data di pubblicazione: ottobre 2016

Restituisce una nuova stringa il cui valore testuale è lo stesso di questa stringa ma la cui rappresentazione binaria è nel formato di normalizzazione Unicode C.

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

member Normalize : unit -> string

Valore restituito

Type: System.String

Nuova stringa normalizzata il cui valore testuale è lo stesso di questa stringa ma la cui rappresentazione binaria è nel formato di normalizzazione Unicode C.

Exception Condition
ArgumentException

L'istanza corrente contiene caratteri Unicode non validi.

Alcuni caratteri Unicode hanno più rappresentazioni binarie equivalenti formate da set di combinazione e/o i caratteri Unicode composti. Uno dei punti di codice seguente, ad esempio, può rappresentare la lettera "ắ":

  • U + 1EAF

  • U + 0103 U + 0301

  • U + 0061 U + 0306 U + 0301

L'esistenza di più rappresentazioni di un singolo carattere complica la ricerca, ordinamento, corrispondenza e altre operazioni.

Lo standard Unicode definisce un processo denominato normalizzazione che restituisce una rappresentazione binaria quando viene fornito qualsiasi rappresentazione binaria equivalente di un carattere. La normalizzazione può essere eseguita con diversi algoritmi, denominati normalizzazione, che sono conformi alle regole diverse. .NET Framework supporta quattro forme di normalizzazione (C, D, KC e KD) che sono definite dallo standard Unicode. Quando due stringhe sono rappresentate nello stesso formato di normalizzazione, theycan essere confrontati utilizzando il confronto ordinale.

Per normalizzare e confrontare due stringhe, eseguire le operazioni seguenti:

  1. Ottenere le stringhe da confrontare da un'origine di input, ad esempio un file o un dispositivo di input dell'utente.

  2. Chiamare il Normalize() metodo normalizzare le stringhe di formato di normalizzazione Unicode C.

  3. Per confrontare due stringhe, chiamare un metodo che supporta il confronto ordinale tra stringhe, ad esempio il Compare(String, String, StringComparison) (metodo), quindi specificare un valore di StringComparison.Ordinal o StringComparison.OrdinalIgnoreCasecome il StringComparison argomento. Per ordinare una matrice di stringhe normalizzate, passare un comparer valore StringComparer.Ordinal o StringComparer.OrdinalIgnoreCase a un overload appropriato del Array.Sort.

  4. Generare le stringhe nell'output ordinato in base all'ordine indicato nel passaggio precedente.

Per una descrizione dei formati di normalizzazione Unicode, vedere System.Text.NormalizationForm.

Note per i chiamanti:

Il IsNormalized restituisce false non appena viene rilevato il primo carattere non normalizzato in una stringa. Pertanto, se una stringa contiene caratteri non normalizzato seguiti da caratteri Unicode non validi, il Normalize metodo genererà un' ArgumentException Sebbene IsNormalized restituisce false.

Nell'esempio seguente una stringa in ognuno dei quattro normalizzazione Normalizza, conferma che la stringa di formato di normalizzazione specificato e quindi vengono elencati i punti di codice nella stringa normalizzata.

Non sono attualmente disponibili esempi di codice o questo linguaggio potrebbe non essere supportato.

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: