Int16.ToString Méthode

Définition

Convertit la valeur numérique de cette instance en sa représentation équivalente sous forme de chaîne.Converts the numeric value of this instance to its equivalent string representation.

Surcharges

ToString(IFormatProvider)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide des informations de format spécifiques à la culture donnée.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

Convertit la valeur numérique de cette instance en représentation sous forme de chaîne équivalente à l'aide du format spécifié et des informations de mise en forme spécifiques à la culture.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific formatting information.

ToString(String)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString()

Convertit la valeur numérique de cette instance en sa représentation équivalente sous forme de chaîne.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide des informations de format spécifiques à la culture donnée.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format 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 qui fournit des informations de format propres à la culture.An IFormatProvider that supplies culture-specific formatting information.

Retours

Représentation sous forme de chaîne de la valeur de cette instance, comme indiqué par provider.The string representation of the value of this instance as specified by provider.

Implémente

Exemples

L’exemple suivant itère un tableau de valeurs Int16 et affiche chacun d’eux dans la console en appelant la méthode Int16.ToString(IFormatProvider) avec des fournisseurs de format différents.The following example iterates an array of Int16 values and displays each of them to the console by calling the Int16.ToString(IFormatProvider) method with different format providers. En raison de la mise en forme simple définie par le spécificateur de format "G" par défaut, les chaînes mises en forme produites pour chaque valeur Int16 sont identiques, quelle que soit la valeur du paramètre provider.Because of the simple formatting defined by the default "G" format specifier, the formatted strings produced for each Int16 value are identical regardless of the value of the provider parameter.

short[] numbers = {-23092, 0, 14894, Int16.MaxValue};
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("de-de"), 
                           new CultureInfo("es-es")};
foreach (Int16 int16Value in numbers)
{
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0, 6} ({1})     ", 
                    int16Value.ToString(provider), 
                    provider.Name);
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
//            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
//        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
//        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)      
Dim numbers() As Short = {-23092, 0, 14894, Int16.MaxValue}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
For Each int16Value As Short In Numbers
   For Each provider As CultureInfo In providers
      Console.Write("{0, 6} ({1})     ", _
                    int16Value.ToString(provider), _
                    provider.Name)
   Next                     
   Console.WriteLine()
Next 
' The example displays the following output to the console:
'       -23092 (en-US)     -23092 (fr-FR)     -23092 (de-DE)     -23092 (es-ES)
'            0 (en-US)          0 (fr-FR)          0 (de-DE)          0 (es-ES)
'        14894 (en-US)      14894 (fr-FR)      14894 (de-DE)      14894 (es-ES)
'        32767 (en-US)      32767 (fr-FR)      32767 (de-DE)      32767 (es-ES)      

Remarques

La méthode ToString(IFormatProvider) met en forme une valeur Int16 dans le format par défaut (« G » ou général) à l’aide de l’objet NumberFormatInfo d’une culture spécifiée.The ToString(IFormatProvider) method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Si vous souhaitez spécifier un autre format ou la culture actuelle, utilisez les autres surcharges de la méthode ToString, comme suit :If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Pour utiliser le formatTo use format Pour la cultureFor culture Utiliser la surchargeUse the overload
Format par défaut (« G »)Default ("G") format Culture par défaut (actuelle)Default (current) culture ToString()
Un format spécifiqueA specific format Culture par défaut (actuelle)Default (current) culture ToString(String)
Un format spécifiqueA specific format Une culture spécifiqueA specific culture ToString(String, IFormatProvider)

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:

Le paramètre provider est une implémentation IFormatProvider dont la méthode IFormatProvider.GetFormat retourne un objet NumberFormatInfo.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. En général, provider est un objet NumberFormatInfo ou un objet CultureInfo.Typically, provider is a NumberFormatInfo object or a CultureInfo object. L’objet NumberFormatInfo fournit des informations spécifiques à la culture sur le format de la chaîne retournée par cette méthode.The NumberFormatInfo object provides culture-specific information about the format of the string returned by this method. Si provider est null, cette instance est mise en forme avec l’objet NumberFormatInfo pour la culture actuelle.If provider is null, this instance is formatted with the NumberFormatInfo object for the current culture.

Voir aussi

ToString(String, IFormatProvider)

Convertit la valeur numérique de cette instance en représentation sous forme de chaîne équivalente à l'aide du format spécifié et des informations de mise en forme spécifiques à la culture.Converts the numeric value of this instance 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

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

provider
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 cette instance, telle que spécifiée par format et provider.The string representation of the value of this instance as specified by format and provider.

Implémente

Exemples

L’exemple suivant affiche une valeur Int16 à l’aide de chacune des chaînes de format standard prises en charge dans quatre cultures différentes.The following example displays an Int16 value using each of the supported standard format strings in four different cultures.

Int16 value = 14603;
string[] formats = {"C", "D6", "e1", "E2", "F1", "G", "N1", 
                    "P0", "X4", "000000.0000", "##000.0"};
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("de-de"), 
                           new CultureInfo("es-es")};
// Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers[0], providers[1], 
                  providers[2], providers[3]);
Console.WriteLine();
// Display a value using each format string.
foreach (string format in formats)
{
   // Display the value for each provider on the same line.
   Console.Write("{0,-12}", format);
   foreach (CultureInfo provider in providers)
   {
      Console.Write("{0,12}  ", 
                    value.ToString(format, provider)); 
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//                       en-US         fr-FR         de-DE         es-ES
//    
//    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €  
//    D6                014603        014603        014603        014603  
//    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004  
//    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004  
//    F1               14603.0       14603,0       14603,0       14603,0  
//    G                  14603         14603         14603         14603  
//    N1              14,603.0      14 603,0      14.603,0      14.603,0  
//    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %  
//    X4                  390B          390B          390B          390B  
//    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000  
//    ##000.0          14603.0       14603,0       14603,0       14603,0  
Dim value As Int16 = 14603
Dim formats() As String = {"C", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
                                  New CultureInfo("fr-fr"), _
                                  New CultureInfo("de-de"), _
                                  New CultureInfo("es-es")}
' Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers(0), providers(1), _
                  providers(2), providers(3))
Console.WriteLine()                        
' Display a value using each format string.
For Each format As String In formats
   ' Display the value for each provider on the same line.
   Console.Write("{0,-12}", format)
   For Each provider As CultureInfo In providers
      Console.Write("{0,12}  ", _
                    value.ToString(format, provider)) 
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'                       en-US         fr-FR         de-DE         es-ES
'    
'    C             $14,603.00   14 603,00 €   14.603,00 €   14.603,00 €  
'    D6                014603        014603        014603        014603  
'    e1              1.5e+004      1,5e+004      1,5e+004      1,5e+004  
'    E2             1.46E+004     1,46E+004     1,46E+004     1,46E+004  
'    F1               14603.0       14603,0       14603,0       14603,0  
'    G                  14603         14603         14603         14603  
'    N1              14,603.0      14 603,0      14.603,0      14.603,0  
'    P0           1,460,300 %   1 460 300 %    1.460.300%   1.460.300 %  
'    X4                  390B          390B          390B          390B  
'    000000.0000  014603.0000   014603,0000   014603,0000   014603,0000  
'    ##000.0          14603.0       14603,0       14603,0       14603,0  

Remarques

La méthode ToString(String, IFormatProvider) met en forme une valeur Int16 dans un format spécifié à l’aide de l’objet NumberFormatInfo d’une culture spécifiée.The ToString(String, IFormatProvider) method formats an Int16 value in a specified format by using the NumberFormatInfo object of a specified culture. Si vous souhaitez utiliser des paramètres de format ou de culture par défaut, utilisez les autres surcharges de la méthode ToString, comme suit :If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Pour utiliser le formatTo use format Pour la cultureFor culture Utiliser la surchargeUse the overload
Format par défaut (« G »)Default ("G") format Culture par défaut (actuelle)Default (current) culture ToString()
Format par défaut (« G »)Default ("G") format Une culture spécifiqueA specific culture ToString(IFormatProvider)
Un format spécifiqueA specific format Culture par défaut (actuelle)Default (current) culture ToString(String)

Le paramètre format 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 est null ou une chaîne vide (""), la chaîne retournée par 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 string returned by this method is formatted with the general numeric format specifier ("G").

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:

Le paramètre provider est une implémentation IFormatProvider.The provider parameter is an IFormatProvider implementation. Sa méthode GetFormat retourne un objet NumberFormatInfo 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:

  • Objet CultureInfo 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.

  • Objet NumberFormatInfo 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 est nullou si un objet NumberFormatInfo ne peut pas être obtenu à partir de provider, la valeur de retour est mise en forme avec la NumberFormatInfo pour la culture actuelle.If provider is null, or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted with the NumberFormatInfo for the current culture.

Voir aussi

ToString(String)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.Converts the numeric value of this instance 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

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

Retours

Représentation sous forme de chaîne de la valeur de cette instance, comme indiqué par format.The string representation of the value of this instance as specified by format.

Exemples

L’exemple suivant initialise deux valeurs Int16 et les affiche dans la console à l’aide de chacune des chaînes de format standard prises en charge et de plusieurs chaînes de format personnalisées.The following example initializes two Int16 values and displays them to the console using each of the supported standard format strings and several custom format strings. L’exemple est exécuté avec en-US comme culture actuelle.The example is run with en-US as the current culture.

Int16[] values = {-23805, 32194};
string[] formats = {"C4", "D6", "e1", "E2", "F1", "G", "N1", 
                    "P0", "X4", "000000.0000", "##000.0"};
foreach (string format in formats)
{
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}",  
                     format, 
                     values[0].ToString(format), 
                     values[1].ToString(format));
}                                                               
// The example displays the following output to the console:
//    'C4' format specifier:    ($23,805.0000)        $32,194.0000
//    'D6' format specifier:           -023805              032194
//    'e1' format specifier:         -2.4e+004            3.2e+004
//    'E2' format specifier:        -2.38E+004           3.22E+004
//    'F1' format specifier:          -23805.0             32194.0
//    ' G' format specifier:            -23805               32194
//    'N1' format specifier:         -23,805.0            32,194.0
//    'P0' format specifier:      -2,380,500 %         3,219,400 %
//    'X4' format specifier:              A303                7DC2
//    '000000.0000' format specifier:      -023805.0000         032194.0000
//    '##000.0' format specifier:          -23805.0             32194.0      
Dim values() As Int16 = {-23805, 32194}
Dim formats() As String = {"C4", "D6", "e1", "E2", "F1", "G", "N1", _
                           "P0", "X4", "000000.0000", "##000.0"}
For Each format As String In formats
   Console.WriteLine("'{0,2}' format specifier: {1,17}   {2,17}", _ 
                     format, _
                     values(0).ToString(format), _
                     values(1).ToString(format))
Next                                                               
' The example displays the following output to the console:
'    'C4' format specifier:    ($23,805.0000)        $32,194.0000
'    'D6' format specifier:           -023805              032194
'    'e1' format specifier:         -2.4e+004            3.2e+004
'    'E2' format specifier:        -2.38E+004           3.22E+004
'    'F1' format specifier:          -23805.0             32194.0
'    ' G' format specifier:            -23805               32194
'    'N1' format specifier:         -23,805.0            32,194.0
'    'P0' format specifier:      -2,380,500 %         3,219,400 %
'    'X4' format specifier:              A303                7DC2
'    '000000.0000' format specifier:      -023805.0000         032194.0000
'    '##000.0' format specifier:          -23805.0             32194.0      

Remarques

La méthode ToString(String) met en forme une valeur Int16 dans un format spécifié à l’aide d’un objet NumberFormatInfo qui représente les conventions de la culture actuelle.The ToString(String) method formats an Int16 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Si vous souhaitez utiliser le format par défaut (« G » ou général) ou spécifier une autre culture, utilisez les autres surcharges de la méthode ToString, comme suit :If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

Pour utiliser le formatTo use format Pour la cultureFor culture Utiliser la surchargeUse the overload
Format par défaut (« G »)Default ("G") format Culture par défaut (actuelle)Default (current) culture ToString()
Format par défaut (« G »)Default ("G") format Une culture spécifiqueA specific culture ToString(IFormatProvider)
Un format spécifiqueA specific format Une culture spécifiqueA specific culture ToString(String, IFormatProvider)

Le paramètre format 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 est null ou une chaîne vide, la valeur de retour de cette instance 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 instance is formatted with the general numeric format specifier ("G").

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:

La valeur de retour de cette instance est mise en forme avec le NumberFormatInfo pour la culture actuelle.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Voir aussi

ToString()

Convertit la valeur numérique de cette instance en sa représentation équivalente sous forme de chaîne.Converts the numeric value of this instance 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 cette instance, avec un signe moins si la valeur est négative et une séquence de chiffres allant de 0 à 9 sans zéros non significatifs.The string representation of the value of this instance, consisting of a minus sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

Exemples

L’exemple suivant utilise la méthode ToString() pour afficher un tableau de valeurs Int16 à la console.The following example uses the ToString() method to display an array of Int16 values to the console.

short[] numbers = {0, 14624, 13982, short.MaxValue, 
                   short.MinValue, -16667};
foreach (short number in numbers)
{
   Console.WriteLine(number.ToString());
}            
// The example displays the following output to the console:
//       0
//       14624
//       13982
//       32767
//       -32768
//       -16667                             
Dim numbers() As Short = {0, 14624, 13982, Short.MaxValue, _
                         Short.MinValue, -16667}
For Each number As Short In numbers
   Console.WriteLine(number.ToString())
Next        
' The example displays the following output to the console:
'       0
'       14624
'       13982
'       32767
'       -32768
'       -16667                             

Remarques

La méthode ToString() met en forme une valeur Int16 dans le format par défaut (« G » ou général) à l’aide de l’objet NumberFormatInfo de la culture actuelle.The ToString() method formats an Int16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Si vous souhaitez spécifier un autre format ou une autre culture, utilisez les autres surcharges de la méthode ToString, comme suit :If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Pour utiliser le formatTo use format Pour la cultureFor culture Utiliser la surchargeUse the overload
Format par défaut (« G »)Default ("G") format Une culture spécifiqueA specific culture ToString(IFormatProvider)
Un format spécifiqueA specific format Culture par défaut (actuelle)Default (current) culture ToString(String)
Un format spécifiqueA specific format Une culture spécifiqueA specific culture ToString(String, IFormatProvider)

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

S’applique à