String.IsNormalized Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Indica si esta cadena tiene una forma de normalización Unicode determinada.

Sobrecargas

IsNormalized()	Indica si esta cadena tiene la forma de normalización Unicode C.
IsNormalized(NormalizationForm)	Indica si esta cadena tiene la forma de normalización Unicode especificada.

Ejemplos

En el ejemplo siguiente se determina si una cadena se normaliza correctamente en varios formularios de normalización.

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()

Source:

String.cs

Indica si esta cadena tiene la forma de normalización Unicode C.

C#

public bool IsNormalized ();

Devoluciones

Boolean

true si esta cadena tiene la forma de normalización C; en caso contrario, false.

Excepciones

ArgumentException

La instancia actual contiene caracteres Unicode no válidos.

Comentarios

Algunos caracteres Unicode tienen varias representaciones binarias equivalentes que constan de conjuntos de caracteres Unicode combinados o compuestos. La existencia de varias representaciones para un solo carácter complica la búsqueda, la ordenación, la coincidencia y otras operaciones.

El estándar Unicode define un proceso denominado normalización que devuelve una representación binaria cuando se da cualquiera de las representaciones binarias equivalentes de un carácter. La normalización se puede realizar con varios algoritmos, denominados formularios de normalización, que obedecen a reglas diferentes. .NET admite actualmente los formularios de normalización C, D, KC y KD.

Para obtener una descripción de los formularios de normalización Unicode admitidos, vea System.Text.NormalizationForm.

Notas a los autores de las llamadas

El IsNormalized método devuelve false tan pronto como encuentre el primer carácter no normalizado en una cadena. Por lo tanto, si una cadena contiene caracteres no normalizados seguidos de caracteres Unicode no válidos, el Normalize método producirá una ArgumentException excepción aunque IsNormalized devuelve false.

Consulte también

• Normalize()

IsNormalized(NormalizationForm)

Source:

String.cs

Indica si esta cadena tiene la forma de normalización Unicode especificada.

C#

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

Parámetros

normalizationForm

NormalizationForm

Forma de normalización Unicode.

Devoluciones

Boolean

true si esta cadena tiene la forma de normalización especificada por el parámetro normalizationForm; en caso contrario, false.

Excepciones

ArgumentException

La instancia actual contiene caracteres Unicode no válidos.

Comentarios

Algunos caracteres Unicode tienen varias representaciones binarias equivalentes que constan de conjuntos de caracteres Unicode combinados o compuestos. La existencia de varias representaciones para un solo carácter complica la búsqueda, la ordenación, la coincidencia y otras operaciones.

El estándar Unicode define un proceso denominado normalización que devuelve una representación binaria cuando se da cualquiera de las representaciones binarias equivalentes de un carácter. La normalización se puede realizar con varios algoritmos, denominados formularios de normalización, que obedecen a reglas diferentes. .NET admite actualmente los formularios de normalización C, D, KC y KD.

Para obtener una descripción de los formularios de normalización Unicode admitidos, vea System.Text.NormalizationForm.

Notas a los autores de las llamadas

El IsNormalized método devuelve false tan pronto como encuentre el primer carácter no normalizado en una cadena. Por lo tanto, si una cadena contiene caracteres no normalizados seguidos de caracteres Unicode no válidos, el Normalize método producirá una ArgumentException excepción aunque IsNormalized devuelve false.

Consulte también

• Normalize()