String.IsNormalized 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

指示此字符串是否符合特定的 Unicode 范式。

重载

IsNormalized()	指示此字符串是否符合 Unicode 范式 C。
IsNormalized(NormalizationForm)	指示此字符串是否符合指定的 Unicode 范式。

示例

以下示例确定字符串是否已成功规范化为各种规范化形式。

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

指示此字符串是否符合 Unicode 范式 C。

C#

public bool IsNormalized ();

返回

Boolean

如果此字符串符合范式 C，则为 true；否则为 false。

例外

ArgumentException

当前实例包含无效的 Unicode 字符。

注解

某些 Unicode 字符具有多个等效的二进制表示形式，由组合和/或复合 Unicode 字符集组成。 单个字符存在多个表示形式，使搜索、排序、匹配和其他操作复杂化。

Unicode 标准定义了一个称为规范化的过程，该进程在给定字符的任何等效二进制表示形式时返回一个二进制表示形式。 可以使用多种遵循不同规则的算法（称为规范化形式）来执行规范化。 .NET 目前支持规范化形式 C、D、KC 和 KD。

有关支持的 Unicode 规范化形式的说明，请参阅 System.Text.NormalizationForm。

调用方说明

方法 IsNormalized 在遇到字符串中的第一个非规范化字符时立即返回 false 。 因此，如果字符串包含非规范化字符，后跟无效的 Unicode 字符， Normalize 该方法将引发 ， ArgumentException 尽管 IsNormalized 返回 false。

另请参阅

• Normalize()

IsNormalized(NormalizationForm)

Source:

String.cs

指示此字符串是否符合指定的 Unicode 范式。

C#

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

参数

normalizationForm

NormalizationForm

一个 Unicode 范式。

返回

Boolean

如果此字符串符合由 true 参数指定的范式，则为 normalizationForm；否则为 false。

例外

ArgumentException

当前实例包含无效的 Unicode 字符。

注解

某些 Unicode 字符具有多个等效的二进制表示形式，由组合和/或复合 Unicode 字符集组成。 单个字符存在多个表示形式，使搜索、排序、匹配和其他操作复杂化。

Unicode 标准定义了一个称为规范化的过程，该进程在给定字符的任何等效二进制表示形式时返回一个二进制表示形式。 可以使用多种遵循不同规则的算法（称为规范化形式）来执行规范化。 .NET 目前支持规范化形式 C、D、KC 和 KD。

有关支持的 Unicode 规范化形式的说明，请参阅 System.Text.NormalizationForm。

调用方说明

方法 IsNormalized 在遇到字符串中的第一个非规范化字符时立即返回 false 。 因此，如果字符串包含非规范化字符，后跟无效的 Unicode 字符， Normalize 该方法将引发 ， ArgumentException 尽管 IsNormalized 返回 false。

另请参阅

• Normalize()