Char Structure
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente un caractère sous la forme d’une unité de code UTF-16.
public value class char : IComparable, IComparable<char>, IConvertible, IEquatable<char>
public value class char : IComparable<char>, IConvertible, IEquatable<char>, IParsable<char>, ISpanParsable<char>, IUtf8SpanParsable<char>, System::Numerics::IAdditionOperators<char, char, char>, System::Numerics::IAdditiveIdentity<char, char>, System::Numerics::IBinaryInteger<char>, System::Numerics::IBinaryNumber<char>, System::Numerics::IBitwiseOperators<char, char, char>, System::Numerics::IComparisonOperators<char, char, bool>, System::Numerics::IDecrementOperators<char>, System::Numerics::IDivisionOperators<char, char, char>, System::Numerics::IEqualityOperators<char, char, bool>, System::Numerics::IIncrementOperators<char>, System::Numerics::IMinMaxValue<char>, System::Numerics::IModulusOperators<char, char, char>, System::Numerics::IMultiplicativeIdentity<char, char>, System::Numerics::IMultiplyOperators<char, char, char>, System::Numerics::INumber<char>, System::Numerics::INumberBase<char>, System::Numerics::IShiftOperators<char, int, char>, System::Numerics::ISubtractionOperators<char, char, char>, System::Numerics::IUnaryNegationOperators<char, char>, System::Numerics::IUnaryPlusOperators<char, char>, System::Numerics::IUnsignedNumber<char>
public value class char : IComparable, IComparable<char>, IConvertible, IEquatable<char>, ISpanFormattable
public value class char : IComparable<char>, IConvertible, IEquatable<char>, IParsable<char>, ISpanParsable<char>, System::Numerics::IAdditionOperators<char, char, char>, System::Numerics::IAdditiveIdentity<char, char>, System::Numerics::IBinaryInteger<char>, System::Numerics::IBinaryNumber<char>, System::Numerics::IBitwiseOperators<char, char, char>, System::Numerics::IComparisonOperators<char, char, bool>, System::Numerics::IDecrementOperators<char>, System::Numerics::IDivisionOperators<char, char, char>, System::Numerics::IEqualityOperators<char, char, bool>, System::Numerics::IIncrementOperators<char>, System::Numerics::IMinMaxValue<char>, System::Numerics::IModulusOperators<char, char, char>, System::Numerics::IMultiplicativeIdentity<char, char>, System::Numerics::IMultiplyOperators<char, char, char>, System::Numerics::INumber<char>, System::Numerics::INumberBase<char>, System::Numerics::IShiftOperators<char, int, char>, System::Numerics::ISubtractionOperators<char, char, char>, System::Numerics::IUnaryNegationOperators<char, char>, System::Numerics::IUnaryPlusOperators<char, char>, System::Numerics::IUnsignedNumber<char>
public value class char : IComparable, IConvertible
public value class char : IComparable, IComparable<char>, IEquatable<char>
public struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>
public readonly struct Char : IComparable<char>, IConvertible, IEquatable<char>, IParsable<char>, ISpanParsable<char>, IUtf8SpanParsable<char>, System.Numerics.IAdditionOperators<char,char,char>, System.Numerics.IAdditiveIdentity<char,char>, System.Numerics.IBinaryInteger<char>, System.Numerics.IBinaryNumber<char>, System.Numerics.IBitwiseOperators<char,char,char>, System.Numerics.IComparisonOperators<char,char,bool>, System.Numerics.IDecrementOperators<char>, System.Numerics.IDivisionOperators<char,char,char>, System.Numerics.IEqualityOperators<char,char,bool>, System.Numerics.IIncrementOperators<char>, System.Numerics.IMinMaxValue<char>, System.Numerics.IModulusOperators<char,char,char>, System.Numerics.IMultiplicativeIdentity<char,char>, System.Numerics.IMultiplyOperators<char,char,char>, System.Numerics.INumber<char>, System.Numerics.INumberBase<char>, System.Numerics.IShiftOperators<char,int,char>, System.Numerics.ISubtractionOperators<char,char,char>, System.Numerics.IUnaryNegationOperators<char,char>, System.Numerics.IUnaryPlusOperators<char,char>, System.Numerics.IUnsignedNumber<char>
public readonly struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>
public readonly struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>, ISpanFormattable
public readonly struct Char : IComparable<char>, IConvertible, IEquatable<char>, IParsable<char>, ISpanParsable<char>, System.Numerics.IAdditionOperators<char,char,char>, System.Numerics.IAdditiveIdentity<char,char>, System.Numerics.IBinaryInteger<char>, System.Numerics.IBinaryNumber<char>, System.Numerics.IBitwiseOperators<char,char,char>, System.Numerics.IComparisonOperators<char,char,bool>, System.Numerics.IDecrementOperators<char>, System.Numerics.IDivisionOperators<char,char,char>, System.Numerics.IEqualityOperators<char,char,bool>, System.Numerics.IIncrementOperators<char>, System.Numerics.IMinMaxValue<char>, System.Numerics.IModulusOperators<char,char,char>, System.Numerics.IMultiplicativeIdentity<char,char>, System.Numerics.IMultiplyOperators<char,char,char>, System.Numerics.INumber<char>, System.Numerics.INumberBase<char>, System.Numerics.IShiftOperators<char,int,char>, System.Numerics.ISubtractionOperators<char,char,char>, System.Numerics.IUnaryNegationOperators<char,char>, System.Numerics.IUnaryPlusOperators<char,char>, System.Numerics.IUnsignedNumber<char>
[System.Serializable]
public struct Char : IComparable, IConvertible
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public struct Char : IComparable, IComparable<char>, IConvertible, IEquatable<char>
public struct Char : IComparable, IComparable<char>, IEquatable<char>
type char = struct
interface IConvertible
type char = struct
interface IConvertible
interface IFormattable
interface IParsable<char>
interface ISpanFormattable
interface ISpanParsable<char>
interface IUtf8SpanFormattable
interface IUtf8SpanParsable<char>
interface IAdditionOperators<char, char, char>
interface IAdditiveIdentity<char, char>
interface IBinaryInteger<char>
interface IBinaryNumber<char>
interface IBitwiseOperators<char, char, char>
interface IComparisonOperators<char, char, bool>
interface IEqualityOperators<char, char, bool>
interface IDecrementOperators<char>
interface IDivisionOperators<char, char, char>
interface IIncrementOperators<char>
interface IModulusOperators<char, char, char>
interface IMultiplicativeIdentity<char, char>
interface IMultiplyOperators<char, char, char>
interface INumber<char>
interface INumberBase<char>
interface ISubtractionOperators<char, char, char>
interface IUnaryNegationOperators<char, char>
interface IUnaryPlusOperators<char, char>
interface IShiftOperators<char, int, char>
interface IMinMaxValue<char>
interface IUnsignedNumber<char>
type char = struct
interface IConvertible
interface ISpanFormattable
interface IFormattable
type char = struct
interface IConvertible
interface IFormattable
interface IParsable<char>
interface ISpanFormattable
interface ISpanParsable<char>
interface IAdditionOperators<char, char, char>
interface IAdditiveIdentity<char, char>
interface IBinaryInteger<char>
interface IBinaryNumber<char>
interface IBitwiseOperators<char, char, char>
interface IComparisonOperators<char, char, bool>
interface IEqualityOperators<char, char, bool>
interface IDecrementOperators<char>
interface IDivisionOperators<char, char, char>
interface IIncrementOperators<char>
interface IModulusOperators<char, char, char>
interface IMultiplicativeIdentity<char, char>
interface IMultiplyOperators<char, char, char>
interface INumber<char>
interface INumberBase<char>
interface ISubtractionOperators<char, char, char>
interface IUnaryNegationOperators<char, char>
interface IUnaryPlusOperators<char, char>
interface IShiftOperators<char, int, char>
interface IMinMaxValue<char>
interface IUnsignedNumber<char>
type char = struct
interface IConvertible
interface IFormattable
interface IParsable<char>
interface ISpanFormattable
interface ISpanParsable<char>
interface IAdditionOperators<char, char, char>
interface IAdditiveIdentity<char, char>
interface IBinaryInteger<char>
interface IBinaryNumber<char>
interface IBitwiseOperators<char, char, char>
interface IComparisonOperators<char, char, bool>
interface IEqualityOperators<char, char, bool>
interface IDecrementOperators<char>
interface IDivisionOperators<char, char, char>
interface IIncrementOperators<char>
interface IModulusOperators<char, char, char>
interface IMultiplicativeIdentity<char, char>
interface IMultiplyOperators<char, char, char>
interface INumber<char>
interface INumberBase<char>
interface ISubtractionOperators<char, char, char>
interface IUnaryNegationOperators<char, char>
interface IUnaryPlusOperators<char, char>
interface IUtf8SpanFormattable
interface IUtf8SpanParsable<char>
interface IShiftOperators<char, int, char>
interface IMinMaxValue<char>
interface IUnsignedNumber<char>
[<System.Serializable>]
type char = struct
interface IConvertible
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type char = struct
interface IConvertible
type char = struct
Public Structure Char
Implements IComparable, IComparable(Of Char), IConvertible, IEquatable(Of Char)
Public Structure Char
Implements IAdditionOperators(Of Char, Char, Char), IAdditiveIdentity(Of Char, Char), IBinaryInteger(Of Char), IBinaryNumber(Of Char), IBitwiseOperators(Of Char, Char, Char), IComparable(Of Char), IComparisonOperators(Of Char, Char, Boolean), IConvertible, IDecrementOperators(Of Char), IDivisionOperators(Of Char, Char, Char), IEqualityOperators(Of Char, Char, Boolean), IEquatable(Of Char), IIncrementOperators(Of Char), IMinMaxValue(Of Char), IModulusOperators(Of Char, Char, Char), IMultiplicativeIdentity(Of Char, Char), IMultiplyOperators(Of Char, Char, Char), INumber(Of Char), INumberBase(Of Char), IParsable(Of Char), IShiftOperators(Of Char, Integer, Char), ISpanParsable(Of Char), ISubtractionOperators(Of Char, Char, Char), IUnaryNegationOperators(Of Char, Char), IUnaryPlusOperators(Of Char, Char), IUnsignedNumber(Of Char), IUtf8SpanParsable(Of Char)
Public Structure Char
Implements IComparable, IComparable(Of Char), IConvertible, IEquatable(Of Char), ISpanFormattable
Public Structure Char
Implements IAdditionOperators(Of Char, Char, Char), IAdditiveIdentity(Of Char, Char), IBinaryInteger(Of Char), IBinaryNumber(Of Char), IBitwiseOperators(Of Char, Char, Char), IComparable(Of Char), IComparisonOperators(Of Char, Char, Boolean), IConvertible, IDecrementOperators(Of Char), IDivisionOperators(Of Char, Char, Char), IEqualityOperators(Of Char, Char, Boolean), IEquatable(Of Char), IIncrementOperators(Of Char), IMinMaxValue(Of Char), IModulusOperators(Of Char, Char, Char), IMultiplicativeIdentity(Of Char, Char), IMultiplyOperators(Of Char, Char, Char), INumber(Of Char), INumberBase(Of Char), IParsable(Of Char), IShiftOperators(Of Char, Integer, Char), ISpanParsable(Of Char), ISubtractionOperators(Of Char, Char, Char), IUnaryNegationOperators(Of Char, Char), IUnaryPlusOperators(Of Char, Char), IUnsignedNumber(Of Char)
Public Structure Char
Implements IComparable, IConvertible
Public Structure Char
Implements IComparable, IComparable(Of Char), IEquatable(Of Char)
- Héritage
- Attributs
- Implémente
-
IComparable IComparable<Char> IConvertible IEquatable<Char> IComparable<TSelf> IEquatable<TSelf> IFormattable IParsable<Char> IParsable<TSelf> ISpanFormattable ISpanParsable<Char> ISpanParsable<TSelf> IUtf8SpanFormattable IUtf8SpanParsable<Char> IUtf8SpanParsable<TSelf> IAdditionOperators<Char,Char,Char> IAdditionOperators<TSelf,TSelf,TSelf> IAdditiveIdentity<Char,Char> IAdditiveIdentity<TSelf,TSelf> IBinaryInteger<Char> IBinaryNumber<Char> IBinaryNumber<TSelf> IBitwiseOperators<Char,Char,Char> IBitwiseOperators<TSelf,TSelf,TSelf> IComparisonOperators<Char,Char,Boolean> IComparisonOperators<TSelf,TSelf,Boolean> IDecrementOperators<Char> IDecrementOperators<TSelf> IDivisionOperators<Char,Char,Char> IDivisionOperators<TSelf,TSelf,TSelf> IEqualityOperators<Char,Char,Boolean> IEqualityOperators<TSelf,TOther,TResult> IEqualityOperators<TSelf,TSelf,Boolean> IIncrementOperators<Char> IIncrementOperators<TSelf> IMinMaxValue<Char> IModulusOperators<Char,Char,Char> IModulusOperators<TSelf,TSelf,TSelf> IMultiplicativeIdentity<Char,Char> IMultiplicativeIdentity<TSelf,TSelf> IMultiplyOperators<Char,Char,Char> IMultiplyOperators<TSelf,TSelf,TSelf> INumber<Char> INumber<TSelf> INumberBase<Char> INumberBase<TSelf> IShiftOperators<Char,Int32,Char> IShiftOperators<TSelf,Int32,TSelf> ISubtractionOperators<Char,Char,Char> ISubtractionOperators<TSelf,TSelf,TSelf> IUnaryNegationOperators<Char,Char> IUnaryNegationOperators<TSelf,TSelf> IUnaryPlusOperators<Char,Char> IUnaryPlusOperators<TSelf,TSelf> IUnsignedNumber<Char>
Exemples
L’exemple de code suivant illustre certaines des méthodes dans Char.
using System;
public class CharStructureSample
{
public static void Main()
{
char chA = 'A';
char ch1 = '1';
string str = "test string";
Console.WriteLine(chA.CompareTo('B')); //----------- Output: "-1" (meaning 'A' is 1 less than 'B')
Console.WriteLine(chA.Equals('A')); //----------- Output: "True"
Console.WriteLine(Char.GetNumericValue(ch1)); //----------- Output: "1"
Console.WriteLine(Char.IsControl('\t')); //----------- Output: "True"
Console.WriteLine(Char.IsDigit(ch1)); //----------- Output: "True"
Console.WriteLine(Char.IsLetter(',')); //----------- Output: "False"
Console.WriteLine(Char.IsLower('u')); //----------- Output: "True"
Console.WriteLine(Char.IsNumber(ch1)); //----------- Output: "True"
Console.WriteLine(Char.IsPunctuation('.')); //----------- Output: "True"
Console.WriteLine(Char.IsSeparator(str, 4)); //----------- Output: "True"
Console.WriteLine(Char.IsSymbol('+')); //----------- Output: "True"
Console.WriteLine(Char.IsWhiteSpace(str, 4)); //----------- Output: "True"
Console.WriteLine(Char.Parse("S")); //----------- Output: "S"
Console.WriteLine(Char.ToLower('M')); //----------- Output: "m"
Console.WriteLine('x'.ToString()); //----------- Output: "x"
}
}
open System
let chA = 'A'
let ch1 = '1'
let str = "test string"
printfn $"{chA.CompareTo 'B'}" //----------- Output: "-1" (meaning 'A' is 1 less than 'B')
printfn $"{chA.Equals 'A'}" //----------- Output: "True"
printfn $"{Char.GetNumericValue ch1}" //----------- Output: "1"
printfn $"{Char.IsControl '\t'}" //----------- Output: "True"
printfn $"{Char.IsDigit ch1}" //----------- Output: "True"
printfn $"{Char.IsLetter ','}" //----------- Output: "False"
printfn $"{Char.IsLower 'u'}" //----------- Output: "True"
printfn $"{Char.IsNumber ch1}" //----------- Output: "True"
printfn $"{Char.IsPunctuation '.'}" //----------- Output: "True"
printfn $"{Char.IsSeparator(str, 4)}" //----------- Output: "True"
printfn $"{Char.IsSymbol '+'}" //----------- Output: "True"
printfn $"{Char.IsWhiteSpace(str, 4)}" //----------- Output: "True"
printfn $"""{Char.Parse "S"}""" //----------- Output: "S"
printfn $"{Char.ToLower 'M'}" //----------- Output: "m"
printfn $"{'x'}" //----------- Output: "x"
Module CharStructure
Public Sub Main()
Dim chA As Char
chA = "A"c
Dim ch1 As Char
ch1 = "1"c
Dim str As String
str = "test string"
Console.WriteLine(chA.CompareTo("B"c)) ' Output: "-1" (meaning 'A' is 1 less than 'B')
Console.WriteLine(chA.Equals("A"c)) ' Output: "True"
Console.WriteLine(Char.GetNumericValue(ch1)) ' Output: "1"
Console.WriteLine(Char.IsControl(Chr(9))) ' Output: "True"
Console.WriteLine(Char.IsDigit(ch1)) ' Output: "True"
Console.WriteLine(Char.IsLetter(","c)) ' Output: "False"
Console.WriteLine(Char.IsLower("u"c)) ' Output: "True"
Console.WriteLine(Char.IsNumber(ch1)) ' Output: "True"
Console.WriteLine(Char.IsPunctuation("."c)) ' Output: "True"
Console.WriteLine(Char.IsSeparator(str, 4)) ' Output: "True"
Console.WriteLine(Char.IsSymbol("+"c)) ' Output: "True"
Console.WriteLine(Char.IsWhiteSpace(str, 4)) ' Output: "True"
Console.WriteLine(Char.Parse("S")) ' Output: "S"
Console.WriteLine(Char.ToLower("M"c)) ' Output: "m"
Console.WriteLine("x"c.ToString()) ' Output: "x"
End Sub
End Module
Remarques
La Char structure représente des points de code Unicode à l’aide de l’encodage UTF-16. La valeur d'un objet Char est sa valeur numérique (ordinale) de 16-bits.
Si vous n’êtes pas familiarisé avec Unicode, les valeurs scalaires, les points de code, les paires de substitution, UTF-16 et le type, consultez Présentation de l’encodage Runede caractères dans .NET.
Cet article examine la relation entre un Char objet et un caractère et décrit certaines tâches courantes effectuées avec Char des instances. Nous vous recommandons de considérer le type Rune, introduit dans .NET Core 3.0, comme alternative à Char pour l'exécution de certaines de ces tâches.
Objets Char, caractères Unicode et chaînes
Un String objet est une collection séquentielle de Char structures qui représente une chaîne de texte. La plupart des caractères Unicode peuvent être représentés par un objet unique Char , mais un caractère encodé en tant que caractère de base, paire de substitution et/ou séquence de caractères combinant est représenté par plusieurs Char objets. Pour cette raison, une Char structure dans un String objet n’est pas nécessairement équivalente à un caractère Unicode unique.
Plusieurs unités de code 16 bits sont utilisées pour représenter des caractères Unicode uniques dans les cas suivants :
Glyphes, qui peuvent être constitués d’un caractère unique ou d’un caractère de base suivi d’un ou plusieurs caractères combinés. Par exemple, le caractère ä est représenté par un Char objet dont l’unité de code est U+0061 suivie d’un Char objet dont l’unité de code est U+0308. (Le caractère ä peut également être défini par un seul Char objet qui a une unité de code de U+00E4.) L’exemple suivant illustre que le caractère ä se compose de deux Char objets.
using System; using System.IO; public class Example1 { public static void Main() { StreamWriter sw = new StreamWriter("chars1.txt"); char[] chars = [ '\u0061', '\u0308' ]; string strng = new String(chars); sw.WriteLine(strng); sw.Close(); } } // The example produces the following output: // äopen System open System.IO let sw = new StreamWriter("chars1.txt") let chars = [| '\u0061'; '\u0308' |] let string = String chars sw.WriteLine string sw.Close() // The example produces the following output: // äImports System.IO Module Example2 Public Sub Main() Dim sw As New StreamWriter("chars1.txt") Dim chars() As Char = {ChrW(&H61), ChrW(&H308)} Dim strng As New String(chars) sw.WriteLine(strng) sw.Close() End Sub End Module ' The example produces the following output: ' äCaractères en dehors du plan multilingue de base d’Unicode (BMP). Unicode prend en charge seize plans en plus du BMP, qui représente le plan 0. Un point de code Unicode est représenté dans UTF-32 par une valeur 21 bits qui inclut le plan. Par exemple, U+1D160 représente le caractère SYMBOLE MUSICAL DE LA HUITIÈME NOTE Étant donné que l’encodage UTF-16 n’a que 16 bits, les caractères en dehors du BMP sont représentés par des paires de substitution dans UTF-16. L’exemple suivant illustre que l’équivalent UTF-32 de U+1D160, le caractère SYMBOLE MUSICAL DE LA HUITIÈME NOTE, est U+D834 U+DD60. U+D834 est le substitut élevé ; les substituts élevés vont de U+D800 à U+DBFF. U+DD60 est le substitut faible ; les substituts faibles vont de U+DC00 à U+DFFF.
using System; using System.IO; public class Example3 { public static void Main() { StreamWriter sw = new StreamWriter(@".\chars2.txt"); int utf32 = 0x1D160; string surrogate = Char.ConvertFromUtf32(utf32); sw.WriteLine($"U+{utf32:X6} UTF-32 = {surrogate} ({ShowCodePoints(surrogate)}) UTF-16"); sw.Close(); } private static string ShowCodePoints(string value) { string retval = null; foreach (var ch in value) retval += $"U+{Convert.ToUInt16(ch):X4} "; return retval.Trim(); } } // The example produces the following output: // U+01D160 UTF-32 = ð (U+D834 U+DD60) UTF-16open System open System.IO let showCodePoints (value: char seq) = let str = value |> Seq.map (fun ch -> $"U+{Convert.ToUInt16 ch:X4}") |> String.concat "" str.Trim() let sw = new StreamWriter(@".\chars2.txt") let utf32 = 0x1D160 let surrogate = Char.ConvertFromUtf32 utf32 sw.WriteLine $"U+{utf32:X6} UTF-32 = {surrogate} ({showCodePoints surrogate}) UTF-16" sw.Close() // The example produces the following output: // U+01D160 UTF-32 = ð (U+D834 U+DD60) UTF-16Imports System.IO Module Example4 Public Sub Main() Dim sw As New StreamWriter(".\chars2.txt") Dim utf32 As Integer = &H1D160 Dim surrogate As String = Char.ConvertFromUtf32(utf32) sw.WriteLine("U+{0:X6} UTF-32 = {1} ({2}) UTF-16", utf32, surrogate, ShowCodePoints(surrogate)) sw.Close() End Sub Private Function ShowCodePoints(value As String) As String Dim retval As String = Nothing For Each ch In value retval += String.Format("U+{0:X4} ", Convert.ToUInt16(ch)) Next Return retval.Trim() End Function End Module ' The example produces the following output: ' U+01D160 UTF-32 = ð (U+D834 U+DD60) UTF-16
Caractères et catégories de caractères
Chaque caractère Unicode ou paire de substitution valide appartient à une catégorie Unicode. Dans .NET, les catégories Unicode sont représentées par les membres de l’énumération UnicodeCategory et incluent des valeurs telles que UnicodeCategory.CurrencySymbol, UnicodeCategory.LowercaseLetteret UnicodeCategory.SpaceSeparator, par exemple.
Pour déterminer la catégorie Unicode d’un caractère, appelez la GetUnicodeCategory méthode. Par exemple, l'exemple suivant appelle la fonction GetUnicodeCategory pour afficher la catégorie Unicode de chaque caractère dans une chaîne. L’exemple fonctionne correctement uniquement s’il n’existe aucune paire de substitution dans l’instance String .
using System;
using System.Globalization;
class Example
{
public static void Main()
{
// Define a string with a variety of character categories.
String s = "The red car drove down the long, narrow, secluded road.";
// Determine the category of each character.
foreach (var ch in s)
Console.WriteLine($"'{ch}': {Char.GetUnicodeCategory(ch)}");
}
}
// The example displays the following output:
// 'T': UppercaseLetter
// 'h': LowercaseLetter
// 'e': LowercaseLetter
// ' ': SpaceSeparator
// 'r': LowercaseLetter
// 'e': LowercaseLetter
// 'd': LowercaseLetter
// ' ': SpaceSeparator
// 'c': LowercaseLetter
// 'a': LowercaseLetter
// 'r': LowercaseLetter
// ' ': SpaceSeparator
// 'd': LowercaseLetter
// 'r': LowercaseLetter
// 'o': LowercaseLetter
// 'v': LowercaseLetter
// 'e': LowercaseLetter
// ' ': SpaceSeparator
// 'd': LowercaseLetter
// 'o': LowercaseLetter
// 'w': LowercaseLetter
// 'n': LowercaseLetter
// ' ': SpaceSeparator
// 't': LowercaseLetter
// 'h': LowercaseLetter
// 'e': LowercaseLetter
// ' ': SpaceSeparator
// 'l': LowercaseLetter
// 'o': LowercaseLetter
// 'n': LowercaseLetter
// 'g': LowercaseLetter
// ',': OtherPunctuation
// ' ': SpaceSeparator
// 'n': LowercaseLetter
// 'a': LowercaseLetter
// 'r': LowercaseLetter
// 'r': LowercaseLetter
// 'o': LowercaseLetter
// 'w': LowercaseLetter
// ',': OtherPunctuation
// ' ': SpaceSeparator
// 's': LowercaseLetter
// 'e': LowercaseLetter
// 'c': LowercaseLetter
// 'l': LowercaseLetter
// 'u': LowercaseLetter
// 'd': LowercaseLetter
// 'e': LowercaseLetter
// 'd': LowercaseLetter
// ' ': SpaceSeparator
// 'r': LowercaseLetter
// 'o': LowercaseLetter
// 'a': LowercaseLetter
// 'd': LowercaseLetter
// '.': OtherPunctuation
open System
// Define a string with a variety of character categories.
let s = "The red car drove down the long, narrow, secluded road."
// Determine the category of each character.
for ch in s do
printfn $"'{ch}': {Char.GetUnicodeCategory ch}"
// The example displays the following output:
// 'T': UppercaseLetter
// 'h': LowercaseLetter
// 'e': LowercaseLetter
// ' ': SpaceSeparator
// 'r': LowercaseLetter
// 'e': LowercaseLetter
// 'd': LowercaseLetter
// ' ': SpaceSeparator
// 'c': LowercaseLetter
// 'a': LowercaseLetter
// 'r': LowercaseLetter
// ' ': SpaceSeparator
// 'd': LowercaseLetter
// 'r': LowercaseLetter
// 'o': LowercaseLetter
// 'v': LowercaseLetter
// 'e': LowercaseLetter
// ' ': SpaceSeparator
// 'd': LowercaseLetter
// 'o': LowercaseLetter
// 'w': LowercaseLetter
// 'n': LowercaseLetter
// ' ': SpaceSeparator
// 't': LowercaseLetter
// 'h': LowercaseLetter
// 'e': LowercaseLetter
// ' ': SpaceSeparator
// 'l': LowercaseLetter
// 'o': LowercaseLetter
// 'n': LowercaseLetter
// 'g': LowercaseLetter
// ',': OtherPunctuation
// ' ': SpaceSeparator
// 'n': LowercaseLetter
// 'a': LowercaseLetter
// 'r': LowercaseLetter
// 'r': LowercaseLetter
// 'o': LowercaseLetter
// 'w': LowercaseLetter
// ',': OtherPunctuation
// ' ': SpaceSeparator
// 's': LowercaseLetter
// 'e': LowercaseLetter
// 'c': LowercaseLetter
// 'l': LowercaseLetter
// 'u': LowercaseLetter
// 'd': LowercaseLetter
// 'e': LowercaseLetter
// 'd': LowercaseLetter
// ' ': SpaceSeparator
// 'r': LowercaseLetter
// 'o': LowercaseLetter
// 'a': LowercaseLetter
// 'd': LowercaseLetter
// '.': OtherPunctuation
Imports System.Globalization
Module Example1
Public Sub Main()
' Define a string with a variety of character categories.
Dim s As String = "The car drove down the narrow, secluded road."
' Determine the category of each character.
For Each ch In s
Console.WriteLine("'{0}': {1}", ch, Char.GetUnicodeCategory(ch))
Next
End Sub
End Module
' The example displays the following output:
' 'T': UppercaseLetter
' 'h': LowercaseLetter
' 'e': LowercaseLetter
' ' ': SpaceSeparator
' 'r': LowercaseLetter
' 'e': LowercaseLetter
' 'd': LowercaseLetter
' ' ': SpaceSeparator
' 'c': LowercaseLetter
' 'a': LowercaseLetter
' 'r': LowercaseLetter
' ' ': SpaceSeparator
' 'd': LowercaseLetter
' 'r': LowercaseLetter
' 'o': LowercaseLetter
' 'v': LowercaseLetter
' 'e': LowercaseLetter
' ' ': SpaceSeparator
' 'd': LowercaseLetter
' 'o': LowercaseLetter
' 'w': LowercaseLetter
' 'n': LowercaseLetter
' ' ': SpaceSeparator
' 't': LowercaseLetter
' 'h': LowercaseLetter
' 'e': LowercaseLetter
' ' ': SpaceSeparator
' 'l': LowercaseLetter
' 'o': LowercaseLetter
' 'n': LowercaseLetter
' 'g': LowercaseLetter
' ',': OtherPunctuation
' ' ': SpaceSeparator
' 'n': LowercaseLetter
' 'a': LowercaseLetter
' 'r': LowercaseLetter
' 'r': LowercaseLetter
' 'o': LowercaseLetter
' 'w': LowercaseLetter
' ',': OtherPunctuation
' ' ': SpaceSeparator
' 's': LowercaseLetter
' 'e': LowercaseLetter
' 'c': LowercaseLetter
' 'l': LowercaseLetter
' 'u': LowercaseLetter
' 'd': LowercaseLetter
' 'e': LowercaseLetter
' 'd': LowercaseLetter
' ' ': SpaceSeparator
' 'r': LowercaseLetter
' 'o': LowercaseLetter
' 'a': LowercaseLetter
' 'd': LowercaseLetter
' '.': OtherPunctuation
En interne, pour les caractères en dehors de la plage ASCII (U+0000 à U+00FF), la GetUnicodeCategory méthode dépend des catégories Unicode signalées par la CharUnicodeInfo classe. Les caractères Unicode sont classés en fonction du standard Unicode version 8.0.0.
Caractères et éléments de texte
Étant donné qu’un seul caractère peut être représenté par plusieurs Char objets, il n’est pas toujours significatif d’utiliser des objets individuels Char . Par exemple, l’exemple suivant convertit les points de code Unicode qui représentent les nombres égégéens zéro à 9 en unités de code codées UTF-16. Étant donné qu'il assimile à tort des objets à des caractères Char, il indique de manière incorrecte que la chaîne résultante contient 20 caractères.
using System;
public class Example5
{
public static void Main()
{
string result = String.Empty;
for (int ctr = 0x10107; ctr <= 0x10110; ctr++) // Range of Aegean numbers.
result += Char.ConvertFromUtf32(ctr);
Console.WriteLine($"The string contains {result.Length} characters.");
}
}
// The example displays the following output:
// The string contains 20 characters.
open System
let result =
[ for i in 0x10107..0x10110 do // Range of Aegean numbers.
Char.ConvertFromUtf32 i ]
|> String.concat ""
printfn $"The string contains {result.Length} characters."
// The example displays the following output:
// The string contains 20 characters.
Module Example5
Public Sub Main()
Dim result As String = String.Empty
For ctr As Integer = &H10107 To &H10110 ' Range of Aegean numbers.
result += Char.ConvertFromUtf32(ctr)
Next
Console.WriteLine("The string contains {0} characters.", result.Length)
End Sub
End Module
' The example displays the following output:
' The string contains 20 characters.
Vous pouvez effectuer les opérations suivantes pour éviter l’hypothèse qu’un Char objet représente un caractère unique :
Vous pouvez utiliser un String objet dans son intégralité au lieu de travailler avec ses caractères individuels pour représenter et analyser du contenu linguistique.
Vous pouvez utiliser String.EnumerateRunes comme indiqué dans l’exemple suivant :
int CountLetters(string s) { int letterCount = 0; foreach (Rune rune in s.EnumerateRunes()) { if (Rune.IsLetter(rune)) { letterCount++; } } return letterCount; }let countLetters (s: string) = let mutable letterCount = 0 for rune in s.EnumerateRunes() do if Rune.IsLetter rune then letterCount <- letterCount + 1 letterCountVous pouvez utiliser la StringInfo classe pour utiliser des éléments de texte au lieu d’objets individuels Char . L’exemple suivant utilise l’objet StringInfo pour compter le nombre d’éléments de texte dans une chaîne composée des nombres égégéens zéro à neuf. Étant donné qu’elle considère une paire de substitution un caractère unique, elle signale correctement que la chaîne contient dix caractères.
using System; using System.Globalization; public class Example4 { public static void Main() { string result = String.Empty; for (int ctr = 0x10107; ctr <= 0x10110; ctr++) // Range of Aegean numbers. result += Char.ConvertFromUtf32(ctr); StringInfo si = new StringInfo(result); Console.WriteLine($"The string contains {si.LengthInTextElements} characters."); } } // The example displays the following output: // The string contains 10 characters.open System open System.Globalization let result = [ for i in 0x10107..0x10110 do // Range of Aegean numbers. Char.ConvertFromUtf32 i ] |> String.concat "" let si = StringInfo result printfn $"The string contains {si.LengthInTextElements} characters." // The example displays the following output: // The string contains 10 characters.Imports System.Globalization Module Example6 Public Sub Main() Dim result As String = String.Empty For ctr As Integer = &H10107 To &H10110 ' Range of Aegean numbers. result += Char.ConvertFromUtf32(ctr) Next Dim si As New StringInfo(result) Console.WriteLine("The string contains {0} characters.", si.LengthInTextElements) End Sub End Module ' The example displays the following output: ' The string contains 10 characters.Si une chaîne contient un caractère de base qui a un ou plusieurs caractères combinés, vous pouvez appeler la String.Normalize méthode pour convertir la sous-chaîne en une seule unité de code encodée UTF-16. L’exemple suivant appelle la méthode String.Normalize pour convertir le caractère de base U+0061 (LETTRE MINUSCULE LATINE A) et le caractère de combinaison U+0308 (COMBINAISON DE DIAÉRÈSE) en U+00E4 (LETTRE MINUSCULE LATINE A AVEC DIAÉRÈSE).
using System; public class Example2 { public static void Main() { string combining = "\u0061\u0308"; ShowString(combining); string normalized = combining.Normalize(); ShowString(normalized); } private static void ShowString(string s) { Console.Write($"Length of string: {s.Length} ("); for (int ctr = 0; ctr < s.Length; ctr++) { Console.Write($"U+{Convert.ToUInt16(s[ctr]):X4}"); if (ctr != s.Length - 1) Console.Write(" "); } Console.WriteLine(")\n"); } } // The example displays the following output: // Length of string: 2 (U+0061 U+0308) // // Length of string: 1 (U+00E4)open System let showString (s: string) = printf $"Length of string: {s.Length} (" for i = 0 to s.Length - 1 do printf $"U+{Convert.ToUInt16 s[i]:X4}" if i <> s.Length - 1 then printf " " printfn ")\n" let combining = "\u0061\u0308" showString combining let normalized = combining.Normalize() showString normalized // The example displays the following output: // Length of string: 2 (U+0061 U+0308) // // Length of string: 1 (U+00E4)Module Example3 Public Sub Main() Dim combining As String = ChrW(&H61) + ChrW(&H308) ShowString(combining) Dim normalized As String = combining.Normalize() ShowString(normalized) End Sub Private Sub ShowString(s As String) Console.Write("Length of string: {0} (", s.Length) For ctr As Integer = 0 To s.Length - 1 Console.Write("U+{0:X4}", Convert.ToUInt16(s(ctr))) If ctr <> s.Length - 1 Then Console.Write(" ") Next Console.WriteLine(")") Console.WriteLine() End Sub End Module ' The example displays the following output: ' Length of string: 2 (U+0061 U+0308) ' ' Length of string: 1 (U+00E4)
Opérations courantes
La Char structure fournit des méthodes pour comparer Char des objets, convertir la valeur de l’objet actuel Char en objet d’un autre type et déterminer la catégorie Unicode d’un Char objet :
| Pour | Utiliser ces System.Char méthodes |
|---|---|
| Comparer des Char objets | CompareTo et Equals |
| Convertir un point de code en chaîne | ConvertFromUtf32 Consultez également le Rune type. |
| Convertir un objet Char ou une paire substituée d’objets Char en point de code | Pour un caractère unique : Convert.ToInt32(Char) Pour une paire de substitution ou un caractère dans une chaîne : Char.ConvertToUtf32 Consultez également le Rune type. |
| Obtenir la catégorie Unicode d’un caractère | GetUnicodeCategory Voir aussi Rune.GetUnicodeCategory. |
| Déterminer si un caractère se trouve dans une catégorie Unicode particulière, comme le chiffre, la lettre, la ponctuation, le caractère de contrôle, etc. |
IsControl, IsDigit, IsHighSurrogate, IsLetter, IsLetterOrDigit, IsLower, IsLowSurrogate, IsNumber, IsPunctuation, IsSeparator, IsSurrogate, IsSurrogatePair, IsSymbol, IsUpper, et IsWhiteSpace Consultez également les méthodes correspondantes sur le Rune type. |
| Convertir un Char objet qui représente un nombre en type valeur numérique | GetNumericValue Voir aussi Rune.GetNumericValue. |
| Convertir un caractère dans une chaîne en objet Char | Parse et TryParse |
| Convertir un Char objet en objet String | ToString |
| Modifier la casse d’un objet Char |
ToLower, ToLowerInvariant, ToUpper et ToUpperInvariant Consultez également les méthodes correspondantes sur le Rune type. |
Valeurs de caractères et interopérabilité
Lorsqu’un type managé Char, représenté sous la forme d’une unité de code codée en Unicode UTF-16, est passé au code non managé, le marshaller d’interopérabilité convertit par défaut le jeu de caractères en ANSI. Vous pouvez appliquer l’attribut DllImportAttribute aux déclarations d’appel de plateforme et l’attribut StructLayoutAttribute à une déclaration d’interopérabilité COM pour déterminer le jeu de caractères qu'un type marshallé Char utilise.
Champs
| Nom | Description |
|---|---|
| MaxValue |
Représente la plus grande valeur possible d’un Char. Ce champ est constant. |
| MinValue |
Représente la plus petite valeur possible d’un Char. Ce champ est constant. |
Méthodes
| Nom | Description |
|---|---|
| CompareTo(Char) |
Compare cette instance à un objet spécifié Char et indique si cette instance précède, suit ou apparaît dans la même position dans l’ordre de tri que l’objet spécifié Char . |
| CompareTo(Object) |
Compare cette instance à un objet spécifié et indique si cette instance précède, suit ou apparaît dans la même position dans l’ordre de tri que celui spécifié Object. |
| ConvertFromUtf32(Int32) |
Convertit le point de code Unicode spécifié en chaîne encodée UTF-16. |
| ConvertToUtf32(Char, Char) |
Convertit la valeur d’une paire de substitution encodée UTF-16 en point de code Unicode. |
| ConvertToUtf32(String, Int32) |
Convertit la valeur d’un caractère encodé UTF-16 ou d’une paire de substitution à une position spécifiée dans une chaîne en point de code Unicode. |
| Equals(Char, StringComparison) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| Equals(Char) |
Retourne une valeur qui indique si cette instance est égale à l’objet spécifié Char . |
| Equals(Object) |
Retourne une valeur qui indique si cette instance est égale à un objet spécifié. |
| GetHashCode() |
Retourne le code de hachage pour cette instance. |
| GetNumericValue(Char) |
Convertit le caractère Unicode numérique spécifié en nombre à virgule flottante double précision. |
| GetNumericValue(String, Int32) |
Convertit le caractère Unicode numérique à la position spécifiée dans une chaîne spécifiée en nombre à virgule flottante double précision. |
| GetTypeCode() | |
| GetUnicodeCategory(Char) |
Classe un caractère Unicode spécifié dans un groupe identifié par l’une des UnicodeCategory valeurs. |
| GetUnicodeCategory(String, Int32) |
Classe le caractère à la position spécifiée dans une chaîne spécifiée dans un groupe identifié par l’une des UnicodeCategory valeurs. |
| IsAscii(Char) |
Retourne |
| IsAsciiDigit(Char) |
Indique si un caractère est classé comme un chiffre ASCII. |
| IsAsciiHexDigit(Char) |
Indique si un caractère est classé comme un chiffre hexadécimal ASCII. |
| IsAsciiHexDigitLower(Char) |
Indique si un caractère est classé en tant que chiffre hexadécimal en minuscule ASCII. |
| IsAsciiHexDigitUpper(Char) |
Indique si un caractère est classé en tant que chiffre hexadécimal en majuscule ASCII. |
| IsAsciiLetter(Char) |
Indique si un caractère est classé comme une lettre ASCII. |
| IsAsciiLetterLower(Char) |
Indique si un caractère est classé comme une lettre ASCII minuscule. |
| IsAsciiLetterOrDigit(Char) |
Indique si un caractère est classé comme une lettre OU un chiffre ASCII. |
| IsAsciiLetterUpper(Char) |
Indique si un caractère est classé comme une lettre ASCII majuscule. |
| IsBetween(Char, Char, Char) |
Indique si un caractère se trouve dans la plage inclusive spécifiée. |
| IsControl(Char) |
Indique si le caractère Unicode spécifié est classé comme caractère de contrôle. |
| IsControl(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme caractère de contrôle. |
| IsDigit(Char) |
Indique si le caractère Unicode spécifié est classé comme un chiffre décimal. |
| IsDigit(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme un chiffre décimal. |
| IsHighSurrogate(Char) |
Indique si l’objet spécifié Char est un substitut élevé. |
| IsHighSurrogate(String, Int32) |
Indique si l’objet Char à la position spécifiée dans une chaîne est un substitut élevé. |
| IsLetter(Char) |
Indique si le caractère Unicode spécifié est classé comme une lettre Unicode. |
| IsLetter(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme une lettre Unicode. |
| IsLetterOrDigit(Char) |
Indique si le caractère Unicode spécifié est classé comme une lettre ou un chiffre décimal. |
| IsLetterOrDigit(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme une lettre ou un chiffre décimal. |
| IsLower(Char) |
Indique si le caractère Unicode spécifié est classé comme une lettre minuscule. |
| IsLower(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme une lettre minuscule. |
| IsLowSurrogate(Char) |
Indique si l’objet spécifié Char est un substitut faible. |
| IsLowSurrogate(String, Int32) |
Indique si l’objet Char à la position spécifiée dans une chaîne est un substitut faible. |
| IsNumber(Char) |
Indique si le caractère Unicode spécifié est classé comme un nombre. |
| IsNumber(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme un nombre. |
| IsPunctuation(Char) |
Indique si le caractère Unicode spécifié est classé comme marque de ponctuation. |
| IsPunctuation(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme marque de ponctuation. |
| IsSeparator(Char) |
Indique si le caractère Unicode spécifié est classé comme caractère séparateur. |
| IsSeparator(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme caractère de séparateur. |
| IsSurrogate(Char) |
Indique si le caractère spécifié a une unité de code de substitution. |
| IsSurrogate(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée a une unité de code de substitution. |
| IsSurrogatePair(Char, Char) |
Indique si les deux objets spécifiés Char forment une paire de substitution. |
| IsSurrogatePair(String, Int32) |
Indique si deux objets adjacents Char à une position spécifiée dans une chaîne forment une paire de substitution. |
| IsSymbol(Char) |
Indique si le caractère Unicode spécifié est classé comme caractère de symbole. |
| IsSymbol(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme caractère de symbole. |
| IsUpper(Char) |
Indique si le caractère Unicode spécifié est classé comme une lettre majuscule. |
| IsUpper(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme une lettre majuscule. |
| IsWhiteSpace(Char) |
Indique si le caractère Unicode spécifié est classé comme espace blanc. |
| IsWhiteSpace(String, Int32) |
Indique si le caractère à la position spécifiée dans une chaîne spécifiée est classé comme espace blanc. |
| Parse(String) |
Convertit la valeur de la chaîne spécifiée en son caractère Unicode équivalent. |
| ToLower(Char, CultureInfo) |
Convertit la valeur d’un caractère Unicode spécifié en son équivalent en minuscules à l’aide d’informations de mise en forme spécifiques à la culture spécifiées. |
| ToLower(Char) |
Convertit la valeur d’un caractère Unicode en équivalent minuscule. |
| ToLowerInvariant(Char) |
Convertit la valeur d’un caractère Unicode en son équivalent en minuscules à l’aide des règles de casse de la culture invariante. |
| ToString() |
Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente. |
| ToString(Char) |
Convertit le caractère Unicode spécifié en sa représentation sous forme de chaîne équivalente. |
| ToString(IFormatProvider) |
Convertit la valeur de cette instance en sa représentation sous forme de chaîne équivalente à l’aide des informations de format spécifiques à la culture spécifiées. |
| ToUpper(Char, CultureInfo) |
Convertit la valeur d’un caractère Unicode spécifié en son équivalent en majuscules à l’aide d’informations de mise en forme spécifiques à la culture spécifiées. |
| ToUpper(Char) |
Convertit la valeur d’un caractère Unicode en son équivalent en majuscules. |
| ToUpperInvariant(Char) |
Convertit la valeur d’un caractère Unicode en son équivalent en majuscules à l’aide des règles de casse de la culture invariante. |
| TryParse(String, Char) |
Convertit la valeur de la chaîne spécifiée en son caractère Unicode équivalent. Un code de retour indique si la conversion a réussi ou échoué. |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IAdditionOperators<Char,Char,Char>.Addition(Char, Char) |
Ajoute deux valeurs ensemble pour calculer leur somme. |
| IAdditionOperators<Char,Char,Char>.CheckedAddition(Char, Char) |
Ajoute deux valeurs ensemble pour calculer leur somme. |
| IAdditiveIdentity<Char,Char>.AdditiveIdentity |
Obtient l’identité additive du type actuel. |
| IBinaryInteger<Char>.GetByteCount() |
Obtient le nombre d’octets qui seront écrits dans le cadre de TryWriteLittleEndian(Span<Byte>, Int32). |
| IBinaryInteger<Char>.GetShortestBitLength() |
Obtient la longueur, en bits, de la représentation complète des deux plus courtes de la valeur actuelle. |
| IBinaryInteger<Char>.LeadingZeroCount(Char) |
Calcule le nombre de zéros premiers bits dans une valeur. |
| IBinaryInteger<Char>.Log10(Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| IBinaryInteger<Char>.PopCount(Char) |
Calcule le nombre de bits définis dans une valeur. |
| IBinaryInteger<Char>.RotateLeft(Char, Int32) |
Fait pivoter une valeur à gauche d’une quantité donnée. |
| IBinaryInteger<Char>.RotateRight(Char, Int32) |
Fait pivoter une valeur à droite d’un montant donné. |
| IBinaryInteger<Char>.TrailingZeroCount(Char) |
Calcule le nombre de bits de fin zéro dans une valeur. |
| IBinaryInteger<Char>.TryReadBigEndian(ReadOnlySpan<Byte>, Boolean, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| IBinaryInteger<Char>.TryReadLittleEndian(ReadOnlySpan<Byte>, Boolean, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| IBinaryInteger<Char>.TryWriteBigEndian(Span<Byte>, Int32) |
Tente d’écrire la valeur actuelle, au format big-endian, dans une étendue donnée. |
| IBinaryInteger<Char>.TryWriteLittleEndian(Span<Byte>, Int32) |
Tente d’écrire la valeur actuelle, au format little-endian, dans une étendue donnée. |
| IBinaryNumber<Char>.AllBitsSet |
Obtient une instance du type binaire dans laquelle tous les bits sont définis. |
| IBinaryNumber<Char>.IsPow2(Char) |
Détermine si une valeur est une puissance de deux. |
| IBinaryNumber<Char>.Log2(Char) |
Calcule le journal2 d’une valeur. |
| IBitwiseOperators<Char,Char,Char>.BitwiseAnd(Char, Char) |
Calcule les valeurs au niveau du bit et de deux valeurs. |
| IBitwiseOperators<Char,Char,Char>.BitwiseOr(Char, Char) |
Calcule les valeurs au niveau du bit ou de deux valeurs. |
| IBitwiseOperators<Char,Char,Char>.ExclusiveOr(Char, Char) |
Calcule les valeurs exclusives ou de deux valeurs. |
| IBitwiseOperators<Char,Char,Char>.OnesComplement(Char) |
Calcule la représentation complète d’une valeur donnée. |
| IComparable.CompareTo(Object) |
Compare le instance actuel avec un autre objet du même type et retourne un entier qui indique si le instance actuel précède, suit ou se produit dans la même position dans l’ordre de tri que l’autre objet. |
| IComparisonOperators<Char,Char,Boolean>.GreaterThan(Char, Char) |
Compare deux valeurs pour déterminer ce qui est supérieur. |
| IComparisonOperators<Char,Char,Boolean>.GreaterThanOrEqual(Char, Char) |
Compare deux valeurs pour déterminer qui est supérieur ou égal. |
| IComparisonOperators<Char,Char,Boolean>.LessThan(Char, Char) |
Compare deux valeurs pour déterminer ce qui est inférieur. |
| IComparisonOperators<Char,Char,Boolean>.LessThanOrEqual(Char, Char) |
Compare deux valeurs pour déterminer qui est inférieure ou égale. |
| IConvertible.GetTypeCode() |
Retourne la TypeCode valeur de cette instance. |
| IConvertible.ToBoolean(IFormatProvider) |
Note Cette conversion n’est pas prise en charge. Essayer de le faire provoque un InvalidCastException. |
| IConvertible.ToByte(IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToByte(IFormatProvider). |
| IConvertible.ToChar(IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToChar(IFormatProvider). |
| IConvertible.ToDateTime(IFormatProvider) |
Note Cette conversion n’est pas prise en charge. Essayer de le faire provoque un InvalidCastException. |
| IConvertible.ToDecimal(IFormatProvider) |
Note Cette conversion n’est pas prise en charge. Essayer de le faire provoque un InvalidCastException. |
| IConvertible.ToDouble(IFormatProvider) |
Note Cette conversion n’est pas prise en charge. Essayer de le faire provoque un InvalidCastException. |
| IConvertible.ToInt16(IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToInt16(IFormatProvider). |
| IConvertible.ToInt32(IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToInt32(IFormatProvider). |
| IConvertible.ToInt64(IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToInt64(IFormatProvider). |
| IConvertible.ToSByte(IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToSByte(IFormatProvider). |
| IConvertible.ToSingle(IFormatProvider) |
Note Cette conversion n’est pas prise en charge. Essayer de le faire provoque un InvalidCastException. |
| IConvertible.ToString(IFormatProvider) |
Convertit la valeur de cette instance en chaîne équivalente, à l’aide des informations de mise en forme spécifiques à la culture spécifiées. |
| IConvertible.ToType(Type, IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToType(Type, IFormatProvider). |
| IConvertible.ToUInt16(IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToUInt16(IFormatProvider). |
| IConvertible.ToUInt32(IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToUInt32(IFormatProvider). |
| IConvertible.ToUInt64(IFormatProvider) |
Pour obtenir une description de ce membre, consultez ToUInt64(IFormatProvider). |
| IDecrementOperators<Char>.CheckedDecrement(Char) |
Décrémente une valeur. |
| IDecrementOperators<Char>.Decrement(Char) |
Décrémente une valeur. |
| IDivisionOperators<Char,Char,Char>.Division(Char, Char) |
Divise une valeur par une autre pour calculer leur quotient. |
| IEqualityOperators<Char,Char,Boolean>.Equality(Char, Char) |
Compare deux valeurs pour déterminer l’égalité. |
| IEqualityOperators<Char,Char,Boolean>.Inequality(Char, Char) |
Compare deux valeurs pour déterminer l’inégalité. |
| IFormattable.ToString(String, IFormatProvider) |
Met en forme la valeur de l’instance actuelle à l’aide du format spécifié. |
| IIncrementOperators<Char>.CheckedIncrement(Char) |
Incrémente une valeur. |
| IIncrementOperators<Char>.Increment(Char) |
Incrémente une valeur. |
| IMinMaxValue<Char>.MaxValue |
Obtient la valeur maximale du type actuel. |
| IMinMaxValue<Char>.MinValue |
Obtient la valeur minimale du type actuel. |
| IModulusOperators<Char,Char,Char>.Modulus(Char, Char) |
Divise deux valeurs ensemble pour calculer leur module ou leur reste. |
| IMultiplicativeIdentity<Char,Char>.MultiplicativeIdentity |
Obtient l’identité multiplicative du type actuel. |
| IMultiplyOperators<Char,Char,Char>.CheckedMultiply(Char, Char) |
Multiplie deux valeurs ensemble pour calculer leur produit. |
| IMultiplyOperators<Char,Char,Char>.Multiply(Char, Char) |
Multiplie deux valeurs ensemble pour calculer leur produit. |
| INumberBase<Char>.Abs(Char) |
Calcule l’absolu d’une valeur. |
| INumberBase<Char>.IsCanonical(Char) |
Détermine si une valeur se trouve dans sa représentation canonique. |
| INumberBase<Char>.IsComplexNumber(Char) |
Détermine si une valeur représente un nombre complexe. |
| INumberBase<Char>.IsEvenInteger(Char) |
Détermine si une valeur représente un nombre intégral pair. |
| INumberBase<Char>.IsFinite(Char) |
Détermine si une valeur est finie. |
| INumberBase<Char>.IsImaginaryNumber(Char) |
Détermine si une valeur représente un nombre imaginaire pur. |
| INumberBase<Char>.IsInfinity(Char) |
Détermine si une valeur est infinie. |
| INumberBase<Char>.IsInteger(Char) |
Détermine si une valeur représente un nombre intégral. |
| INumberBase<Char>.IsNaN(Char) |
Détermine si une valeur est NaN. |
| INumberBase<Char>.IsNegative(Char) |
Détermine si une valeur est négative. |
| INumberBase<Char>.IsNegativeInfinity(Char) |
Détermine si une valeur est l’infini négatif. |
| INumberBase<Char>.IsNormal(Char) |
Détermine si une valeur est normale. |
| INumberBase<Char>.IsOddInteger(Char) |
Détermine si une valeur représente un nombre intégral impair. |
| INumberBase<Char>.IsPositive(Char) |
Détermine si une valeur est positive. |
| INumberBase<Char>.IsPositiveInfinity(Char) |
Détermine si une valeur est l’infini positif. |
| INumberBase<Char>.IsRealNumber(Char) |
Détermine si une valeur représente un nombre réel. |
| INumberBase<Char>.IsSubnormal(Char) |
Détermine si une valeur est subnormale. |
| INumberBase<Char>.IsZero(Char) |
Détermine si une valeur est égale à zéro. |
| INumberBase<Char>.MaxMagnitude(Char, Char) |
Compare deux valeurs au calcul, ce qui est supérieur. |
| INumberBase<Char>.MaxMagnitudeNumber(Char, Char) |
Compare deux valeurs au calcul qui a la plus grande magnitude et retourne l’autre valeur si une entrée est |
| INumberBase<Char>.MinMagnitude(Char, Char) |
Compare deux valeurs au calcul, ce qui est inférieur. |
| INumberBase<Char>.MinMagnitudeNumber(Char, Char) |
Compare deux valeurs au calcul dont la magnitude est inférieure et retourne l’autre valeur si une entrée est |
| INumberBase<Char>.MultiplyAddEstimate(Char, Char, Char) |
Calcule une estimation de ( |
| INumberBase<Char>.One |
Obtient la valeur |
| INumberBase<Char>.Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) |
Analyse une étendue de caractères en une valeur. |
| INumberBase<Char>.Parse(String, NumberStyles, IFormatProvider) |
Analyse une chaîne en une valeur. |
| INumberBase<Char>.Radix |
Obtient le radix, ou la base, pour le type. |
| INumberBase<Char>.TryConvertFromChecked<TOther>(TOther, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| INumberBase<Char>.TryConvertFromSaturating<TOther>(TOther, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| INumberBase<Char>.TryConvertFromTruncating<TOther>(TOther, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| INumberBase<Char>.TryConvertToChecked<TOther>(Char, TOther) |
Tente de convertir une instance du type actuel en un autre type, lève une exception de dépassement de capacité pour toutes les valeurs qui se trouvent en dehors de la plage représentée du type actuel. |
| INumberBase<Char>.TryConvertToSaturating<TOther>(Char, TOther) |
Tente de convertir une instance du type actuel en un autre type, en saturant toutes les valeurs qui se trouvent en dehors de la plage représentée du type actuel. |
| INumberBase<Char>.TryConvertToTruncating<TOther>(Char, TOther) |
Tente de convertir une instance du type actuel en un autre type, en tronqué toutes les valeurs qui se trouvent en dehors de la plage représentée du type actuel. |
| INumberBase<Char>.TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| INumberBase<Char>.TryParse(String, NumberStyles, IFormatProvider, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| INumberBase<Char>.Zero |
Obtient la valeur |
| IParsable<Char>.Parse(String, IFormatProvider) |
Analyse une chaîne en une valeur. |
| IParsable<Char>.TryParse(String, IFormatProvider, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| IShiftOperators<Char,Int32,Char>.LeftShift(Char, Int32) |
Déplace une valeur vers la gauche d’un montant donné. |
| IShiftOperators<Char,Int32,Char>.RightShift(Char, Int32) |
Déplace une valeur à droite d’un montant donné. |
| IShiftOperators<Char,Int32,Char>.UnsignedRightShift(Char, Int32) |
Déplace une valeur à droite d’un montant donné. |
| ISpanFormattable.TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
Tente de mettre en forme la valeur de l’instance actuelle dans l’étendue fournie de caractères. |
| ISpanParsable<Char>.Parse(ReadOnlySpan<Char>, IFormatProvider) |
Analyse une étendue de caractères en une valeur. |
| ISpanParsable<Char>.TryParse(ReadOnlySpan<Char>, IFormatProvider, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| ISubtractionOperators<Char,Char,Char>.CheckedSubtraction(Char, Char) |
Soustrait deux valeurs pour calculer leur différence. |
| ISubtractionOperators<Char,Char,Char>.Subtraction(Char, Char) |
Soustrait deux valeurs pour calculer leur différence. |
| IUnaryNegationOperators<Char,Char>.CheckedUnaryNegation(Char) |
Calcule la négation unaire vérifiée d’une valeur. |
| IUnaryNegationOperators<Char,Char>.UnaryNegation(Char) |
Calcule la négation unaire d’une valeur. |
| IUnaryPlusOperators<Char,Char>.UnaryPlus(Char) |
Calcule le plus unaire d’une valeur. |
| IUtf8SpanFormattable.TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider) |
Tente de mettre en forme la valeur de l’instance actuelle en UTF-8 dans l’étendue fournie d’octets. |
| IUtf8SpanParsable<Char>.Parse(ReadOnlySpan<Byte>, IFormatProvider) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
| IUtf8SpanParsable<Char>.TryParse(ReadOnlySpan<Byte>, IFormatProvider, Char) |
Représente un caractère sous la forme d’une unité de code UTF-16. |
S’applique à
Cohérence de thread
Tous les membres de ce type sont thread safe. Les membres qui semblent modifier l’état de l’instance retournent réellement une nouvelle instance initialisée avec la nouvelle valeur. Comme pour tout autre type, la lecture et l’écriture dans une variable partagée qui contient une instance de ce type doit être protégée par un verrou pour garantir la sécurité des threads.