Int64.ToString Metoda

Definicja

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu.

Przeciążenia

ToString(IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonych informacji o formacie specyficznym dla kultury.

ToString()

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu.

ToString(String)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu.

ToString(String, IFormatProvider)

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu i informacji o formacie specyficznym dla kultury.

ToString(IFormatProvider)

Źródło:
Int64.cs
Źródło:
Int64.cs
Źródło:
Int64.cs

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonych informacji o formacie specyficznym dla kultury.

public string ToString (IFormatProvider provider);
public string ToString (IFormatProvider? provider);

Parametry

provider
IFormatProvider

IFormatProvider, który dostarcza informacje o formatowaniu specyficznym dla kultury.

Zwraca

Ciąg reprezentujący wartość tego wystąpienia zgodnie z provider.

Implementuje

Przykłady

W poniższym przykładzie przedstawiono reprezentację ciągu wartości Int64 przy użyciu obiektów CultureInfo reprezentujących kilka różnych kultur.

long value = -16325901;
// 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:
//       -16325901
//       -16325901
//       -16325901

Uwagi

Metoda ToString(IFormatProvider) formatuje wartość Int64 w domyślnym formacie ("G" lub ogólnym) przy użyciu obiektu NumberFormatInfo określonej kultury. Jeśli chcesz określić inny format lub bieżącą kulturę, użyj innych przeciążeń metody ToString w następujący sposób:

Aby użyć formatu Dla kultury Używanie przeciążenia
Domyślny format ("G") Domyślna (bieżąca) kultura ToString()
Określony format Domyślna (bieżąca) kultura ToString(String)
Określony format Określona kultura ToString(String, IFormatProvider)

Parametr provider to obiekt, który implementuje interfejs IFormatProvider. Metoda GetFormat zwraca obiekt NumberFormatInfo, który udostępnia informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę. Obiekt implementujący IFormatProvider może być dowolnym z następujących elementów:

  • Obiekt CultureInfo reprezentujący kulturę, której mają być używane reguły formatowania.

  • Obiekt NumberFormatInfo zawierający określone informacje o formatowaniu liczbowym dla tej wartości.

  • Obiekt niestandardowy, który implementuje IFormatProvider i którego metoda GetFormat zwraca obiekt NumberFormatInfo, który udostępnia informacje o formatowaniu.

Jeśli provider jest null lub nie można uzyskać obiektu NumberFormatInfo z provider, wartość zwracana jest sformatowana za pomocą obiektu NumberFormatInfo dla bieżącej kultury.

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString()

Źródło:
Int64.cs
Źródło:
Int64.cs
Źródło:
Int64.cs

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu.

public override string ToString ();

Zwraca

Ciąg reprezentujący wartość tego wystąpienia, składający się z znaku minus, jeśli wartość jest ujemna, a sekwencja cyfr z zakresu od 0 do 9 bez zer wiodących.

Przykłady

Poniższy przykład przedstawia wartość Int64 przy użyciu domyślnej metody ToString(). Wyświetla również reprezentacje ciągów Int64 wartości, która wynika z używania wielu specyfikatorów formatu standardowego. Przykłady są wyświetlane przy użyciu konwencji formatowania kultury en-US.

long value = -16325091;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325091
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325091
Console.WriteLine(value.ToString("C"));         // Displays ($16,325,091.00)
Console.WriteLine(value.ToString("D"));         // Displays -16325091
Console.WriteLine(value.ToString("F"));         // Displays -16325091.00
Console.WriteLine(value.ToString("N"));         // Displays -16,325,091.00
Console.WriteLine(value.ToString("N0"));         // Displays -16,325,091
Console.WriteLine(value.ToString("X"));         // Displays FFFFFFFFFF06E61D

Uwagi

Metoda ToString() formatuje wartość Int64 w domyślnym formacie ("G" lub ogólnym) przy użyciu obiektu NumberFormatInfo bieżącej kultury. Jeśli chcesz określić inny format lub kulturę, użyj innych przeciążeń metody ToString w następujący sposób:

Aby użyć formatu Dla kultury Używanie przeciążenia
Domyślny format ("G") Określona kultura ToString(IFormatProvider)
Określony format Domyślna (bieżąca) kultura ToString(String)
Określony format Określona kultura ToString(String, IFormatProvider)

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String)

Źródło:
Int64.cs
Źródło:
Int64.cs
Źródło:
Int64.cs

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu.

public string ToString (string format);
public string ToString (string? format);

Parametry

format
String

Ciąg formatu liczbowego.

Zwraca

Ciąg reprezentujący wartość tego wystąpienia zgodnie z format.

Wyjątki

format jest nieprawidłowa lub nie jest obsługiwana.

Przykłady

Poniższy przykład przedstawia wartość Int64 przy użyciu każdego z obsługiwanych standardowych specyfikatorów formatu liczbowego wraz z dwoma niestandardowymi ciągami formatu liczbowego. W konwertowaniu wartości liczbowych na ciągi przykład używa konwencji formatowania kultury en-US.

long value = -16325;
string specifier;

// Use standard numeric format specifier.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: -16325
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: ($16,325.00)
specifier = "D8";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    D8: -00016325
specifier = "E4";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E4: -1.6325E+004
specifier = "e3";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    e3: -1.633e+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: -16325.00
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: -16,325.00
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/100000.0).ToString(specifier));
// Displays:    P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    X: FFFFFFFFFFFFC03B

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

Uwagi

Metoda ToString(String) formatuje wartość Int64 w określonym formacie przy użyciu obiektu NumberFormatInfo reprezentującego konwencje bieżącej kultury. Jeśli chcesz użyć domyślnego formatu ("G" lub ogólnego) lub określić inną kulturę, użyj innych przeciążeń metody ToString w następujący sposób:

Aby użyć formatu Dla kultury Używanie przeciążenia
Domyślny format ("G") Domyślna (bieżąca) kultura ToString()
Domyślny format ("G") Określona kultura ToString(IFormatProvider)
Określony format Określona kultura ToString(String, IFormatProvider)

Parametr format może być dowolnym prawidłowym standardowym specyfikatorem formatu liczbowego z wyjątkiem "R", a także dowolnej kombinacji niestandardowych specyfikatorów formatu liczbowego. Jeśli format jest null lub pusty ciąg (""), zwracana wartość tego wystąpienia jest formatowana przy użyciu ogólnego specyfikatora formatu liczbowego ("G").

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

Wartość zwracana tego wystąpienia jest formatowana przy użyciu NumberFormatInfo dla bieżącej kultury.

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToString(String, IFormatProvider)

Źródło:
Int64.cs
Źródło:
Int64.cs
Źródło:
Int64.cs

Konwertuje wartość liczbową tego wystąpienia na równoważną reprezentację ciągu przy użyciu określonego formatu i informacji o formacie specyficznym dla kultury.

public string ToString (string format, IFormatProvider provider);
public string ToString (string? format, IFormatProvider? provider);

Parametry

format
String

Ciąg formatu liczbowego.

provider
IFormatProvider

Obiekt, który dostarcza informacje o formatowaniu specyficznym dla kultury dotyczące tego wystąpienia.

Zwraca

Ciąg reprezentacja wartości tego wystąpienia określona przez format i provider.

Implementuje

Wyjątki

format jest nieprawidłowa lub nie jest obsługiwana.

Przykłady

W poniższym przykładzie jest wyświetlana wartość dodatnia i ujemna przy użyciu każdego z obsługiwanych standardowych specyfikatorów formatu liczbowego dla trzech różnych kultur.

// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"),
                          CultureInfo.CreateSpecificCulture("fr-FR"),
                          CultureInfo.CreateSpecificCulture("es-ES") };
long positiveNumber = 1679;
long negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "N0", "P", "X8"};

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",
                        specifier, culture.Name,
                        positiveNumber.ToString(specifier, culture),
                        negativeNumber.ToString(specifier, culture));
   }
   Console.WriteLine();
}
// The example displays the following output to the console:
//    G format using en-US culture:             1679            -3045
//    G format using fr-FR culture:             1679            -3045
//    G format using es-ES culture:             1679            -3045
//
//    C format using en-US culture:        $1,679.00      ($3,045.00)
//    C format using fr-FR culture:       1 679,00 €      -3 045,00 €
//    C format using es-ES culture:       1.679,00 €      -3.045,00 €
//
//    D8 format using en-US culture:         00001679        -00003045
//    D8 format using fr-FR culture:         00001679        -00003045
//    D8 format using es-ES culture:         00001679        -00003045
//
//    E2 format using en-US culture:        1.68E+003       -3.05E+003
//    E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//    E2 format using es-ES culture:        1,68E+003       -3,05E+003
//
//    F format using en-US culture:          1679.00         -3045.00
//    F format using fr-FR culture:          1679,00         -3045,00
//    F format using es-ES culture:          1679,00         -3045,00
//
//    N format using en-US culture:         1,679.00        -3,045.00
//    N format using fr-FR culture:         1 679,00        -3 045,00
//    N format using es-ES culture:         1.679,00        -3.045,00
//
//    N0 format using en-US culture:         1,679           -3,045
//    N0 format using fr-FR culture:         1 679           -3 045
//    N0 format using es-ES culture:         1.679           -3.045
//
//    P format using en-US culture:      167,900.00%     -304,500.00%
//    P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//    P format using es-ES culture:     167.900,00 %    -304.500,00 %
//
//    X8 format using en-US culture:         0000068F FFFFFFFFFFFFF41B
//    X8 format using fr-FR culture:         0000068F FFFFFFFFFFFFF41B
//    X8 format using es-ES culture:         0000068F FFFFFFFFFFFFF41B

Uwagi

Metoda ToString(String, IFormatProvider) formatuje wartość Int64 w określonym formacie przy użyciu obiektu NumberFormatInfo określonej kultury. Jeśli chcesz użyć domyślnych ustawień formatu lub kultury, użyj innych przeciążeń metody ToString w następujący sposób:

Aby użyć formatu Dla kultury Używanie przeciążenia
Domyślny format ("G") Domyślna (bieżąca) kultura ToString()
Domyślny format ("G") Określona kultura ToString(IFormatProvider)
Określony format Domyślna (bieżąca) kultura ToString(String)

Parametr format może być standardowym lub niestandardowym ciągiem formatu liczbowego. Obsługiwane są wszystkie standardowe ciągi formatu liczbowego inne niż "R" (lub "r"), podobnie jak wszystkie niestandardowe znaki formatu liczbowego. Jeśli format jest null lub pusty ciąg (""), wartość zwracana dla tego wystąpienia jest formatowana przy użyciu ogólnego specyfikatora formatu liczbowego ("G").

Parametr provider to obiekt, który implementuje interfejs IFormatProvider. Metoda GetFormat zwraca obiekt NumberFormatInfo, który udostępnia informacje specyficzne dla kultury dotyczące formatu ciągu zwracanego przez tę metodę. Obiekt implementujący IFormatProvider może być dowolnym z następujących elementów:

  • Obiekt CultureInfo reprezentujący kulturę, której mają być używane reguły formatowania.

  • Obiekt NumberFormatInfo zawierający określone informacje o formatowaniu liczbowym dla tej wartości.

  • Obiekt niestandardowy, który implementuje IFormatProvider i którego metoda GetFormat zwraca obiekt NumberFormatInfo, który udostępnia informacje o formatowaniu.

Jeśli provider jest null lub nie można uzyskać obiektu NumberFormatInfo z provider, wartość zwracana dla tego wystąpienia jest sformatowana przy użyciu NumberFormatInfo dla bieżącej kultury.

Platforma .NET zapewnia rozbudowaną obsługę formatowania, która została szczegółowo opisana w następujących tematach formatowania:

Zobacz też

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0