Char.ConvertFromUtf32(Int32) Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Convertit le point de code Unicode spécifié en une chaîne encodée UTF-16.

C#

public static string ConvertFromUtf32 (int utf32);

Paramètres

utf32

Int32

Point de code Unicode 21 bits.

Retours

String

Chaîne composée d'un objet Char ou d'une paire de substitution d'objets Char équivalents au point de code spécifié par le paramètre utf32.

Exceptions

ArgumentOutOfRangeException

utf32 n’est pas un point de code Unicode 21 bits valide compris entre U+0 et U+10FFFF, à l’exclusion de la plage de paires de substitution entre U+D800 et U+DFFF.

Exemples

L’exemple de code suivant illustre ConvertToUtf32 les ConvertFromUtf32 méthodes et.

C#

// This example demonstrates the Char.ConvertFromUtf32() method
//                           and Char.ConvertToUtf32() overloads.
using System;

class Sample
{
    public static void Main()
    {
    int letterA = 0x0041;  //U+00041 = LATIN CAPITAL LETTER A
    int music   = 0x1D161; //U+1D161 = MUSICAL SYMBOL SIXTEENTH NOTE
    string s1;
    string comment   = "Create a UTF-16 encoded string from a code point.";
    string comment1b = "Create a code point from a UTF-16 encoded string.";
    string comment2b = "Create a code point from a surrogate pair at a certain position in a string.";
    string comment2c = "Create a code point from a high surrogate and a low surrogate code point.";

//  Convert code point U+0041 to UTF-16. The UTF-16 equivalent of
//  U+0041 is a Char with hexadecimal value 0041.

    Console.WriteLine(comment);
    s1 = Char.ConvertFromUtf32(letterA);
    Console.Write("    1a) 0x{0:X} => ", letterA);
    Show(s1);
    Console.WriteLine();

//  Convert the lone UTF-16 character to a code point.

    Console.WriteLine(comment1b);
    letterA = Char.ConvertToUtf32(s1, 0);
    Console.Write("    1b) ");
    Show(s1);
    Console.WriteLine(" => 0x{0:X}", letterA);
    Console.WriteLine();

// -------------------------------------------------------------------

//  Convert the code point U+1D161 to UTF-16. The UTF-16 equivalent of
//  U+1D161 is a surrogate pair with hexadecimal values D834 and DD61.

    Console.WriteLine(comment);
    s1 = Char.ConvertFromUtf32(music);
    Console.Write("    2a) 0x{0:X} => ", music);
    Show(s1);
    Console.WriteLine();

//  Convert the surrogate pair in the string at index position
//  zero to a code point.

    Console.WriteLine(comment2b);
    music = Char.ConvertToUtf32(s1, 0);
    Console.Write("    2b) ");
    Show(s1);
    Console.WriteLine(" => 0x{0:X}", music);

//  Convert the high and low characters in the surrogate pair into a code point.

    Console.WriteLine(comment2c);
    music = Char.ConvertToUtf32(s1[0], s1[1]);
    Console.Write("    2c) ");
    Show(s1);
    Console.WriteLine(" => 0x{0:X}", music);
    }

    private static void Show(string s)
    {
    for (int x = 0; x < s.Length; x++)
        {
        Console.Write("0x{0:X}{1}",
                       (int)s[x],
                       ((x == s.Length-1)? String.Empty : ", "));
        }
    }
}
/*
This example produces the following results:

Create a UTF-16 encoded string from a code point.
    1a) 0x41 => 0x41
Create a code point from a UTF-16 encoded string.
    1b) 0x41 => 0x41

Create a UTF-16 encoded string from a code point.
    2a) 0x1D161 => 0xD834, 0xDD61
Create a code point from a surrogate pair at a certain position in a string.
    2b) 0xD834, 0xDD61 => 0x1D161
Create a code point from a high surrogate and a low surrogate code point.
    2c) 0xD834, 0xDD61 => 0x1D161

*/

Remarques

Utilisez cette méthode pour convertir un point de code Unicode 21 bits en chaîne encodée en UTF-16 avant de tester la chaîne avec des méthodes telles que IsLowSurrogate(Char) et IsHighSurrogate(Char) .

Un point de code valide en dehors du plan multilingue de base (BMP) génère toujours une paire de substitution valide. Toutefois, un point de code valide dans le BMP peut ne pas produire un résultat valide conformément à la norme Unicode, car aucun traitement linguistique n’est utilisé dans la conversion. Pour cette raison, utilisez la System.Text.UTF32Encoding classe pour convertir des données UTF-32 en bloc en données UTF-16 en bloc.

S’applique à

Voir aussi

• Rune
• ConvertToUtf32(Char, Char)
• UTF32Encoding