Single.ToString Yöntem

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kodlar:: mscorlib.dll, System.Runtime.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Runtime.dll

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.

Aşırı Yüklemeler

Name	Description
ToString()	Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.
ToString(IFormatProvider)	Belirtilen kültüre özgü biçim bilgilerini kullanarak bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.
ToString(String)	Belirtilen biçimi kullanarak bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.
ToString(String, IFormatProvider)	Belirtilen biçim ve kültüre özgü biçim bilgilerini kullanarak bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.

ToString()

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.

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

Bu örneğin değerinin dize gösterimi.

Örnekler

Aşağıdaki örnek, bir dizi Single.ToString değerin dize gösterimlerini görüntülemek için varsayılan Single yöntemi kullanır.

float number;

number = 1.6E20F;
// Displays 1.6E+20.
Console.WriteLine(number.ToString());

number = 1.6E2F;
// Displays 160.
Console.WriteLine(number.ToString());

number = -3.541F;
// Displays -3.541.
Console.WriteLine(number.ToString());

number = -1502345222199E-07F;
// Displays -150234.5222199.
Console.WriteLine(number.ToString());

number = -15023452221990199574E-09F;
// Displays -15023452221.9902.
Console.WriteLine(number.ToString());

number = .60344F;
// Displays 0.60344.
Console.WriteLine(number.ToString());

number = .000000001F;
// Displays 1E-09.
Console.WriteLine(number.ToString());

let number = 1.6E20F
// Displays 1.6E+20.
printfn $"{number.ToString()}"

let number = 1.6E2F
// Displays 160.
printfn $"{number.ToString()}"

let number = -3.541F
// Displays -3.541.
printfn $"{number.ToString()}"

let number = -1502345222199E-07F
// Displays -150234.5222199.
printfn $"{number.ToString()}"

let number = -15023452221990199574E-09F
// Displays -15023452221.9902.
printfn $"{number.ToString()}"

let number = 0.60344F
// Displays 0.60344.
printfn $"{number.ToString()}"

let number = 0.000000001F
// Displays 1E-09.
printfn $"{number.ToString()}"

Dim number As Single

number = 1.6E20
' Displays 1.6E+20.      
Console.WriteLine(number.ToString())

number = 1.6E2
' Displays 160.
Console.WriteLine(number.ToString())

number = -3.541
' Displays -3.541.
Console.WriteLine(number.ToString())

number = -1502345222199E-07
' Displays -150234.5222199.
Console.WriteLine(number.ToString())

number = -15023452221990199574E-09
' Displays -15023452221.9902.
Console.WriteLine(number.ToString())

number = .60344
' Displays 0.60344.
Console.WriteLine(number.ToString())

number = .000000001
' Displays 1E-09.
Console.WriteLine(number.ToString())

Aşağıdaki kod örneği, yöntemiyle Parse(String) birlikte yönteminin ToString() kullanımını gösterir.

bool done = false;
string inp;
do
{
    Console.Write("Enter a real number: ");
    inp = Console.ReadLine();
    try
    {
        s = Single.Parse(inp);
        Console.WriteLine("You entered {0}.", s.ToString());
        done = true;
    }
    catch (FormatException)
    {
        Console.WriteLine("You did not enter a number.");
    }
    catch (Exception e)
    {
        Console.WriteLine("An exception occurred while parsing your response: {0}", e.ToString());
    }
} while (!done);

let mutable finished = false
while not finished do
    printf "Enter a real number: "
    let inp = stdin.ReadLine()
    try
        let s = Single.Parse inp
        printfn $"You entered {s}."
        finished <- true
    with 
    | :? FormatException ->
        printfn "You did not enter a number."
    | e ->
        printfn "An exception occurred while parsing your response: {e}"

Dim Done As Boolean = False
Dim Inp As String
Do

    Console.Write("Enter a real number: ")
    Inp = Console.ReadLine()
    Try
        S = Single.Parse(Inp)
        Console.WriteLine("You entered " + S.ToString() + ".")
        Done = True
    Catch E As FormatException
        Console.WriteLine("You did not enter a number.")
    Catch E As Exception
        Console.WriteLine("An exception occurred while parsing your response: " + E.ToString())
    End Try
Loop While Not Done

Açıklamalar

yöntemi, ToString() bir Single değeri geçerli kültürün varsayılan ("G" veya genel) biçiminde biçimlendirir. Farklı bir biçim veya kültür belirtmek istiyorsanız yönteminin diğer aşırı yüklemelerini ToString aşağıdaki gibi kullanın:

Biçimi kullanmak için	Kültür için	Aşırı yüklemeyi kullanma
Varsayılan ("G") biçimi	Belirli bir kültür	ToString(IFormatProvider)
Belirli bir biçim	Varsayılan (geçerli) kültür	ToString(String)
Belirli bir biçim	Belirli bir kültür	ToString(String, IFormatProvider)

Dönüş değeri , , PositiveInfinitySymbol NegativeInfinitySymbolveya formun bir dizesi olabilirNaNSymbol:

[sign]integral-digits[.[ kesirli basamaklar]][e[sign]üstel basamaklar]

İsteğe bağlı öğeler köşeli ayraç içine alınır ([ ve ]). "Basamaklar" terimini içeren öğeler, 0 ile 9 arasında bir dizi sayısal karakterden oluşur. Aşağıdaki tabloda her öğe listelenir:

Öğe	Açıklama
imza	Negatif işaret veya pozitif işaret simgesi.
integral-digits	Sayının tamsayı kısmını belirten bir basamak serisi. Kesirli basamaklar varsa tam sayı-basamaklar eksik olabilir.
'.'	Kültüre özgü ondalık nokta simgesi.
kesirli basamaklar	Sayının kesirli kısmını belirten bir basamak dizisi.
'e'	Üstel (bilimsel) gösterimi gösteren küçük harfli 'e' karakteri.
üstel basamaklar	Üs belirten bir dizi basamak.

Döndürülen değere örnek olarak "100", "-123,456,789", "123,45e+6", "500", "3,1416", "600", "-0,123" ve "-Infinity" verilebilir.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:

Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.
Biçimlendirme hakkında daha fazla bilgi için bkz. Biçimlendirme Türleri.

Ayrıca bkz.

Parse(String)
String
.NET'da Biçimlendirme Türleri

Şunlara uygulanır

ToString(IFormatProvider)

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Belirtilen kültüre özgü biçim bilgilerini kullanarak bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.

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 bir nesne.

Döndürülenler

String

tarafından providerbelirtilen bu örneğin değerinin dize gösterimi.

Uygulamalar

ToString(IFormatProvider)

Örnekler

Aşağıdaki örnek, birkaç farklı kültürü temsil eden nesneleri kullanarak Single iki CultureInfo değerin dize gösterimini görüntüler.

float value;

value = -16325.62015F;
// 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")));

value = 16034.125E21F;
// 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.62015
//       -16325.62015
//       -16325,62015
//       1.6034125E+25
//       1.6034125E+25
//       1,6034125E+25

let value = -16325.62015F
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""

let value = 16034.125E21F
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""
// This example displays the following output to the console:
//       -16325.62015
//       -16325.62015
//       -16325,62015
//       1.6034125E+25
//       1.6034125E+25
//       1,6034125E+25

Dim value As Single 

value = -16325.62015
' 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")))

value = 16034.125E21
' 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.62015
'       -16325.62015
'       -16325,62015
'       1.6034125E+25
'       1.6034125E+25
'       1,6034125E+25

Açıklamalar

yöntemi, ToString(IFormatProvider) bir Single değeri belirtilen kültürün varsayılan ("G" veya genel) biçiminde biçimlendirir. Farklı bir biçim veya geçerli kültür belirtmek istiyorsanız yönteminin diğer aşırı yüklemelerini ToString aşağıdaki gibi kullanın:

Biçimi kullanmak için	Kültür için	Aşırı yüklemeyi kullanma
Varsayılan ("G") biçimi	Varsayılan (geçerli) kültür	ToString()
Belirli bir biçim	Varsayılan (geçerli) kültür	ToString(String)
Belirli bir biçim	Belirli bir kültür	ToString(String, IFormatProvider)

Dönüş değeri , , PositiveInfinitySymbol NegativeInfinitySymbolveya formun bir dizesi olabilirNaNSymbol:

[sign]integral-digits[.[ kesirli basamaklar]][e[sign]üstel basamaklar]

Öğe	Açıklama
sign	Negatif işaret veya pozitif işaret simgesi.
integral-digits	Sayının tamsayı kısmını belirten bir basamak serisi. Kesirli basamaklar varsa tam sayı-basamaklar eksik olabilir.
'.'	Kültüre özgü ondalık nokta simgesi.
kesirli basamaklar	Sayının kesirli kısmını belirten bir basamak dizisi.
'e'	Üstel (bilimsel) gösterimi gösteren küçük harfli 'e' karakteri.
üstel basamaklar	Üs belirten bir dizi basamak.

Döndürülen değere örnek olarak "100", "-123,456,789", "123,45e+6", "500", "3,1416", "600", "-0,123" ve "-Infinity" verilebilir.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:

Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.
Biçimlendirme hakkında daha fazla bilgi için bkz. Biçimlendirme Türleri.

provider parametresi, yöntemi bir nesnesi döndüren IFormatProvider bir GetFormat NumberFormatInfo uygulamadır. Genellikle bir providerCultureInfo nesne veya NumberFormatInfo nesnedir. provider parametresi, biçimlendirmede kullanılan kültüre özgü bilgiler sağlar. ise providernull, dönüş değeri geçerli kültürün NumberFormatInfo verileri kullanılarak biçimlendirilir.

Belirli bir kültür ve belirli bir biçim dizesini kullanarak bir Single değeri dize gösterimine dönüştürmek için yöntemini çağırın Single.ToString(String, IFormatProvider) .

Ayrıca bkz.

Parse(String)
String
.NET'da Biçimlendirme Türleri

Şunlara uygulanır

ToString(String)

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Belirtilen biçimi kullanarak bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.

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

Sayısal biçim dizesi.

Döndürülenler

String

tarafından formatbelirtilen bu örneğin değerinin dize gösterimi.

Özel durumlar

FormatException

format geçersiz.

Örnekler

Aşağıdaki örnek bir sayısal değeri tanımlar ve "C" standart sayısal biçim dizesini kullanarak bir para birimi değeri olarak ve "N" standart sayısal biçim dizesini kullanarak üç ondalık basamak olarak sayısal değer olarak biçimlendirir. Sonuç dizeleri, en-US kültürünün kuralları kullanılarak biçimlendirilir. Sayısal biçim dizeleri hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.

using System;

public class Example
{
   public static void Main()
   {
      Double number = 1764.3789;
      
      // Format as a currency value.
      Console.WriteLine(number.ToString("C"));
      
      // Format as a numeric value with 3 decimal places.
      Console.WriteLine(number.ToString("N3"));
   }
}
// The example displays the following output:
//       $1,764.38
//       1,764.379

let number = 1764.3789

// Format as a currency value.
printfn $"""{number.ToString "C"}"""

// Format as a numeric value with 3 decimal places.
printfn $"""{number.ToString "N3"}"""
// The example displays the following output:
//       $1,764.38
//       1,764.379

Module Example
   Public Sub Main()
      Dim number As Single = 1764.3789
      
      ' Format as a currency value.
      Console.WriteLine(number.ToString("C"))
      
      ' Format as a numeric value with 3 decimal places.
      Console.WriteLine(number.ToString("N3"))
   End Sub
End Module
' The example displays the following output:
'       $1,764.38
'       1,764.379

Aşağıdaki örnek, desteklenen standart sayısal biçim tanımlayıcılarının her birini ve iki özel sayısal biçim dizesini kullanarak çeşitli Single değerler görüntüler. Bu özel biçim dizelerinden biri, bir Single değerin baştaki sıfırlarla nasıl doldurulacaklarını gösterir. Sayısal değerleri dizelere dönüştürürken örnek, en-US kültürünün biçimlendirme kurallarını kullanır.

float[] numbers= { 1054.32179F, -195489100.8377F, 1.0437E21F, 
                   -1.0573e-05F };
string[] specifiers = { "C", "E", "e", "F", "G", "N", "P", 
                        "R", "#,000.000", "0.###E-000",
                        "000,000,000,000.00###" };

foreach (float number in numbers)
{
   Console.WriteLine("Formatting of {0}:", number);
   foreach (string specifier in specifiers)
      Console.WriteLine("   {0,5}: {1}", 
                        specifier, number.ToString(specifier));

   Console.WriteLine();
}
// The example displays the following output to the console:
//       Formatting of 1054.32179:
//              C: $1,054.32
//              E: 1.054322E+003
//              e: 1.054322e+003
//              F: 1054.32
//              G: 1054.32179
//              N: 1,054.32
//              P: 105,432.18 %
//              R: 1054.32179
//          #,000.000: 1,054.322
//          0.###E-000: 1.054E003
//          000,000,000,000.00###: 000,000,001,054.322
//       
//       Formatting of -195489100.8377:
//              C: ($195,489,100.84)
//              E: -1.954891E+008
//              e: -1.954891e+008
//              F: -195489100.84
//              G: -195489100.8377
//              N: -195,489,100.84
//              P: -19,548,910,083.77 %
//              R: -195489100.8377
//          #,000.000: -195,489,100.838
//          0.###E-000: -1.955E008
//          000,000,000,000.00###: -000,195,489,100.00
//       
//       Formatting of 1.0437E+21:
//              C: $1,043,700,000,000,000,000,000.00
//              E: 1.043700E+021
//              e: 1.043700e+021
//              F: 1043700000000000000000.00
//              G: 1.0437E+21
//              N: 1,043,700,000,000,000,000,000.00
//              P: 104,370,000,000,000,000,000,000.00 %
//              R: 1.0437E+21
//          #,000.000: 1,043,700,000,000,000,000,000.000
//          0.###E-000: 1.044E021
//          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
//       
//       Formatting of -1.0573E-05:
//              C: $0.00
//              E: -1.057300E-005
//              e: -1.057300e-005
//              F: 0.00
//              G: -1.0573E-05
//              N: 0.00
//              P: 0.00 %
//              R: -1.0573E-05
//          #,000.000: 000.000
//          0.###E-000: -1.057E-005
//          000,000,000,000.00###: -000,000,000,000.00001

let numbers = 
    [| 1054.32179F; -195489100.8377F; 1.0437E21F; -1.0573e-05F |]
let specifiers = 
    [| "C"; "E"; "e"; "F"; "G"; "N"; "P" 
       "R"; "#,000.000"; "0.###E-000"
       "000,000,000,000.00###" |]

for number in numbers do
    printfn $"Formatting of {number}:"
    for specifier in specifiers do
        printfn $"   {specifier,5}: {number.ToString specifier}" 
    printfn ""
// The example displays the following output to the console:
//       Formatting of 1054.32179:
//              C: $1,054.32
//              E: 1.054322E+003
//              e: 1.054322e+003
//              F: 1054.32
//              G: 1054.32179
//              N: 1,054.32
//              P: 105,432.18 %
//              R: 1054.32179
//          #,000.000: 1,054.322
//          0.###E-000: 1.054E003
//          000,000,000,000.00###: 000,000,001,054.322
//       
//       Formatting of -195489100.8377:
//              C: ($195,489,100.84)
//              E: -1.954891E+008
//              e: -1.954891e+008
//              F: -195489100.84
//              G: -195489100.8377
//              N: -195,489,100.84
//              P: -19,548,910,083.77 %
//              R: -195489100.8377
//          #,000.000: -195,489,100.838
//          0.###E-000: -1.955E008
//          000,000,000,000.00###: -000,195,489,100.00
//       
//       Formatting of 1.0437E+21:
//              C: $1,043,700,000,000,000,000,000.00
//              E: 1.043700E+021
//              e: 1.043700e+021
//              F: 1043700000000000000000.00
//              G: 1.0437E+21
//              N: 1,043,700,000,000,000,000,000.00
//              P: 104,370,000,000,000,000,000,000.00 %
//              R: 1.0437E+21
//          #,000.000: 1,043,700,000,000,000,000,000.000
//          0.###E-000: 1.044E021
//          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
//       
//       Formatting of -1.0573E-05:
//              C: $0.00
//              E: -1.057300E-005
//              e: -1.057300e-005
//              F: 0.00
//              G: -1.0573E-05
//              N: 0.00
//              P: 0.00 %
//              R: -1.0573E-05
//          #,000.000: 000.000
//          0.###E-000: -1.057E-005
//          000,000,000,000.00###: -000,000,000,000.00001

Dim numbers() As Single = {1054.32179, -195489100.8377, 1.0437E21, _
                           -1.0573e-05}
Dim specifiers() As String = { "C", "E", "e", "F", "G", "N", "P", _
                               "R", "#,000.000", "0.###E-000", _
                               "000,000,000,000.00###"}
For Each number As Single In numbers
   Console.WriteLine("Formatting of {0}:", number)
   For Each specifier As String In specifiers
      Console.WriteLine("   {0,5}: {1}", _
                        specifier, number.ToString(specifier))
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'       Formatting of 1054.32179:
'              C: $1,054.32
'              E: 1.054322E+003
'              e: 1.054322e+003
'              F: 1054.32
'              G: 1054.32179
'              N: 1,054.32
'              P: 105,432.18 %
'              R: 1054.32179
'          #,000.000: 1,054.322
'          0.###E-000: 1.054E003
'          000,000,000,000.00###: 000,000,001,054.322      
'       
'       Formatting of -195489100.8377:
'              C: ($195,489,100.84)
'              E: -1.954891E+008
'              e: -1.954891e+008
'              F: -195489100.84
'              G: -195489100.8377
'              N: -195,489,100.84
'              P: -19,548,910,083.77 %
'              R: -195489100.8377
'          #,000.000: -195,489,100.838
'          0.###E-000: -1.955E008
'          000,000,000,000.00###: -000,195,489,100.00
'       
'       Formatting of 1.0437E+21:
'              C: $1,043,700,000,000,000,000,000.00
'              E: 1.043700E+021
'              e: 1.043700e+021
'              F: 1043700000000000000000.00
'              G: 1.0437E+21
'              N: 1,043,700,000,000,000,000,000.00
'              P: 104,370,000,000,000,000,000,000.00 %
'              R: 1.0437E+21
'          #,000.000: 1,043,700,000,000,000,000,000.000
'          0.###E-000: 1.044E021
'          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
'       
'       Formatting of -1.0573E-05:
'              C: $0.00
'              E: -1.057300E-005
'              e: -1.057300e-005
'              F: 0.00
'              G: -1.0573E-05
'              N: 0.00
'              P: 0.00 %
'              R: -1.0573E-05
'          #,000.000: 000.000
'          0.###E-000: -1.057E-005
'          000,000,000,000.00###: -000,000,000,000.00001

Açıklamalar

yöntemi, ToString(String) geçerli kültürün kurallarını kullanarak bir Single değeri belirtilen biçimde biçimlendirmektedir. Varsayılan ("G" veya genel) biçimini kullanmak veya farklı bir kültür belirtmek istiyorsanız yöntemin diğer aşırı yüklemelerini ToString aşağıdaki gibi kullanın:

Biçimi kullanmak için	Kültür için	Aşırı yüklemeyi kullanma
Varsayılan ("G") biçimi	Varsayılan (geçerli) kültür	ToString()
Varsayılan ("G") biçimi	Belirli bir kültür	ToString(IFormatProvider)
Belirli bir biçim	Belirli bir kültür	ToString(String, IFormatProvider)

Dönüş değeri, tarafından PositiveInfinitySymbolbelirtildiği gibi , NegativeInfinitySymbol, NaNSymbolveya geçerli örneğin değerinin dize gösterimi olabilirformat.

format parametresi, D ve X dışında geçerli herhangi bir standart sayısal biçim belirticisi olabileceği gibi, özel sayısal biçim tanımlayıcılarının herhangi bir bileşimi de olabilir. Biçim veya boş bir dizeyse null , dönüş değeri genel sayısal biçim tanımlayıcısı ("G") ile biçimlendirilir.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:

Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.
Biçimlendirme hakkında daha fazla bilgi için bkz. Biçimlendirme Türleri.

Varsayılan olarak, en fazla 9 basamak dahili olarak korunsa da, dönüş değeri yalnızca 7 basamak duyarlık içerir. Bu örneğin değeri 7 basamaktan büyükse, ToString(String) beklenen sayı yerine veya PositiveInfinitySymbol döndürürNegativeInfinitySymbol. Daha fazla duyarlık gerekiyorsa, her zaman 9 duyarlık basamağı döndüren "G9" biçim belirtimi veya sayı yalnızca en yüksek hassasiyetle gösterilebiliyorsa 7 basamak döndüren "R" ile belirtin format .

Ayrıca bkz.

Parse(String)
String
.NET'da Biçimlendirme Türleri
Nasıl yapılır: Bir Sayıyı Baştaki Sıfırlarla Doldurma

Şunlara uygulanır

ToString(String, IFormatProvider)

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Kaynak:: Single.cs

Belirtilen biçim ve kültüre özgü biçim bilgilerini kullanarak bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür.

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

Sayısal biçim dizesi.

provider: IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

Döndürülenler

String

ve tarafından formatproviderbelirtilen bu örneğin değerinin dize gösterimi.

Uygulamalar

ToString(String, IFormatProvider)

Örnekler

Aşağıdaki örnek, birkaç farklı kültür için desteklenen standart sayısal biçim tanımlayıcılarının her birini kullanarak bir Single değer görüntüler.

float value = 16325.62901F;
string specifier;
CultureInfo culture;

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

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

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,63
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.63

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

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 %

let value = 16325.62901F

// Use standard numeric format specifiers.
let specifier = "G"
let culture = CultureInfo.CreateSpecificCulture "eu-ES"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16325,62901
printfn $"{value.ToString(specifier, CultureInfo.InvariantCulture)}"
// Displays:    16325.62901

let specifier = "C"
let culture = CultureInfo.CreateSpecificCulture "en-US"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    $16,325.63
let culture = CultureInfo.CreateSpecificCulture "en-GB"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    £16,325.63

let specifier = "E04"
let culture = CultureInfo.CreateSpecificCulture "sv-SE"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 1,6326E+004   
let culture = CultureInfo.CreateSpecificCulture "en-NZ"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    1.6326E+004   

let specifier = "F"
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16325,63
let culture = CultureInfo.CreateSpecificCulture "en-CA"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16325.63

let specifier = "N"
let culture = CultureInfo.CreateSpecificCulture "es-ES"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16.325,63
let culture = CultureInfo.CreateSpecificCulture "fr-CA"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16 325,63

let specifier = "P"
let culture = CultureInfo.InvariantCulture
printfn $"{(value / 10000f).ToString(specifier, culture)}"
// Displays:    163.26 %
let culture = CultureInfo.CreateSpecificCulture "ar-EG"
printfn $"{(value / 10000f).ToString(specifier, culture)}"
// Displays:    163.256 %

Dim value As Single = 16325.62901
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,62901
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays:    16325.62901

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

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,63
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325.63

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

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 %

Açıklamalar

yöntemi, ToString(String, IFormatProvider) belirtilen bir Single kültürün belirtilen biçimindeki bir değeri biçimlendirer. Varsayılan biçim veya kültür ayarlarını kullanmak istiyorsanız yöntemin diğer aşırı yüklemelerini ToString aşağıdaki gibi kullanın:

Biçimi kullanmak için	Kültür için	Aşırı yüklemeyi kullanma
Varsayılan ("G") biçimi	Varsayılan (geçerli) kültür	ToString()
Varsayılan ("G") biçimi	Belirli bir kültür	ToString(IFormatProvider)
Belirli bir biçim	Varsayılan (geçerli) kültür	ToString(String)

Dönüş değeri, tarafından PositiveInfinitySymbolbelirtildiği gibi , NegativeInfinitySymbol, NaNSymbolveya geçerli örneğin değerinin dize gösterimi olabilirformat.

format parametresi, D ve X dışında geçerli herhangi bir standart sayısal biçim belirticisi olabileceği gibi, özel sayısal biçim tanımlayıcılarının herhangi bir bileşimi de olabilir. format ise veya boş bir dizeysenull, bu örneğin dönüş değeri genel sayısal biçim tanımlayıcısı ("G") ile biçimlendirilir.

.NET, aşağıdaki biçimlendirme konularında daha ayrıntılı olarak açıklanan kapsamlı biçimlendirme desteği sağlar:

Sayısal biçim tanımlayıcıları hakkında daha fazla bilgi için bkz. Standart Sayısal Biçim Dizeleri ve Özel Sayısal Biçim Dizeleri.
Biçimlendirme hakkında daha fazla bilgi için bkz. Biçimlendirme Türleri.

Varsayılan olarak, en fazla 9 basamak dahili olarak korunsa da, dönüş değeri yalnızca 7 basamak duyarlık içerir. Bu örneğin değeri 7 basamaktan büyükse, ToString beklenen sayı yerine veya PositiveInfinitySymbol döndürürNegativeInfinitySymbol. Daha fazla duyarlık gerekiyorsa, her zaman 9 duyarlık basamağı döndüren "G9" biçim belirtimi veya sayı yalnızca en yüksek hassasiyetle gösterilebiliyorsa 7 basamak döndüren "R" ile belirtin format .

Ayrıca bkz.

Parse(String)
String
.NET'da Biçimlendirme Türleri
Nasıl yapılır: Bir Sayıyı Baştaki Sıfırlarla Doldurma

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?