Decimal.ToString Metoda

Definicja

Konwertuje wartość liczbową tego wystąpienia na równoważną String reprezentację.Converts the numeric value of this instance to its equivalent String representation.

Przeciążenia

ToString(IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych dla kultury.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu i informacji specyficznych dla kultury.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString()

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanych danych formatowania specyficznych dla kultury.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

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

Parametry

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.An object that supplies culture-specific formatting information.

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia określony przez provider .The string representation of the value of this instance as specified by provider.

Implementuje

Przykłady

Poniższy przykład Wyświetla reprezentację ciągu Decimal wartości przy użyciu CultureInfo obiektów, które reprezentują kilka różnych kultur.The following example displays the string representation of a Decimal value using CultureInfo objects that represent several different cultures.

decimal value = -16325.62m;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325.62
//       -16325.62
//       -16325,62
Dim value As Decimal = -16325.62d
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
'       -16325.62
'       -16325.62
'       -16325,62

Uwagi

ToString(IFormatProvider)Metoda formatuje Decimal wartość w formacie domyślnym ("G" lub ogólnym) określonej kultury.The ToString(IFormatProvider) method formats a Decimal value in the default ("G", or general) format of a specified culture. Jeśli chcesz określić inny format lub bieżącą kulturę, użyj innych przeciążeń ToString metody w następujący sposób:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Domyślna kultura (bieżąca)Default (current) culture ToString()
Określony formatA specific format Domyślna kultura (bieżąca)Default (current) culture ToString(String)
Określony formatA specific format Określona kulturaA specific culture ToString(String, IFormatProvider)

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która jest bardziej szczegółowym opisem w następujących tematach:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

providerParametr jest IFormatProvider implementacją, której IFormatProvider.GetFormat Metoda zwraca NumberFormatInfo obiekt.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. Zazwyczaj provider jest NumberFormatInfo obiektem lub CultureInfo obiektem.Typically, provider is a NumberFormatInfo object or a CultureInfo object. providerParametr dostarcza informacje specyficzne dla kultury używane w formatowaniu.The provider parameter supplies culture-specific information used in formatting. Jeśli provider jest null , używana jest bieżąca kultura wątku.If provider is null, the thread current culture is used.

Aby przekonwertować Decimal wartość na reprezentację ciągu przy użyciu określonej kultury i określonego ciągu formatu, wywołaj Decimal.ToString(String, IFormatProvider) metodę.To convert a Decimal value to its string representation using a specified culture and a specific format string, call the Decimal.ToString(String, IFormatProvider) method.

Zobacz też

Dotyczy

ToString(String, IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu i informacji specyficznych dla kultury.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);
public string ToString (string? format, IFormatProvider? provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parametry

format
String

Ciąg formatu liczbowego.A numeric format string.

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficzne dla kultury.An object that supplies culture-specific formatting information.

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia określony przez format i provider .The string representation of the value of this instance as specified by format and provider.

Implementuje

Wyjątki

format jest nieprawidłowy.format is invalid.

Przykłady

Poniższy przykład wyświetla Decimal wartość przy użyciu każdego z obsługiwanych standardowych specyfikatorów formatu liczbowego dla kilku różnych kultur.The following example displays a Decimal value using each of the supported standard numeric format specifiers for several different cultures.

decimal value = 16325.62m;
string specifier;
CultureInfo culture;

// Use standard numeric format specifiers.
specifier = "G";
culture = CultureInfo.CreateSpecificCulture("eu-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture));
// Displays:    16325.62

specifier = "C";
culture = CultureInfo.CreateSpecificCulture("en-US");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    £16,325.62

specifier = "E04";
culture = CultureInfo.CreateSpecificCulture("sv-SE");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1,6326E+004
 culture = CultureInfo.CreateSpecificCulture("en-NZ");
 Console.WriteLine(value.ToString(specifier, culture));
// Displays:    1.6326E+004

specifier = "F";
culture = CultureInfo.CreateSpecificCulture("fr-FR");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.62

specifier = "N";
culture = CultureInfo.CreateSpecificCulture("es-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16 325,62

specifier = "P";
culture = CultureInfo.InvariantCulture;
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG");
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.256 %
Dim value As Decimal = 16325.62d
Dim specifier As String
Dim culture As CultureInfo

' Use standard numeric format specifiers.
specifier = "G"
culture = CultureInfo.CreateSpecificCulture("eu-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays:    16325.62

specifier = "C"
culture = CultureInfo.CreateSpecificCulture("en-US")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    £16,325.62

specifier = "E04"
culture = CultureInfo.CreateSpecificCulture("sv-SE")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ")
 Console.WriteLine(value.ToString(specifier, culture))
' Displays:    1.6326E+004   

specifier = "F"
culture = CultureInfo.CreateSpecificCulture("fr-FR")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325.62

specifier = "N"
culture = CultureInfo.CreateSpecificCulture("es-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16 325,62

specifier = "P"
culture = CultureInfo.InvariantCulture
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG")
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.256 %

Uwagi

ToString(String, IFormatProvider)Metoda formatuje Decimal wartość w określonym formacie określonej kultury.The ToString(String, IFormatProvider) method formats a Decimal value in a specified format of a specified culture. Jeśli chcesz użyć domyślnego formatu lub ustawień kultury, użyj innych przeciążeń ToString metody w następujący sposób:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Domyślna kultura (bieżąca)Default (current) culture ToString()
Domyślny format ("G")Default ("G") format Określona kulturaA specific culture ToString(IFormatProvider)
Określony formatA specific format Domyślna kultura (bieżąca)Default (current) culture ToString(String)

formatParametr może być dowolnym prawidłowym standardowym specyfikatorem formatu liczbowego z wyjątkiem D, R i X, a także dowolną kombinacją niestandardowych specyfikatorów formatu liczbowego.The format parameter can be any valid standard numeric format specifier except for D, R, and X, as well as any combination of custom numeric format specifiers. Jeśli format jest null lub jest pustym ciągiem, wartość zwracana dla tego wystąpienia jest formatowana przy użyciu ogólnego specyfikatora formatu liczbowego ("G").If format is null or an empty string, the return value for this instance is formatted with the general numeric format specifier ("G").

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która jest bardziej szczegółowym opisem w następujących tematach:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

providerParametr jest IFormatProvider implementacją, której IFormatProvider.GetFormat Metoda zwraca NumberFormatInfo obiekt.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. Zazwyczaj provider jest NumberFormatInfo CultureInfo obiektem lub.Typically, provider is a NumberFormatInfo or CultureInfo object. providerParametr dostarcza informacje specyficzne dla kultury używane w formatowaniu.The provider parameter supplies culture-specific information used in formatting. Jeśli provider jest null , używana jest bieżąca kultura wątku.If provider is null, the thread current culture is used.

Zobacz też

Dotyczy

ToString(String)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu przy użyciu podanego formatu.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);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parametry

format
String

Standardowy lub niestandardowy ciąg formatu liczbowego.A standard or custom numeric format string.

Zwraca

String

Ciąg reprezentujący wartość tego wystąpienia określony przez format .The string representation of the value of this instance as specified by format.

Wyjątki

format jest nieprawidłowy.format is invalid.

Przykłady

Poniższy przykład wyświetla Decimal wartość przy użyciu każdego z obsługiwanych standardowych specyfikatorów formatu liczbowego wraz z dwoma niestandardowymi ciągami formatu liczb.The following example displays a Decimal value using each of the supported standard numeric format specifiers, together with two custom numeric format strings. W celu przeliczenia wartości liczbowych na ciągi w przykładzie użyto konwencji formatowania kultury en-US.In converting the numeric values to strings, the example uses the formatting conventions of the en-US culture.

decimal value = 16325.62m;
string specifier;

// Use standard numeric format specifiers.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: 16325.62
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: $16,325.62
specifier = "E04";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E04: 1.6326E+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: 16325.62
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: 16,325.62
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier));
// Displays:    P: 163.26 %

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: 16,325.620
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): (16,325.62)
Dim value As Decimal = 16325.62d
Dim specifier As String

' Use standard numeric format specifiers.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    G: 16325.62
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    C: $16,325.62
specifier = "E04"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    E04: 1.6326E+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    F: 16325.62
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    N: 16,325.62
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier))
' Displays:    P: 163.26 %

' Use custom numeric format specifiers.
specifier = "0,0.000"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    0,0.000: 16,325.620
specifier = "#,#.00#;(#,#.00#)"
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier))
' Displays:    #,#.00#;(#,#.00#): (16,325.62)

Uwagi

ToString(String)Metoda formatuje Decimal wartość w określonym formacie przy użyciu Konwencji bieżącej kultury.The ToString(String) method formats a Decimal value in a specified format by using the conventions of the current culture. Jeśli chcesz użyć domyślnego formatu ("G" lub ogólnego) lub określić inną kulturę, użyj innych przeciążeń ToString metody w następujący sposób: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:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Domyślna kultura (bieżąca)Default (current) culture ToString()
Domyślny format ("G")Default ("G") format Określona kulturaA specific culture ToString(IFormatProvider)
Określony formatA specific format Określona kulturaA specific culture ToString(String, IFormatProvider)

ToStringMetoda używa standardowego lub niestandardowego ciągu formatu liczbowego określonego przez parametr, format Aby przekonwertować wartość bieżącego wystąpienia na jego reprezentację w postaci ciągu.The ToString method uses the standard or custom numeric format string specified by the format parameter to convert the value of the current instance into its string representation. formatParametr może być dowolnym prawidłowym standardowym specyfikatorem formatu liczbowego z wyjątkiem D, R i X, a także dowolną kombinacją niestandardowych specyfikatorów formatu liczbowego.The format parameter can be any valid standard numeric format specifier except for D, R, and X, as well as any combination of custom numeric format specifiers. Jeśli format jest null lub jest pustym ciągiem, wartość zwracana tego wystąpienia jest formatowana przy użyciu ogólnego specyfikatora formatu liczbowego (G).If format is null or an empty string, the return value of this instance is formatted with the general numeric format specifier (G).

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która jest bardziej szczegółowym opisem w następujących tematach:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Wartość zwracana jest formatowana przy użyciu NumberFormatInfo obiektu dla bieżącej kultury.The return value is formatted by using the NumberFormatInfo object for the current culture. Aby zastosować konwencje formatowania określonej kultury, wywołaj ToString(String, IFormatProvider) metodę.To apply the formatting conventions of a specified culture, call the ToString(String, IFormatProvider) method.

Zobacz też

Dotyczy

ToString()

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację w postaci ciągu.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

Zwraca

String

Ciąg, który reprezentuje wartość tego wystąpienia.A string that represents the value of this instance.

Przykłady

Poniższy przykład wyświetla Decimal wartość przy użyciu ToString() metody domyślnej.The following example displays a Decimal value using the default ToString() method. Wyświetla również reprezentacje ciągów Decimal wartości, których wynikiem jest użycie kilku specyfikatorów formatu standardowego.It also displays the string representations of the Decimal value that result from using a number of standard format specifiers.

decimal value = -16325.62m;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325.62
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325.62
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.62)
Console.WriteLine(value.ToString("F"));         // Displays -16325.62
Dim value As Decimal = -16325.62d
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325.62
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325.62
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325.62)
Console.WriteLine(value.ToString("F"))         ' Displays -16325.62      

Poniższy przykład przedstawia ilość pieniędzy w ramach konta.The following example displays the amount of money in an account.

   public ref class PiggyBank
   {
   public:
      void AddPenny()
      {
         MyFortune = Decimal::Add( MyFortune, (Decimal).01 );
      }

      virtual System::String^ ToString() override
      {
         return MyFortune.ToString("C")+" in piggy bank";
      }

   protected:
      Decimal MyFortune;
   };
}
class PiggyBank {
    public void AddPenny() {
        MyFortune = Decimal.Add(MyFortune, .01m);
    }

    public override string ToString() {
        return MyFortune.ToString("C")+" in piggy bank";
    }

    protected decimal MyFortune;
}
Class PiggyBank

    Public Sub AddPenny()
        MyFortune = [Decimal].Add(MyFortune, 0.01D)
    End Sub

    Public Overrides Function ToString() As String
        Return MyFortune.ToString("C") + " in piggy bank"
    End Function

    Protected MyFortune As Decimal
End Class

Uwagi

ToString()Metoda formatuje Decimal wartość w formacie domyślnym ("G" lub ogólnym) bieżącej kultury.The ToString() method formats a Decimal value in the default ("G", or general) format of the current culture. Jeśli chcesz określić inny format lub kulturę, użyj innych przeciążeń ToString metody w następujący sposób:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Aby użyć formatuTo use format Dla kulturyFor culture Użyj przeciążeniaUse the overload
Domyślny format ("G")Default ("G") format Określona kulturaA specific culture ToString(IFormatProvider)
Określony formatA specific format Domyślna kultura (bieżąca)Default (current) culture ToString(String)
Określony formatA specific format Określona kulturaA specific culture ToString(String, IFormatProvider)

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która jest bardziej szczegółowym opisem w następujących tematach:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Zobacz też

Dotyczy