Byte.ToString Méthode

Référence

Définition

Espace de noms:: System

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 Byte actif en sa représentation équivalente sous forme de chaîne.

Surcharges

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

ToString(IFormatProvider)

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Convertit la valeur numérique de l'objet Byte actuel en sa représentation sous forme de chaîne équivalente à l'aide des informations de mise en forme propres à 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, dans le format spécifié par le paramètre provider.

Implémente

ToString(IFormatProvider)

Exemples

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

array<Byte>^ bytes = gcnew array<Byte> {0, 1, 14, 168, 255};
array<CultureInfo^>^ providers = {gcnew CultureInfo("en-us"), 
                                  gcnew CultureInfo("fr-fr"), 
                                  gcnew CultureInfo("de-de"), 
                                  gcnew CultureInfo("es-es")};
for each (Byte byteValue in bytes)
{
   for each (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)

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 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érique spécifiques pour cette valeur.
Objet personnalisé qui implémente IFormatProvider.

Si provider est null ou un NumberFormatInfo objet ne peut pas être obtenu à partir de provider, la valeur de retour est mise en forme à l’aide de l’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 Mise en forme des types.

Voir aussi

S’applique à

ToString(String)

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Convertit la valeur de l'objet Byte actuel en sa représentation sous forme de chaîne équivalente en utilisant le 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 Byte actif, mis en forme tel que spécifié par le paramètre format.

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 dans 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.

array<String^>^ formats = gcnew array<String^> {"C3", "D4", "e1", "E2", "F1", "G", "N1", 
                                                "P0", "X4", "0000.0000"};
Byte number = 240;
for each (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

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 toutes les caractères de format numérique personnalisés. Si format est null ou 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 pour la culture actuelle de thread. Pour plus d’informations sur la culture actuelle du thread, consultez Thread.CurrentCulture. Pour fournir des informations de mise en forme pour des 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 Mise en forme des types.

Voir aussi

Comment : remplir un nombre avec des zéros non significatifs

S’applique à

ToString(String, IFormatProvider)

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

Convertit la valeur de l'objet Byte actif en sa représentation sous forme de chaîne équivalente à l'aide du format et des informations de mise en forme spécifiques à la culture 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 Byte actif, mis en forme tel que spécifié par les paramètres format et provider.

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;
array<CultureInfo^>^ providers = gcnew array<CultureInfo^> { gcnew CultureInfo("en-us"), 
                                                             gcnew CultureInfo("fr-fr"), 
                                                             gcnew CultureInfo("es-es"), 
                                                             gcnew CultureInfo("de-de")}; 

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

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 toutes les caractères de format numérique personnalisés. Si format est null ou 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érique 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 Mise en forme des types.

Voir aussi

S’applique à

ToString()

Source:: Byte.cs

Source:: Byte.cs

Source:: Byte.cs

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

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, constituée d'une séquence de chiffres entre 0 et 9, sans zéro non significatif.

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, il est appelé implicitement, en raison de l’utilisation de la fonctionnalité de mise en forme composite , l’exemple F# utilise l’interpolation de chaîne.

array<Byte>^ bytes = gcnew array<Byte> {0, 1, 14, 168, 255};
for each (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

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 pour la culture actuelle du thread. Pour définir la mise en forme de la représentation de chaîne de la Byte valeur, appelez la ToString méthode . Pour définir à la fois 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 Mise en forme des types.

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

S’applique à

Partage via

Byte.ToString Méthode

Définition

Surcharges

ToString(IFormatProvider)

Paramètres

Retours

Implémente

Exemples

Remarques

Voir aussi

S’applique à

ToString(String)

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

ToString(String, IFormatProvider)

Paramètres

Retours

Implémente

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

ToString()

Retours

Exemples

Remarques

S’applique à

Ressources supplémentaires