Byte.ToString Méthode

Définition

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)

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

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

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.

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 é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 est null ou qu’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 :

Voir aussi

S’applique à

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

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

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

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ériques standard autres que « R » (ou « r ») sont prises en charge, tout comme tous les caractères de format numériques 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 du 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 :

Voir aussi

S’applique à

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.

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

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

Exceptions

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ériques standard autres que « R » (ou « r ») sont prises en charge, tout comme tous les caractères de format numériques 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 »).

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 est null ou qu’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 :

Voir aussi

S’applique à

ToString()

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

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

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 sous forme 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 la culture actuelle du thread, consultez Thread.CurrentCulture.

S’applique à