String.IsNormalized Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Specifica se la stringa è in un particolare formato di normalizzazione Unicode.

Overload

IsNormalized()	Specifica se la stringa è nel formato di normalizzazione Unicode C.
IsNormalized(NormalizationForm)	Specifica se la stringa è nel formato di normalizzazione Unicode indicato.

Esempio

Nell'esempio seguente viene determinato se una stringa viene normalizzata correttamente in varie forme di normalizzazione.

C#

using System;
using System.Text;

class Example
{
    public static void Main()
    {
       // Character c; combining characters acute and cedilla; character 3/4
       string s1 = new String( new char[] {'\u0063', '\u0301', '\u0327', '\u00BE'});
       string s2 = null;
       string divider = new String('-', 80);
       divider = String.Concat(Environment.NewLine, divider, Environment.NewLine);

       Show("s1", s1);
       Console.WriteLine();
       Console.WriteLine("U+0063 = LATIN SMALL LETTER C");
       Console.WriteLine("U+0301 = COMBINING ACUTE ACCENT");
       Console.WriteLine("U+0327 = COMBINING CEDILLA");
       Console.WriteLine("U+00BE = VULGAR FRACTION THREE QUARTERS");
       Console.WriteLine(divider);

       Console.WriteLine("A1) Is s1 normalized to the default form (Form C)?: {0}",
                                    s1.IsNormalized());
       Console.WriteLine("A2) Is s1 normalized to Form C?:  {0}",
                                    s1.IsNormalized(NormalizationForm.FormC));
       Console.WriteLine("A3) Is s1 normalized to Form D?:  {0}",
                                    s1.IsNormalized(NormalizationForm.FormD));
       Console.WriteLine("A4) Is s1 normalized to Form KC?: {0}",
                                    s1.IsNormalized(NormalizationForm.FormKC));
       Console.WriteLine("A5) Is s1 normalized to Form KD?: {0}",
                                    s1.IsNormalized(NormalizationForm.FormKD));

       Console.WriteLine(divider);

       Console.WriteLine("Set string s2 to each normalized form of string s1.");
       Console.WriteLine();
       Console.WriteLine("U+1E09 = LATIN SMALL LETTER C WITH CEDILLA AND ACUTE");
       Console.WriteLine("U+0033 = DIGIT THREE");
       Console.WriteLine("U+2044 = FRACTION SLASH");
       Console.WriteLine("U+0034 = DIGIT FOUR");
       Console.WriteLine(divider);

       s2 = s1.Normalize();
       Console.Write("B1) Is s2 normalized to the default form (Form C)?: ");
       Console.WriteLine(s2.IsNormalized());
       Show("s2", s2);
       Console.WriteLine();

       s2 = s1.Normalize(NormalizationForm.FormC);
       Console.Write("B2) Is s2 normalized to Form C?: ");
       Console.WriteLine(s2.IsNormalized(NormalizationForm.FormC));
       Show("s2", s2);
       Console.WriteLine();

       s2 = s1.Normalize(NormalizationForm.FormD);
       Console.Write("B3) Is s2 normalized to Form D?: ");
       Console.WriteLine(s2.IsNormalized(NormalizationForm.FormD));
       Show("s2", s2);
       Console.WriteLine();

       s2 = s1.Normalize(NormalizationForm.FormKC);
       Console.Write("B4) Is s2 normalized to Form KC?: ");
       Console.WriteLine(s2.IsNormalized(NormalizationForm.FormKC));
       Show("s2", s2);
       Console.WriteLine();

       s2 = s1.Normalize(NormalizationForm.FormKD);
       Console.Write("B5) Is s2 normalized to Form KD?: ");
       Console.WriteLine(s2.IsNormalized(NormalizationForm.FormKD));
       Show("s2", s2);
       Console.WriteLine();
    }

    private static void Show(string title, string s)
    {
       Console.Write("Characters in string {0} = ", title);
       foreach(short x in s) {
           Console.Write("{0:X4} ", x);
       }
       Console.WriteLine();
    }
}
/*
This example produces the following results:

Characters in string s1 = 0063 0301 0327 00BE

U+0063 = LATIN SMALL LETTER C
U+0301 = COMBINING ACUTE ACCENT
U+0327 = COMBINING CEDILLA
U+00BE = VULGAR FRACTION THREE QUARTERS

--------------------------------------------------------------------------------

A1) Is s1 normalized to the default form (Form C)?: False
A2) Is s1 normalized to Form C?:  False
A3) Is s1 normalized to Form D?:  False
A4) Is s1 normalized to Form KC?: False
A5) Is s1 normalized to Form KD?: False

--------------------------------------------------------------------------------

Set string s2 to each normalized form of string s1.

U+1E09 = LATIN SMALL LETTER C WITH CEDILLA AND ACUTE
U+0033 = DIGIT THREE
U+2044 = FRACTION SLASH
U+0034 = DIGIT FOUR

--------------------------------------------------------------------------------

B1) Is s2 normalized to the default form (Form C)?: True
Characters in string s2 = 1E09 00BE

B2) Is s2 normalized to Form C?: True
Characters in string s2 = 1E09 00BE

B3) Is s2 normalized to Form D?: True
Characters in string s2 = 0063 0327 0301 00BE

B4) Is s2 normalized to Form KC?: True
Characters in string s2 = 1E09 0033 2044 0034

B5) Is s2 normalized to Form KD?: True
Characters in string s2 = 0063 0327 0301 0033 2044 0034

*/

IsNormalized()

Origine:

String.cs

Specifica se la stringa è nel formato di normalizzazione Unicode C.

C#

public bool IsNormalized ();

Restituisce

Boolean

true se la stringa è in formato di normalizzazione C; in caso contrario, false.

Eccezioni

ArgumentException

L'istanza corrente contiene caratteri Unicode non validi.

Commenti

Alcuni caratteri Unicode hanno più rappresentazioni binarie equivalenti costituite da set di caratteri Unicode combinati e/o compositi. L'esistenza di più rappresentazioni per un singolo carattere complica la ricerca, l'ordinamento, la corrispondenza e altre operazioni.

Lo standard Unicode definisce un processo denominato normalizzazione che restituisce una rappresentazione binaria quando viene specificata una delle rappresentazioni binarie equivalenti di un carattere. La normalizzazione può essere eseguita con diversi algoritmi, detti forme di normalizzazione, che rispettano regole diverse. .NET supporta attualmente i moduli di normalizzazione C, D, KC e KD.

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

Note per i chiamanti

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

Vedi anche

• Normalize()

IsNormalized(NormalizationForm)

Origine:

String.cs

Specifica se la stringa è nel formato di normalizzazione Unicode indicato.

C#

public bool IsNormalized (System.Text.NormalizationForm normalizationForm);

Parametri

normalizationForm

NormalizationForm

Formato di normalizzazione Unicode.

Restituisce

Boolean

true se la stringa è nel formato di normalizzazione specificato dal parametro normalizationForm; in caso contrario, false.

Eccezioni

ArgumentException

L'istanza corrente contiene caratteri Unicode non validi.

Commenti

Alcuni caratteri Unicode hanno più rappresentazioni binarie equivalenti costituite da set di caratteri Unicode combinati e/o compositi. L'esistenza di più rappresentazioni per un singolo carattere complica la ricerca, l'ordinamento, la corrispondenza e altre operazioni.

Lo standard Unicode definisce un processo denominato normalizzazione che restituisce una rappresentazione binaria quando viene specificata una delle rappresentazioni binarie equivalenti di un carattere. La normalizzazione può essere eseguita con diversi algoritmi, detti forme di normalizzazione, che rispettano regole diverse. .NET supporta attualmente i moduli di normalizzazione C, D, KC e KD.

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

Note per i chiamanti

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

Vedi anche

• Normalize()