Byte.ToString Byte.ToString Byte.ToString Byte.ToString Method

Définition

Convertit la valeur de l'objet Byte actif en sa représentation équivalente sous forme de chaîne.Converts the value of the current Byte object to its equivalent string representation.

Surcharges

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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.Converts the numeric value of the current Byte object to its equivalent string representation using the specified culture-specific formatting information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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.Converts the value of the current Byte object to its equivalent string representation using the specified format and culture-specific formatting information.

ToString(String) ToString(String) ToString(String) 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é.Converts the value of the current Byte object to its equivalent string representation using the specified format.

ToString() ToString() ToString() ToString()

Convertit la valeur de l'objet Byte actif en sa représentation équivalente sous forme de chaîne.Converts the value of the current Byte object to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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.Converts the numeric value of the current Byte object to its equivalent string representation using the specified culture-specific formatting information.

public:
 System::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 IFormatProvider IFormatProvider IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.An object that supplies culture-specific formatting information.

Retours

Représentation sous forme de chaîne de la valeur de cet objet, dans le format spécifié par le paramètre provider.The string representation of the value of this object in the format specified by the provider parameter.

Implémente

Exemples

L’exemple suivant itère un tableau de valeurs d’octets et affiche chacun d’eux dans la console en appelant la ToString(IFormatProvider) méthode avec des fournisseurs de format différents.The following example iterates an array of byte values and displays each of them to the console by calling the ToString(IFormatProvider) method with different format providers.

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)            
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 »).The return value is formatted with the general numeric format specifier ("G").

Le provider paramètre est un objet qui implémente l' IFormatProvider interface.The provider parameter is an object that implements the IFormatProvider interface. 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.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. L’objet qui implémente IFormatProvider peut être l’un des éléments suivants :The object that implements IFormatProvider can be any of the following:

  • CultureInfo Objet qui représente la culture dont les règles de mise en forme doivent être utilisées.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • NumberFormatInfo Objet qui contient des informations de mise en forme numérique spécifiques pour cette valeur.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Objet personnalisé qui implémente IFormatProvider.A custom object that implements IFormatProvider.

Si provider NumberFormatInfo est null ou qu’un objet ne peut pas providerêtre obtenu à partir de, la valeur NumberFormatInfo de retour est mise en forme à l’aide de l’objet pour la culture actuelle du thread.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. Pour plus d’informations sur la culture actuelle du Thread.CurrentCulturethread, consultez.For information about the thread current culture, see Thread.CurrentCulture.

Le .NET Framework 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:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Voir aussi

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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.Converts the value of the current Byte object to its equivalent string representation using the specified format and culture-specific formatting information.

public:
 virtual System::String ^ ToString(System::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 String String String

Chaîne de format numérique standard ou personnalisée.A standard or custom numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture.An object that supplies culture-specific formatting information.

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.The string representation of the current Byte object, formatted as specified by the format and provider parameters.

Implémente

Exceptions

format inclut un spécificateur non pris en charge.format includes an unsupported specifier. Les spécificateurs de format pris en charge sont répertoriés dans la section Notes.Supported format specifiers are listed in the Remarks section.

Exemples

L’exemple suivant utilise la chaîne de format « N » standard et quatre CultureInfo objets différents pour afficher la représentation sous forme de chaîne d’une valeur d’octet dans la console.The following example uses the standard "N" format string and four different CultureInfo objects to display the string representation of a byte value to the 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)      
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 Byte forme une valeur dans un format spécifié d’une culture spécifiée.The ToString(String, IFormatProvider) method formats a Byte value in a specified format of a specified culture. Pour mettre en forme un nombre en utilisant le format par défaut (« G ») de la culture actuelle ToString() , appelez la méthode.To format a number by using the default ("G") format of the current culture, call the ToString() method. Pour mettre en forme un nombre à l’aide d’un format spécifié de la culture ToString(String) actuelle, appelez la méthode.To format a number by using a specified format of the current culture, call the ToString(String) method.

Le format paramètre peut être une chaîne de format numérique standard ou personnalisée.The format parameter can be either a standard or a custom numeric format string. 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.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Si format estnull 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").If format is null or an empty string (""), the return value of this method is formatted with the general numeric format specifier ("G").

Le provider paramètre est un objet qui implémente l' IFormatProvider interface.The provider parameter is an object that implements the IFormatProvider interface. 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.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. L’objet qui implémente IFormatProvider peut être l’un des éléments suivants :The object that implements IFormatProvider can be any of the following:

  • CultureInfo Objet qui représente la culture dont les règles de mise en forme doivent être utilisées.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • NumberFormatInfo Objet qui contient des informations de mise en forme numérique spécifiques pour cette valeur.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Objet personnalisé qui implémente IFormatProvider.A custom object that implements IFormatProvider.

Si provider NumberFormatInfo est null ou qu’un objet ne peut pas providerêtre obtenu à partir de, la valeur NumberFormatInfo de retour est mise en forme à l’aide de l’objet pour la culture actuelle du thread.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. Pour plus d’informations sur la culture actuelle du Thread.CurrentCulturethread, consultez.For information about the thread current culture, see Thread.CurrentCulture.

Le .NET Framework 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:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Voir aussi

ToString(String) ToString(String) ToString(String) 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é.Converts the value of the current Byte object to its equivalent string representation using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Paramètres

format
String String String String

Chaîne de format numérique.A numeric format string.

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.The string representation of the current Byte object, formatted as specified by the format parameter.

Exceptions

format inclut un spécificateur non pris en charge.format includes an unsupported specifier. Les spécificateurs de format pris en charge sont répertoriés dans la section Notes.Supported format specifiers are listed in the Remarks section.

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.The following example initializes a Byte value and displays it to the console using each of the supported standard format strings and a custom format string. L’exemple est exécuté avec en-US comme culture actuelle.The example is run with en-US as the current culture.

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           
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.The format parameter can be either a standard or a custom numeric format string. 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.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Si format estnull 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").If format is null or an empty string (""), the return value is formatted with the general numeric format specifier ("G").

La valeur de retour de cette fonction est mise en NumberFormatInfo forme à l’aide de l’objet pour la culture actuelle du thread.The return value of this function is formatted using the NumberFormatInfo object for the thread current culture. Pour plus d’informations sur la culture actuelle du Thread.CurrentCulturethread, consultez.For information about the thread current culture, see Thread.CurrentCulture. Pour fournir des informations de mise en forme pour les cultures autres que la culture Byte.ToString(String, IFormatProvider) actuelle, appelez la méthode.To provide formatting information for cultures other than the current culture, call the Byte.ToString(String, IFormatProvider) method.

Le .NET Framework 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:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Voir aussi

ToString() ToString() ToString() ToString()

Convertit la valeur de l'objet Byte actif en sa représentation équivalente sous forme de chaîne.Converts the value of the current Byte object to its equivalent string representation.

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.The string representation of the value of this object, which consists of a sequence of digits that range from 0 to 9 with no leading zeroes.

Exemples

L’exemple suivant affiche un tableau de valeurs d’octets.The following example displays an array of byte values. Notez que la ToString() méthode n’est pas appelée explicitement dans l’exemple.Note that the ToString() method is not called explicitly in the example. Au lieu de cela, il est appelé implicitement, en raison de l’utilisation de la fonctionnalité de mise en forme composite .Instead, it is called implicitly, because of the use of the composite formatting feature.

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
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 » NumberFormatInfo ) et l’objet pour la culture actuelle du thread.The return value is formatted with the general numeric format specifier ("G") and the NumberFormatInfo object for the thread current culture. Pour définir la mise en forme de Byte la représentation sous forme de chaîne de ToString la valeur, appelez la méthode.To define the formatting of the Byte value's string representation, call the ToString method. Pour définir à la fois les spécificateurs de format et la culture utilisée pour créer la Byte représentation sous forme de ToString chaîne d’une valeur, appelez la méthode.To define both the format specifiers and culture used to create the string representation of a Byte value, call the ToString method.

Le .NET Framework 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:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Pour plus d’informations sur la culture actuelle du Thread.CurrentCulturethread, consultez.For information about the thread current culture, see Thread.CurrentCulture.

S’applique à