UInt16.ToString UInt16.ToString UInt16.ToString UInt16.ToString Method

Definizione

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente.Converts the numeric value of this instance to its equivalent string representation.

Overload

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni di formato specifiche delle impostazioni cultura.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente usando il formato specificato e le informazioni di formattazione specifiche delle impostazioni cultura.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) ToString(String)

Converte il valore numerico dell'istanza corrente nella rappresentazione di stringa equivalente, usando il formato specificato.Converts the numeric value of this instance to its equivalent string representation using the specified format.

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

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Converte il valore numerico di questa istanza nella rappresentazione di stringa equivalente usando le informazioni di formato specifiche delle impostazioni cultura.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

Parametri

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.An object that supplies culture-specific formatting information.

Restituisce

Rappresentazione di stringa del valore di questa istanza, composto da una sequenza di cifre comprese tra 0 e 9 senza segno o zeri iniziali.The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.

Implementazioni

Esempi

Nell'esempio seguente viene formattato un valore intero con segno a 16 bit utilizzando diversi provider di formato, incluso uno per la lingua inglese.The following example formats a 16-bit signed integer value by using several format providers, including one for the invariant culture. Nell'output dell'esempio viene illustrato che la stringa formattata restituita dal ToString(IFormatProvider) metodo è la stessa indipendentemente dal provider di formato.The output from the example illustrates that the formatted string returned by the ToString(IFormatProvider) method is the same regardless of the format provider.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define an array of CultureInfo objects.
      CultureInfo[] ci = { new CultureInfo("en-US"), 
                           new CultureInfo("fr-FR"), 
                           CultureInfo.InvariantCulture }; 
      UInt16 value = 18924;
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        GetName(ci[0]), GetName(ci[1]), GetName(ci[2])); 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2]));   
   }

   private static string GetName(CultureInfo ci)
   {
      if (ci.Equals(CultureInfo.InvariantCulture))
         return "Invariant";
      else
         return ci.Name;         
   }
}
// The example displays the following output:
//          en-US          fr-FR      Invariant
//          18924          18924          18924
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define an array of CultureInfo objects.
      Dim ci() As CultureInfo = { New CultureInfo("en-US"), _
                                  New CultureInfo("fr-FR"), _
                                  CultureInfo.InvariantCulture } 
      Dim value As UInt16 = 18924
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        GetName(ci(0)), GetName(ci(1)), GetName(ci(2))) 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        value.ToString(ci(0)), value.ToString(ci(1)), value.ToString(ci(2)))            
      
   End Sub
   
   Private Function GetName(ci As CultureInfo) As String
      If ci.Equals(CultureInfo.InvariantCulture) Then
         Return "Invariant"
      Else
         Return ci.Name
      End If   
   End Function
End Module
' The example displays the following output:
'         en-US          fr-FR      Invariant
'         18924          18924          18924

Commenti

Il ToString(IFormatProvider) metodo formatta un UInt16 valore nel formato predefinito ("G" o generale) utilizzando l' NumberFormatInfo oggetto di impostazioni cultura specificate.The ToString(IFormatProvider) method formats a UInt16 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Se si desidera specificare un formato diverso o le impostazioni cultura correnti, utilizzare gli altri overload del ToString metodo, come indicato di seguito:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Per utilizzare il formatoTo use format Per le impostazioni culturaFor culture Usare l'overloadUse the overload
Formato predefinito ("G")Default ("G") format Impostazioni cultura predefinite (correnti)Default (current) culture ToString()
Formato specificoA specific format Impostazioni cultura predefinite (correnti)Default (current) culture ToString(String)
Formato specificoA specific format Impostazioni cultura specificheA specific culture ToString(String, IFormatProvider)

Il provider parametro è un' IFormatProvider implementazione di.The provider parameter is an IFormatProvider implementation. Il GetFormat metodo restituisce un NumberFormatInfo oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific formatting information. Tuttavia, nessuna delle proprietà di NumberFormatInfo viene utilizzata per la formattazione con l'identificatore di formato numerico generale ("G").However, none of the properties of the NumberFormatInfo are used when formatting with the general numeric format specifier ("G").

Vedi anche

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente usando il formato specificato e le informazioni di formattazione specifiche delle impostazioni cultura.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format 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

Parametri

format
String String String String

Stringa di formato numerico.A numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Oggetto che fornisce informazioni di formattazione specifiche delle impostazioni cultura.An object that supplies culture-specific formatting information.

Restituisce

Rappresentazione di stringa del valore dell'istanza corrente, in base a quanto specificato da format e provider.The string representation of the value of this instance, as specified by format and provider.

Implementazioni

Eccezioni

format non è valido.format is invalid.

Esempi

Nell'esempio seguente viene visualizzato un valore di Unsigned Integer a 16 bit utilizzando gli identificatori di formato numerico standard e un numero CultureInfo di oggetti specifici.The following example displays a 16-bit unsigned integer value by using the standard numeric format specifiers and a number of specific CultureInfo objects.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define cultures whose formatting conventions are to be used.
      CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"), 
                                 CultureInfo.CreateSpecificCulture("fr-FR"), 
                                 CultureInfo.CreateSpecificCulture("es-ES") };
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}; 
      ushort value = 22042;
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 16}",  
                              specifier, culture.Name, 
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:            22042
//        G format using fr-FR culture:            22042
//        G format using es-ES culture:            22042
//       
//        C format using en-US culture:       $22,042.00
//        C format using fr-FR culture:      22 042,00 €
//        C format using es-ES culture:      22.042,00 €
//       
//       D4 format using en-US culture:            22042
//       D4 format using fr-FR culture:            22042
//       D4 format using es-ES culture:            22042
//       
//       E2 format using en-US culture:        2.20E+004
//       E2 format using fr-FR culture:        2,20E+004
//       E2 format using es-ES culture:        2,20E+004
//       
//        F format using en-US culture:         22042.00
//        F format using fr-FR culture:         22042,00
//        F format using es-ES culture:         22042,00
//       
//        N format using en-US culture:        22,042.00
//        N format using fr-FR culture:        22 042,00
//        N format using es-ES culture:        22.042,00
//       
//        P format using en-US culture:   2,204,200.00 %
//        P format using fr-FR culture:   2 204 200,00 %
//        P format using es-ES culture:   2.204.200,00 %
//       
//       X2 format using en-US culture:             561A
//       X2 format using fr-FR culture:             561A
//       X2 format using es-ES culture:             561A
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define cultures whose formatting conventions are to be used.
      Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
                                       CultureInfo.CreateSpecificCulture("fr-FR"), _
                                       CultureInfo.CreateSpecificCulture("es-ES") }
      Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"} 
      Dim value As UShort = 22042
      
      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 16}", _ 
                              specifier, culture.Name, _
                              value.ToString(specifier, culture))

         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'        G format using en-US culture:            22042
'        G format using fr-FR culture:            22042
'        G format using es-ES culture:            22042
'       
'        C format using en-US culture:       $22,042.00
'        C format using fr-FR culture:      22 042,00 €
'        C format using es-ES culture:      22.042,00 €
'       
'       D4 format using en-US culture:            22042
'       D4 format using fr-FR culture:            22042
'       D4 format using es-ES culture:            22042
'       
'       E2 format using en-US culture:        2.20E+004
'       E2 format using fr-FR culture:        2,20E+004
'       E2 format using es-ES culture:        2,20E+004
'       
'        F format using en-US culture:         22042.00
'        F format using fr-FR culture:         22042,00
'        F format using es-ES culture:         22042,00
'       
'        N format using en-US culture:        22,042.00
'        N format using fr-FR culture:        22 042,00
'        N format using es-ES culture:        22.042,00
'       
'        P format using en-US culture:   2,204,200.00 %
'        P format using fr-FR culture:   2 204 200,00 %
'        P format using es-ES culture:   2.204.200,00 %
'       
'       X2 format using en-US culture:             561A
'       X2 format using fr-FR culture:             561A
'       X2 format using es-ES culture:             561A

Commenti

Il ToString(String, IFormatProvider) metodo formatta un UInt16 valore in un formato specificato utilizzando l' NumberFormatInfo oggetto di impostazioni cultura specificate.The ToString(String, IFormatProvider) method formats a UInt16 value in a specified format by using the NumberFormatInfo object of a specified culture. Se si desidera utilizzare il formato predefinito o le impostazioni cultura, utilizzare gli altri overload del ToString metodo, come indicato di seguito:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Per utilizzare il formatoTo use format Per le impostazioni culturaFor culture Usare l'overloadUse the overload
Formato predefinito ("G")Default ("G") format Impostazioni cultura predefinite (correnti)Default (current) culture ToString()
Formato predefinito ("G")Default ("G") format Impostazioni cultura specificheA specific culture ToString(IFormatProvider)
Formato specificoA specific format Impostazioni cultura predefinite (correnti)Default (current) culture ToString(String)

Il format parametro può essere costituito da stringhe di formato numerico standardvalide o da qualsiasi combinazione di stringhe di formato numerico personalizzate.The format parameter can be any valid Standard Numeric Format Strings, or any combination of Custom Numeric Format Strings. Se format è uguale a String.Empty o è null, il valore restituito dell'oggetto corrente UInt16 viene formattato con l'identificatore di formato generale ("G").If format is equal to String.Empty or is null, the return value of the current UInt16 object is formatted with the general format specifier ("G"). Se format è qualsiasi altro valore, il metodo genera un' FormatExceptioneccezione.If format is any other value, the method throws a FormatException.

Il .NET Framework fornisce un supporto completo per la formattazione, descritto più dettagliatamente negli argomenti seguenti sulla formattazione:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Il provider parametro è un' IFormatProvider implementazione di.The provider parameter is an IFormatProvider implementation. Il GetFormat metodo restituisce un NumberFormatInfo oggetto che fornisce informazioni specifiche delle impostazioni cultura relative al formato della stringa restituita da questo metodo.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Quando il ToString(String, IFormatProvider) metodo viene richiamato, chiama il provider IFormatProvider.GetFormat metodo del parametro e lo passa a Type un oggetto che rappresenta NumberFormatInfo il tipo.When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's IFormatProvider.GetFormat method and passes it a Type object that represents the NumberFormatInfo type. Il GetFormat metodo restituisce quindi l' NumberFormatInfo oggetto che fornisce informazioni per la formattazione del UInt16 valore corrente, ad esempio il simbolo del separatore di gruppi o il simbolo del separatore decimale.The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the current UInt16 value, such as the group separator symbol or the decimal point symbol. Esistono tre modi per usare il provider parametro per fornire informazioni sulla formattazione ToString(String, IFormatProvider) al metodo:There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • È possibile passare un CultureInfo oggetto che rappresenta le impostazioni cultura che forniscono informazioni di formattazione.You can pass a CultureInfo object that represents the culture that supplies formatting information. Il metodo restituisce l' NumberFormatInfo oggetto che fornisce informazioni sulla formattazione numerica per tali impostazioni cultura. GetFormatIts GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • È possibile passare l'oggetto NumberFormatInfo effettivo che fornisce informazioni sulla formattazione numerica.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (L'implementazione di GetFormat restituisce solo se stessa).(Its implementation of GetFormat just returns itself.)

  • È possibile passare un oggetto personalizzato che implementa IFormatProvider.You can pass a custom object that implements IFormatProvider. Il GetFormat metodo crea un'istanza di e NumberFormatInfo restituisce l'oggetto che fornisce informazioni sulla formattazione.Its GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Se provider NumberFormatInfo è null, la formattazione della stringa restituita è basata sull'oggetto delle impostazioni cultura correnti.If provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Vedi anche

ToString(String) ToString(String) ToString(String) ToString(String)

Converte il valore numerico dell'istanza corrente nella rappresentazione di stringa equivalente, usando il formato specificato.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

Parametri

format
String String String String

Stringa di formato numerico.A numeric format string.

Restituisce

Rappresentazione di stringa del valore dell'istanza, in base a quanto specificato da format.The string representation of the value of this instance as specified by format.

Eccezioni

Il parametro format non è valido.The format parameter is invalid.

Esempi

Nell'esempio seguente viene visualizzato un valore di Unsigned Integer a 16 bit utilizzando ogni stringa di formato standard e alcune stringhe di formato personalizzate.The following example displays a 16-bit unsigned integer value by using each standard format string and some custom format strings.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      ushort value = 21708;
      string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", 
                              "N", "P", "X", "000000.0", "#.0", 
                              "00000000;(0);**Zero**" };
      
      foreach (string specifier in specifiers)
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
   }
}
// The example displays the following output:
//       G: 21708
//       C: $21,708.00
//       D3: 21708
//       E2: 2.17E+004
//       e3: 2.171e+004
//       F: 21708.00
//       N: 21,708.00
//       P: 2,170,800.00 %
//       X: 54CC
//       000000.0: 021708.0
//       #.0: 21708.0
//       00000000;(0);**Zero**: 00021708
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As UShort = 21708 
      Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
                                     "N", "P", "X", "000000.0", "#.0", _
                                     "00000000;(0);**Zero**" }
      
      For Each specifier As String In specifiers
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
      Next
   End Sub
End Module
' The example displays the following output:
'       G: 21708
'       C: $21,708.00
'       D3: 21708
'       E2: 2.17E+004
'       e3: 2.171e+004
'       F: 21708.00
'       N: 21,708.00
'       P: 2,170,800.00 %
'       X: 54CC
'       000000.0: 021708.0
'       #.0: 21708.0
'       00000000;(0);**Zero**: 00021708

Commenti

Il ToString(String) metodo formatta un UInt16 valore in un formato specificato utilizzando un NumberFormatInfo oggetto che rappresenta le convenzioni delle impostazioni cultura correnti.The ToString(String) method formats a UInt16 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Se si desidera utilizzare il formato predefinito ("G" o generale) o specificare impostazioni cultura diverse, utilizzare gli altri overload del ToString metodo, come indicato di seguito: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:

Per utilizzare il formatoTo use format Per le impostazioni culturaFor culture Usare l'overloadUse the overload
Formato predefinito ("G")Default ("G") format Impostazioni cultura predefinite (correnti)Default (current) culture ToString()
Formato predefinito ("G")Default ("G") format Impostazioni cultura specificheA specific culture ToString(IFormatProvider)
Formato specificoA specific format Impostazioni cultura specificheA specific culture ToString(String, IFormatProvider)

Il format parametro può essere qualsiasi identificatore di formato numerico standardvalido o qualsiasi combinazione di identificatori di formato numerico personalizzati.The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. Se format è uguale a String.Empty o è null, il valore restituito dell'oggetto corrente UInt16 viene formattato con l'identificatore di formato generale ("G").If format is equal to String.Empty or is null, the return value of the current UInt16 object is formatted with the general format specifier ("G"). Se format è qualsiasi altro valore, il metodo genera un' FormatExceptioneccezione.If format is any other value, the method throws a FormatException.

Il .NET Framework fornisce un supporto completo per la formattazione, descritto più dettagliatamente negli argomenti seguenti sulla formattazione:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Il formato della stringa restituita è determinato dall' NumberFormatInfo oggetto per le impostazioni cultura correnti.The format of the returned string is determined by the NumberFormatInfo object for the current culture. A seconda del format parametro, questo oggetto controlla i simboli come il separatore di gruppi e il simbolo del separatore decimale nella stringa di output.Depending on the format parameter, this object controls symbols such as the group separator and the decimal point symbol in the output string. Per fornire informazioni sulla formattazione per le impostazioni cultura diverse da quelle correnti, ToString(String, IFormatProvider) chiamare l'overload.To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Vedi anche

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

Converte il valore numerico dell'istanza nella rappresentazione di stringa equivalente.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

Restituisce

Rappresentazione di stringa del valore di questa istanza, composto da una sequenza di cifre comprese tra 0 e 9 senza segno o zeri iniziali.The string representation of the value of this instance, which consists of a sequence of digits ranging from 0 to 9, without a sign or leading zeros.

Esempi

Nell'esempio seguente viene visualizzato UInt16 un valore utilizzando il metodo ToString() predefinito.The following example displays a UInt16 value by using the default ToString() method. Vengono inoltre visualizzate le rappresentazioni di stringa UInt16 del valore risultante dall'utilizzo di alcuni identificatori di formato standard.It also displays the string representations of the UInt16 value that results from using some standard format specifiers. Gli esempi vengono visualizzati usando le convenzioni di formattazione delle impostazioni cultura en-US.The examples are displayed using the formatting conventions of the en-US culture.

using System;

public class Example
{
   public static void Main()
   {
      ushort value = 16324;
      // Display value using default ToString method.
      Console.WriteLine(value.ToString());      
      Console.WriteLine();
      
      // Define an array of format specifiers.
      string[] formats = { "G", "C", "D", "F", "N", "X" };
      // Display value using the standard format specifiers.
      foreach (string format in formats)
         Console.WriteLine("{0} format specifier: {1,12}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       16324
//
//       G format specifier:        16324
//       C format specifier:   $16,324.00
//       D format specifier:        16324
//       F format specifier:     16324.00
//       N format specifier:    16,324.00
//       X format specifier:         3FC4
Module Example
   Public Sub Main()
      Dim value As UInt16 = 16324
      ' Display value using default ToString method.
      Console.WriteLine(value.ToString())            
      Console.WriteLine()
      
      ' Define an array of format specifiers.
      Dim formats() As String = { "G", "C", "D", "F", "N", "X" }
      ' Display value using the standard format specifiers.
      For Each format As String In formats
         Console.WriteLine("{0} format specifier: {1,12}", _
                           format, value.ToString(format))         
      Next
   End Sub
End Module
' The example displays the following output:
'       16324
'       
'       G format specifier:        16324
'       C format specifier:   $16,324.00
'       D format specifier:        16324
'       F format specifier:     16324.00
'       N format specifier:    16,324.00
'       X format specifier:         3FC4

Commenti

Il ToString() metodo formatta un UInt16 valore nel formato predefinito ("G" o generale) utilizzando l' NumberFormatInfo oggetto delle impostazioni cultura correnti.The ToString() method formats a UInt16 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Se si desidera specificare un formato o impostazioni cultura diverse, utilizzare gli altri overload del ToString metodo, come indicato di seguito:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Per utilizzare il formatoTo use format Per le impostazioni culturaFor culture Usare l'overloadUse the overload
Formato predefinito ("G")Default ("G") format Impostazioni cultura specificheA specific culture ToString(IFormatProvider)
Formato specificoA specific format Impostazioni cultura predefinite (correnti)Default (current) culture ToString(String)
Formato specificoA specific format Impostazioni cultura specificheA specific culture ToString(String, IFormatProvider)
Vedi anche

Si applica a