Int32.ToString Yöntem

Tanım

Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.Converts the numeric value of this instance to its equivalent string representation.

Aşırı Yüklemeler

ToString(IFormatProvider)

Bu örneğin sayısal değerini belirtilen kültüre özgü biçim bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider)

Bu örneğin sayısal değerini belirtilen biçim ve kültüre özgü biçim bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String)

Bu örneğin sayısal değerini, belirtilen biçimi kullanarak eşdeğer dize gösterimine dönüştürür.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString()

Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

Bu örneğin sayısal değerini belirtilen kültüre özgü biçim bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.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

Parametreler

provider
IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan nesne.An object that supplies culture-specific formatting information.

Döndürülenler

String

Tarafından belirtilen bu örneğin değerinin dize temsili provider .The string representation of the value of this instance as specified by provider.

Uygulamalar

Örnekler

Aşağıdaki örnek, Int32 CultureInfo birkaç farklı kültürü temsil eden nesneleri kullanarak bir değerin dize gösterimini görüntüler.The following example displays the string representation of an Int32 value using CultureInfo objects that represent several different cultures.

using namespace System;
using namespace System::Globalization;

void main()
{
    int value = -16325;
    // 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")));
}
// The example displays the following output:
//       -16325
//       -16325
//       -16325
int value = -16325;
// 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
//       -16325
//       -16325
Dim value As Integer = -16325
' 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
'       -16325
'       -16325

Açıklamalar

ToString(IFormatProvider)Yöntemi, Int32 NumberFormatInfo belirtilen bir kültürün nesnesini kullanarak varsayılan ("G" veya genel) biçimindeki bir değeri biçimlendirir.The ToString(IFormatProvider) method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Farklı bir biçim veya geçerli kültür belirtmek istiyorsanız, yönteminin diğer aşırı yüklerini ToString aşağıdaki gibi kullanın:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Biçim kullanmak içinTo use format Kültür içinFor culture Aşırı yüklemeyi kullanmaUse the overload
Varsayılan ("G") biçimiDefault ("G") format Varsayılan (geçerli) kültürDefault (current) culture ToString()
Belirli bir biçimA specific format Varsayılan (geçerli) kültürDefault (current) culture ToString(String)
Belirli bir biçimA specific format Belirli bir kültürA specific culture ToString(String, IFormatProvider)

providerParametresi, arabirimini uygulayan bir nesnedir IFormatProvider .The provider parameter is an object that implements the IFormatProvider interface. GetFormatYöntemi, NumberFormatInfo Bu yöntemin döndürdüğü dizenin biçimi hakkında kültüre özgü bilgiler sağlayan bir nesne döndürür.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. Uygulayan nesne, IFormatProvider aşağıdakilerden herhangi biri olabilir:The object that implements IFormatProvider can be any of the following:

provider null Ya da bir NumberFormatInfo nesne öğesinden elde edilemeirse provider , dönüş değeri NumberFormatInfo iş parçacığı geçerli kültürünün nesnesi kullanılarak biçimlendirilir.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. İş parçacığı geçerli kültürü hakkında daha fazla bilgi için bkz Thread.CurrentCulture ..For information about the thread current culture, see Thread.CurrentCulture.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Ayrıca bkz.

Şunlara uygulanır

ToString(String, IFormatProvider)

Bu örneğin sayısal değerini belirtilen biçim ve kültüre özgü biçim bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.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

Parametreler

format
String

Standart veya özel sayısal biçim dizesi.A standard or custom numeric format string.

provider
IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan nesne.An object that supplies culture-specific formatting information.

Döndürülenler

String

Ve tarafından belirtildiği gibi bu örneğin değerinin dize temsili format provider .The string representation of the value of this instance as specified by format and provider.

Uygulamalar

Özel durumlar

format geçersiz veya desteklenmiyor.format is invalid or not supported.

Örnekler

Aşağıdaki örnek, üç farklı kültürde desteklenen standart sayısal biçim Belirticilerinin her birini kullanarak pozitif ve negatif bir değer görüntüler.The following example displays a positive and a negative value using each of the supported standard numeric format specifiers for three different cultures.

using namespace System;
using namespace System::Globalization;

void main()
{
    // Define cultures whose formatting conventions are to be used.
    array<CultureInfo^>^ cultures = { CultureInfo::CreateSpecificCulture("en-US"), 
                                      CultureInfo::CreateSpecificCulture("fr-FR"), 
                                      CultureInfo::CreateSpecificCulture("es-ES") };
    int positiveNumber = 1679;
    int negativeNumber = -3045;
    array<String^>^ specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}; 
    
    for each (String^ specifier in specifiers)
    {
       for each (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:
//       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
//       
//       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         FFFFF41B
//       X8 format using fr-FR culture:         0000068F         FFFFF41B
//       X8 format using es-ES culture:         0000068F         FFFFF41B
// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"),
                          CultureInfo.CreateSpecificCulture("fr-FR"),
                          CultureInfo.CreateSpecificCulture("es-ES") };
int positiveNumber = 1679;
int negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "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:
//       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
//
//       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         FFFFF41B
//       X8 format using fr-FR culture:         0000068F         FFFFF41B
//       X8 format using es-ES culture:         0000068F         FFFFF41B
' 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 positiveNumber As Integer = 1679
Dim negativeNumber As Integer = -3045
Dim specifiers() As String = {"G", "C", "D8", "E2", "F", "N", "P", "X8"} 

For Each specifier As String In specifiers
   For Each culture As CultureInfo 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))

   Next
   Console.WriteLine()
Next
' 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
'       
'       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         FFFFF41B
'       X8 format using fr-FR culture:         0000068F         FFFFF41B
'       X8 format using es-ES culture:         0000068F         FFFFF41B

Açıklamalar

Yöntemi belirtilen bir ToString(String, IFormatProvider) Int32 kültürün nesnesini kullanarak belirtilen biçimdeki bir değeri biçimlendirir NumberFormatInfo .The ToString(String, IFormatProvider) method formats an Int32 value in a specified format by using the NumberFormatInfo object of a specified culture. Varsayılan biçim veya kültür ayarlarını kullanmak istiyorsanız, aşağıdaki gibi, yönteminin diğer aşırı yüklerini kullanın ToString :If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Biçim kullanmak içinTo use format Kültür içinFor culture Aşırı yüklemeyi kullanmaUse the overload
Varsayılan ("G") biçimiDefault ("G") format Varsayılan (geçerli) kültürDefault (current) culture ToString()
Varsayılan ("G") biçimiDefault ("G") format Belirli bir kültürA specific culture ToString(IFormatProvider)
Belirli bir biçimA specific format Varsayılan (geçerli) kültürDefault (current) culture ToString(String)

formatParametresi bir standart ya da özel sayısal biçim dizesi olabilir.The format parameter can be either a standard or a custom numeric format string. Tüm özel sayısal biçim karakterleri gibi, "R" (veya "r") dışındaki tüm standart sayısal biçim dizeleri desteklenir.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. format null Ya da boş bir dize ("") ise, bu örnek için dönüş değeri genel sayısal biçim Belirleyicisi ("G") ile biçimlendirilir.If format is null or an empty string (""), the return value for this instance is formatted with the general numeric format specifier ("G").

providerParametresi, arabirimini uygulayan bir nesnedir IFormatProvider .The provider parameter is an object that implements the IFormatProvider interface. GetFormatYöntemi, NumberFormatInfo Bu yöntemin döndürdüğü dizenin biçimi hakkında kültüre özgü biçim bilgisi sağlayan bir nesne döndürür.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific format information about the format of the string that is returned by this method. Uygulayan nesne, IFormatProvider aşağıdakilerden herhangi biri olabilir:The object that implements IFormatProvider can be any of the following:

providerYa da null bir NumberFormatInfo nesne öğesinden elde edilemeirse provider , bu örnek için dönüş değeri NumberFormatInfo geçerli kültür için ile biçimlendirilir.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value for this instance is formatted with the NumberFormatInfo for the current culture.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Ayrıca bkz.

Şunlara uygulanır

ToString(String)

Bu örneğin sayısal değerini, belirtilen biçimi kullanarak eşdeğer dize gösterimine dönüştürür.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

Parametreler

format
String

Standart veya özel sayısal biçim dizesi.A standard or custom numeric format string.

Döndürülenler

String

Tarafından belirtilen bu örneğin değerinin dize temsili format .The string representation of the value of this instance as specified by format.

Özel durumlar

format geçersiz veya desteklenmiyor.format is invalid or not supported.

Örnekler

Aşağıdaki örnek Int32 , desteklenen standart sayısal biçim Belirticilerinin her birini kullanan bir değeri, iki özel sayısal biçim dizesi ile birlikte görüntüler.The following example displays an Int32 value using each of the supported standard numeric format specifiers, together with two custom numeric format strings. Örnek, sayısal değerleri dizelere dönüştürmek için İngilizce (ABD) kültürünün biçimlendirme kurallarını kullanır.In converting the numeric values to strings, the example uses the formatting conventions of the en-US culture.

using namespace System;

void main()
{
    int value = -16325;
    String^ specifier;
    
    // Use standard numeric format specifiers.
    specifier = "G";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "C";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "D8";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "E4";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "e3";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "F";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "N";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "P";
    Console::WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier));

    specifier = "X";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
    
    // Use custom numeric format specifiers.
    specifier = "0,0.000";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "#,#.00#;(#,#.00#)";
    Console::WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
}   
// The example displays the following output:
//     G: -16325
//     C: ($16,325.00)
//     D8: -00016325
//     E4: -1.6325E+004
//     e3: -1.633e+004
//     F: -16325.00
//     N: -16,325.00
//     P: 0.00 %
//     X: FFFFC03B
//     0,0.000: -16,325.000
//     #,#.00#;(#,#.00#): 16,325.00
int 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).ToString(specifier));
// Displays:    P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    X: FFFFC03B

// 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
Dim value As Integer = -16325
Dim specifier As String

' 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).ToString(specifier))
' Displays:    P: -16.33 %
specifier = "X"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    X: FFFFC03B 

' 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

Açıklamalar

ToString(String)Yöntemi, Int32 NumberFormatInfo geçerli kültürün kurallarını temsil eden bir nesneyi kullanarak belirtilen biçimdeki bir değeri biçimlendirir.The ToString(String) method formats an Int32 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Varsayılan ("G", ya da genel) biçimini kullanmak veya farklı bir kültür belirtmek istiyorsanız, yönteminin diğer aşırı yüklerini ToString aşağıdaki gibi kullanın: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:

Biçim kullanmak içinTo use format Kültür içinFor culture Aşırı yüklemeyi kullanmaUse the overload
Varsayılan ("G") biçimiDefault ("G") format Varsayılan (geçerli) kültürDefault (current) culture ToString()
Varsayılan ("G") biçimiDefault ("G") format Belirli bir kültürA specific culture ToString(IFormatProvider)
Belirli bir biçimA specific format Belirli bir kültürA specific culture ToString(String, IFormatProvider)

formatParametresi, "R" hariç herhangi bir geçerli standart sayısal biçim belirticisi ve özel sayısal biçim Belirticilerinin herhangi bir birleşimini içerebilir.The format parameter can be any valid standard numeric format specifier except for "R", as well as any combination of custom numeric format specifiers. format null Ya da boş bir dize ("") ise, bu örneğin dönüş değeri genel sayısal biçim Belirleyicisi ("G") ile biçimlendirilir.If format is null or an empty string (""), the return value of this instance is formatted with the general numeric format specifier ("G").

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Bu örneğin dönüş değeri, NumberFormatInfo geçerli kültür için ile biçimlendirilir.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Ayrıca bkz.

Şunlara uygulanır

ToString()

Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.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

Döndürülenler

String

Değer negatifse negatif bir işaretinden ve önünde sıfır olmadan 0 ile 9 arasında değişen bir basamak dizisi olan bu örneğin değerinin dize temsili.The string representation of the value of this instance, consisting of a negative sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

Örnekler

Aşağıdaki örnek, Int32 varsayılan yöntemi kullanarak bir değeri gösterir ToString() .The following example displays an Int32 value using the default ToString() method. Ayrıca, Int32 bir dizi standart biçim belirticisinden elde edilen değerin dize temsillerini görüntüler.It also displays the string representations of the Int32 value that results from using a number of standard format specifiers. Örnekler, İngilizce (ABD) kültürünün biçimlendirme kurallarını kullanarak görüntülenir.The examples are displayed using the formatting conventions of the en-US culture.

using namespace System;

void main()
{
    int value = -16325;
    // Display value using default ToString method.
    Console::WriteLine(value.ToString());             
    // Display value using some standard format specifiers.
    Console::WriteLine(value.ToString("G"));         
    Console::WriteLine(value.ToString("C"));         
    Console::WriteLine(value.ToString("D"));         
    Console::WriteLine(value.ToString("F"));         
    Console::WriteLine(value.ToString("N"));         
    Console::WriteLine(value.ToString("X"));              
}
// The example displays the following output:
//     -16325
//     -16325
//     ($16,325.00)
//     -16325
//     -16325.00
//     -16,325.00
//     FFFFC03B
int value = -16325;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.00)
Console.WriteLine(value.ToString("D"));         // Displays -16325
Console.WriteLine(value.ToString("F"));         // Displays -16325.00
Console.WriteLine(value.ToString("N"));         // Displays -16,325.00
Console.WriteLine(value.ToString("X"));         // Displays FFFFC03B
Dim value As Integer = -16325
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325.00)
Console.WriteLine(value.ToString("D"))         ' Displays -16325
Console.WriteLine(value.ToString("F"))         ' Displays -16325.00
Console.WriteLine(value.ToString("N"))         ' Displays -16,325.00
Console.WriteLine(value.ToString("X"))         ' Displays FFFFC03B      

Açıklamalar

ToString()Yöntemi, Int32 geçerli kültürün nesnesini kullanarak varsayılan ("G" veya genel) biçimindeki bir değeri biçimlendirir NumberFormatInfo .The ToString() method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Farklı bir biçim veya kültür belirtmek istiyorsanız, yönteminin diğer aşırı yüklerini ToString aşağıdaki gibi kullanın:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Biçim kullanmak içinTo use format Kültür içinFor culture Aşırı yüklemeyi kullanmaUse the overload
Varsayılan ("G") biçimiDefault ("G") format Belirli bir kültürA specific culture ToString(IFormatProvider)
Belirli bir biçimA specific format Varsayılan (geçerli) kültürDefault (current) culture ToString(String)
Belirli bir biçimA specific format Belirli bir kültürA specific culture ToString(String, IFormatProvider)

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:.NET provides extensive formatting support, which is described in greater detail in the following formatting topics:

Ayrıca bkz.

Şunlara uygulanır