Byte.ToString Méthode

Définition

Espace de noms:: System

Assemblys:: mscorlib.dll, System.Runtime.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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.

Convertit la valeur de l’objet actuel Byte en sa représentation sous forme de chaîne équivalente.

Surcharges

Nom	Description
ToString()	Convertit la valeur de l’objet actuel Byte en sa représentation sous forme de chaîne équivalente.
ToString(IFormatProvider)	Convertit la valeur numérique de l’objet actuel Byte en sa représentation sous forme de chaîne équivalente à l’aide des informations de mise en forme spécifiques à la culture spécifiées.
ToString(String)	Convertit la valeur de l’objet actuel Byte en sa représentation sous forme de chaîne équivalente à l’aide du format spécifié.
ToString(String, IFormatProvider)	Convertit la valeur de l’objet actuel Byte en sa représentation sous forme de chaîne équivalente à l’aide des informations de mise en forme spécifiques à la culture et au format spécifiés.

ToString()

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Convertit la valeur de l’objet actuel Byte en sa représentation sous forme de chaîne équivalente.

public:
 override System::String ^ ToString();

public override string ToString();

override this.ToString : unit -> string

Public Overrides Function ToString () As String

Retours

String

Représentation sous forme de chaîne de la valeur de cet objet, qui se compose d’une séquence de chiffres comprise entre 0 et 9 sans zéros non significatifs.

Exemples

L’exemple suivant affiche un tableau de valeurs d’octets. Notez que la ToString() méthode n’est pas appelée explicitement dans l’exemple. Au lieu de cela, elle est appelée implicitement, en raison de l’utilisation de la fonctionnalité de mise en forme composite , l’exemple F# utilise l’interpolation de chaîne.

byte[] bytes = {0, 1, 14, 168, 255};
foreach (byte byteValue in bytes)
   Console.WriteLine(byteValue);
// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255

let bytes = [| 0; 1; 14; 168; 255 |]
for byteValue in bytes do
    printfn $"{byteValue}"

// The example displays the following output to the console if the current
// culture is en-US:
//       0
//       1
//       14
//       168
//       255

Dim bytes() As Byte = {0, 1, 14, 168, 255}
For Each byteValue As Byte In Bytes
   Console.WriteLine(byteValue)
Next   
' The example displays the following output to the console if the current
' culture is en-US:
'       0
'       1
'       14
'       168
'       255

Remarques

La valeur de retour est mise en forme avec le spécificateur de format numérique général (« G ») et l’objet NumberFormatInfo de la culture actuelle du thread. Pour définir la mise en forme de la représentation sous forme de chaîne de la Byte valeur, appelez la ToString méthode. Pour définir les spécificateurs de format et la culture utilisés pour créer la représentation sous forme de chaîne d’une Byte valeur, appelez la ToString méthode.

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et chaînes de format numérique personnalisées.
Pour plus d’informations sur la mise en forme, consultez Types de mise en forme.

Pour plus d’informations sur la culture actuelle du thread, consultez Thread.CurrentCulture.

S’applique à

ToString(IFormatProvider)

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Convertit la valeur numérique de l’objet actuel Byte en sa représentation sous forme de chaîne équivalente à l’aide des informations de mise en forme spécifiques à la culture spécifiées.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);

public:
 System::String ^ ToString(IFormatProvider ^ provider);

public string ToString(IFormatProvider provider);

public string ToString(IFormatProvider? provider);

override this.ToString : IFormatProvider -> string

Public Function ToString (provider As IFormatProvider) As String

Paramètres

provider: IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

String

Représentation sous forme de chaîne de la valeur de cet objet au format spécifié par le provider paramètre.

Implémente

ToString(IFormatProvider)

Exemples

L’exemple suivant itère un tableau de valeurs d’octets et les affiche dans la console en appelant la ToString(IFormatProvider) méthode avec différents fournisseurs de format.

byte[] bytes = {0, 1, 14, 168, 255};
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("de-de"),
                           new CultureInfo("es-es")};
foreach (byte byteValue in bytes)
{
   foreach (CultureInfo provider in providers)
      Console.Write("{0,3} ({1})      ",
                    byteValue.ToString(provider), provider.Name);

   Console.WriteLine();
}
// The example displays the following output to the console:
//      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
//      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
//     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
//    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
//    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

let bytes = [| 0; 1; 14; 168; 255 |]
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "de-de"
      CultureInfo "es-es" ]

for byteValue in bytes do
    for provider in providers do
        printf $"{byteValue.ToString provider,3} ({provider.Name})      " 

    printfn ""

// The example displays the following output to the console:
//      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
//      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
//     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
//    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
//    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

Dim bytes() As Byte = {0, 1, 14, 168, 255}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each byteValue As Byte In bytes
   For Each provider As CultureInfo In providers
      Console.Write("{0,3} ({1})      ", byteValue.ToString(provider), provider.Name)
   Next
   Console.WriteLine()                                        
Next
' The example displays the following output to the console:
'      0 (en-US)        0 (fr-FR)        0 (de-DE)        0 (es-ES)
'      1 (en-US)        1 (fr-FR)        1 (de-DE)        1 (es-ES)
'     14 (en-US)       14 (fr-FR)       14 (de-DE)       14 (es-ES)
'    168 (en-US)      168 (fr-FR)      168 (de-DE)      168 (es-ES)
'    255 (en-US)      255 (fr-FR)      255 (de-DE)      255 (es-ES)

Remarques

La valeur de retour est mise en forme avec le spécificateur de format numérique général (« G »).

Le provider paramètre est un objet qui implémente l’interface IFormatProvider . Sa GetFormat méthode retourne un NumberFormatInfo objet qui fournit des informations spécifiques à la culture sur le format de la chaîne retournée par cette méthode. L’objet qui implémente IFormatProvider peut être l’un des éléments suivants :

Objet CultureInfo qui représente la culture dont les règles de mise en forme doivent être utilisées.
Objet NumberFormatInfo qui contient des informations de mise en forme numériques spécifiques pour cette valeur.
Objet personnalisé qui implémente IFormatProvider.

Si provider un null objet n’est NumberFormatInfo pas obtenu, la valeur de retour est mise en forme à l’aide de providerl’objet NumberFormatInfo pour la culture actuelle du thread. Pour plus d’informations sur la culture actuelle du thread, consultez Thread.CurrentCulture.

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et chaînes de format numérique personnalisées.
Pour plus d’informations sur la mise en forme, consultez Types de mise en forme.

Voir aussi

S’applique à

ToString(String)

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Convertit la valeur de l’objet actuel Byte en sa représentation sous forme de chaîne équivalente à l’aide du format spécifié.

public:
 System::String ^ ToString(System::String ^ format);

public string ToString(string format);

public string ToString(string? format);

override this.ToString : string -> string

Public Function ToString (format As String) As String

Paramètres

format: String

Chaîne de format numérique.

Retours

String

Représentation sous forme de chaîne de l’objet actif Byte , mise en forme comme spécifié par le format paramètre.

Exceptions

FormatException

format inclut un spécificateur non pris en charge. Les spécificateurs de format pris en charge sont répertoriés dans la section Notes.

Exemples

L’exemple suivant initialise une Byte valeur et l’affiche à la console à l’aide de chacune des chaînes de format standard prises en charge et d’une chaîne de format personnalisée. L’exemple est exécuté avec en-US comme culture actuelle.

string[] formats = {"C3", "D4", "e1", "E2", "F1", "G", "N1",
                    "P0", "X4", "0000.0000"};
byte number = 240;
foreach (string format in formats)
   Console.WriteLine("'{0}' format specifier: {1}",
                     format, number.ToString(format));

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000

let formats = 
    [ "C3"; "D4"; "e1"; "E2"; "F1"; "G"; "N1"
      "P0"; "X4"; "0000.0000" ]
let number = 240uy
for format in formats do
    printfn $"'{format}' format specifier: {number.ToString format}"

// The example displays the following output to the console if the
// current culture is en-us:
//       'C3' format specifier: $240.000
//       'D4' format specifier: 0240
//       'e1' format specifier: 2.4e+002
//       'E2' format specifier: 2.40E+002
//       'F1' format specifier: 240.0
//       'G' format specifier: 240
//       'N1' format specifier: 240.0
//       'P0' format specifier: 24,000 %
//       'X4' format specifier: 00F0
//       '0000.0000' format specifier: 0240.0000

Dim formats() As String = {"C3", "D4", "e1", "E2", "F1", "G", _
                           "N1", "P0", "X4", "0000.0000"}
Dim number As Byte = 240
For Each format As String In formats
   Console.WriteLine("'{0}' format specifier: {1}", _
                     format, number.ToString(format))
Next  
' The example displays the following output to the console if the
' current culture is en-us:
'       'C3' format specifier: $240.000
'       'D4' format specifier: 0240
'       'e1' format specifier: 2.4e+002
'       'E2' format specifier: 2.40E+002
'       'F1' format specifier: 240.0       
'       'G' format specifier: 240
'       'N1' format specifier: 240.0
'       'P0' format specifier: 24,000 %
'       'X4' format specifier: 00F0
'       '0000.0000' format specifier: 0240.0000

Remarques

Le format paramètre peut être une chaîne de format numérique standard ou personnalisée. Toutes les chaînes de format numérique standard autres que « R » (ou « r ») sont prises en charge, comme tous les caractères de format numérique personnalisés. S’il format s’agit null d’une chaîne vide (« »), la valeur de retour est mise en forme avec le spécificateur de format numérique général (« G »).

La valeur de retour de cette fonction est mise en forme à l’aide de l’objet NumberFormatInfo de la culture actuelle du thread. Pour plus d’informations sur la culture actuelle du thread, consultez Thread.CurrentCulture. Pour fournir des informations de mise en forme pour les cultures autres que la culture actuelle, appelez la Byte.ToString(String, IFormatProvider) méthode.

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et chaînes de format numérique personnalisées.
Pour plus d’informations sur la mise en forme, consultez Types de mise en forme.

Voir aussi

How to : Pad a Number with Leading Zeros

S’applique à

ToString(String, IFormatProvider)

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Convertit la valeur de l’objet actuel Byte en sa représentation sous forme de chaîne équivalente à l’aide des informations de mise en forme spécifiques à la culture et au format spécifiés.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);

public string ToString(string format, IFormatProvider provider);

public string ToString(string? format, IFormatProvider? provider);

override this.ToString : string * IFormatProvider -> string

Public Function ToString (format As String, provider As IFormatProvider) As String

Paramètres

format: String

Chaîne de format numérique standard ou personnalisée.

provider: IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.

Retours

String

Représentation sous forme de chaîne de l’objet actuelByte, mise en forme comme spécifié par les paramètres et format les provider paramètres.

Implémente

ToString(String, IFormatProvider)

Exceptions

FormatException

format inclut un spécificateur non pris en charge. Les spécificateurs de format pris en charge sont répertoriés dans la section Notes.

Exemples

L’exemple suivant utilise la chaîne de format « N » standard et quatre objets différents CultureInfo pour afficher la représentation sous forme de chaîne d’une valeur d’octet dans la console.

byte byteValue = 250;
CultureInfo[] providers = {new CultureInfo("en-us"),
                           new CultureInfo("fr-fr"),
                           new CultureInfo("es-es"),
                           new CultureInfo("de-de")};

foreach (CultureInfo provider in providers)
   Console.WriteLine("{0} ({1})",
                     byteValue.ToString("N2", provider), provider.Name);
// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)

let byteValue = 250uy
let providers = 
    [ CultureInfo "en-us"
      CultureInfo "fr-fr"
      CultureInfo "es-es"
      CultureInfo "de-de" ]

for provider in providers do
    printfn $"""{byteValue.ToString("N2", provider)} ({provider.Name})"""

// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)

Dim byteValue As Byte = 250
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("es-es"), _
                                  New CultureInfo("de-de")} 
For Each provider As CultureInfo In providers 
   Console.WriteLine("{0} ({1})", _
                     byteValue.ToString("N2", provider), provider.Name)
Next   
' The example displays the following output to the console:
'       250.00 (en-US)
'       250,00 (fr-FR)
'       250,00 (es-ES)
'       250,00 (de-DE)

Remarques

La ToString(String, IFormatProvider) méthode met en forme une Byte valeur dans un format spécifié d’une culture spécifiée. Pour mettre en forme un nombre à l’aide du format par défaut (« G ») de la culture actuelle, appelez la ToString() méthode. Pour mettre en forme un nombre à l’aide d’un format spécifié de la culture actuelle, appelez la ToString(String) méthode.

Le format paramètre peut être une chaîne de format numérique standard ou personnalisée. Toutes les chaînes de format numérique standard autres que « R » (ou « r ») sont prises en charge, comme tous les caractères de format numérique personnalisés. S’il format s’agit null d’une chaîne vide (« »), la valeur de retour de cette méthode est mise en forme avec le spécificateur de format numérique général (« G »).

Objet CultureInfo qui représente la culture dont les règles de mise en forme doivent être utilisées.
Objet NumberFormatInfo qui contient des informations de mise en forme numériques spécifiques pour cette valeur.
Objet personnalisé qui implémente IFormatProvider.

.NET fournit une prise en charge étendue de la mise en forme, qui est décrite plus en détail dans les rubriques de mise en forme suivantes :

Pour plus d’informations sur les spécificateurs de format numérique, consultez Chaînes de format numérique standard et chaînes de format numérique personnalisées.
Pour plus d’informations sur la mise en forme, consultez Types de mise en forme.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?