Single.ToString Yöntem
Tanım
Ö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
ToString() |
Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür. |
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. |
ToString(String) |
Bu örneğin sayısal değerini, belirtilen biçimi kullanarak eşdeğer dize gösterimine dönüştürü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. |
ToString()
- 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
Bu örneğin değerinin dize olarak gösterimi.
Örnekler
Aşağıdaki örnek, bir dizi Single değerin dize gösterimlerini görüntülemek için varsayılan Single.ToString 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 ToString() birlikte yönteminin Parse(String) 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 );
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 );
}
}
while ( !done );
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 , NegativeInfinitySymbol, NaNSymbolveya formun bir dizesi olabilirPositiveInfinitySymbol:
[sign]integral-digits[.[fractional-digits]][e[sign]exponential-digits]
İsteğe bağlı öğeler çerçeve ve köşeli ayraç içine alınır ([ve]). "Rakamlar" terimini içeren öğeler 0-9 arasında bir dizi sayısal karakterden oluşur. Aşağıdaki tabloda her öğe listelenir:
Öğe | Açıklama |
---|---|
sign | Eksi işareti ve artı işareti simgesi. |
tamsayı basamaklar | Sayının tamsayı kısmını belirten rakam dizisi. Kesirli basamaklar varsa tamsayı basamaklar bulunmayabilir. |
'.' | Bir kültüre özgü ondalık nokta sembolü. |
kesirli basamaklar | Sayının kesirli bölümü belirten rakam dizisi. |
'e' | Üstel (bilimsel) gösterimi belirten bir küçük harf 'e' karakteri. |
üstel basamaklar | Bir üssü belirten rakam dizisi. |
Dönüş değerine ilişkin bazı örnekler şunlardır: "100", "-123,456,789", "123.45e+6", "500", "3.1416", "600", "-0.123" ve "-Infinity".
.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.
Şunlara uygulanır
ToString(IFormatProvider)
- Kaynak:
- Single.cs
- Kaynak:
- Single.cs
- Kaynak:
- Single.cs
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.
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.
Döndürülenler
tarafından provider
belirtilen bu örneğin değerinin dize gösterimi.
Uygulamalar
Örnekler
Aşağıdaki örnekte, birkaç farklı kültürü temsil eden nesneler kullanılarak CultureInfo iki Single değerin dize gösterimi görüntülenir.
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ö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() |
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 , NegativeInfinitySymbol, NaNSymbolveya formun bir dizesi olabilirPositiveInfinitySymbol:
[sign]integral-digits[.[fractional-digits]][e[sign]exponential-digits]
İsteğe bağlı öğeler çerçeve ve köşeli ayraç içine alınır ([ve]). "Rakamlar" 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 |
---|---|
sign | Eksi işareti ve artı işareti simgesi. |
tamsayı basamaklar | Sayının tamsayı kısmını belirten rakam dizisi. Kesirli basamaklar varsa tamsayı basamaklar bulunmayabilir. |
'.' | Bir kültüre özgü ondalık nokta sembolü. |
kesirli basamaklar | Sayının kesirli bölümü belirten rakam dizisi. |
'e' | Üstel (bilimsel) gösterimi belirten bir küçük harf 'e' karakteri. |
üstel basamaklar | Bir üssü belirten rakam dizisi. |
Dönüş değerine ilişkin bazı örnekler şunlardır: "100", "-123,456,789", "123.45e+6", "500", "3.1416", "600", "-0.123" ve "-Infinity".
.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 GetFormat bir IFormatProviderNumberFormatInfo uygulamadır. Genellikle bir provider
CultureInfo nesne veya nesnedir NumberFormatInfo .
provider
parametresi, biçimlendirmede kullanılan kültüre özgü bilgiler sağlar. ise provider
null
, 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.
Şunlara uygulanır
ToString(String)
- Kaynak:
- Single.cs
- Kaynak:
- Single.cs
- Kaynak:
- Single.cs
Bu örneğin sayısal değerini, belirtilen biçimi kullanarak 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
Bir sayısal biçim dizesi.
Döndürülenler
tarafından format
belirtilen bu örneğin değerinin dize gösterimi.
Özel durumlar
format
geçersizdir.
Örnekler
Aşağıdaki örnek bir sayısal değeri tanımlar ve "C" standart sayısal biçim dizesini kullanarak bunu para birimi değeri olarak ve "N" standart sayısal biçim dizesini kullanarak üç ondalık basamak için 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 iki özel sayısal biçim dizesiyle birlikte kullanarak çeşitli Single değerleri görüntüler. Bu özel biçim dizelerinden biri, bir değerin baştaki sıfırlarla nasıl doldurulacaklarını Single gösterir. Ö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.
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 format
belirtildiği gibi , NegativeInfinitySymbol, NaNSymbolveya geçerli örneğin değerinin dize gösterimi olabilirPositiveInfinitySymbol.
format
parametresi, D ve X dışında herhangi bir geçerli standart sayısal biçim belirticisinin yanı sıra özel sayısal biçim tanımlayıcılarının herhangi bir bileşimi 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 NegativeInfinitySymbol döndürürPositiveInfinitySymbol. Daha fazla duyarlık gerekiyorsa, her zaman 9 duyarlık basamağı döndüren "G9" biçim belirtimi ile belirtin veya "R" değerini belirtin format
. Bu, sayı bu duyarlıkla gösterilebilirse 7 basamak veya en yüksek hassasiyetle gösterilebilecekse 9 basamak döndürür.
Ayrıca bkz.
- Parse(String)
- String
- .NET'te 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
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.
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
Bir sayısal biçim dizesi.
- provider
- IFormatProvider
Kültüre özgü biçimlendirme bilgileri sağlayan nesne.
Döndürülenler
ve provider
tarafından format
belirtilen bu örneğin değerinin dize gösterimi.
Uygulamalar
Örnekler
Aşağıdaki örnekte, birkaç farklı kültür için desteklenen standart sayısal biçim tanımlayıcılarının her birini kullanan bir Single değer görüntülenir.
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) bir Single değeri belirtilen bir kültür biçiminde biçimlendirebilir. Varsayılan biçim veya kültür ayarlarını kullanmak 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() |
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 format
belirtildiği gibi , NegativeInfinitySymbol, NaNSymbolveya geçerli örneğin değerinin dize gösterimi olabilirPositiveInfinitySymbol.
format
parametresi, D ve X dışında herhangi bir geçerli standart sayısal biçim belirticisinin yanı sıra özel sayısal biçim tanımlayıcılarının herhangi bir bileşimi olabilir. ise null
veya boş bir dizeyseformat
, 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.
provider
parametresi, yöntemi bir nesnesi döndüren GetFormat bir IFormatProviderNumberFormatInfo uygulamadır. Genellikle bir provider
CultureInfo nesne veya nesnedir NumberFormatInfo .
provider
parametresi, biçimlendirmede kullanılan kültüre özgü bilgiler sağlar. ise provider
null
, dönüş değeri geçerli kültürün NumberFormatInfo nesnesiyle biçimlendirilir.
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 NegativeInfinitySymbol döndürürPositiveInfinitySymbol. Daha fazla duyarlık gerekiyorsa, her zaman 9 duyarlık basamağı döndüren "G9" biçim belirtimi ile belirtin veya "R" değerini belirtin format
. Bu, sayı bu duyarlıkla gösterilebilirse 7 basamak veya en yüksek hassasiyetle gösterilebilecekse 9 basamak döndürür.
Ayrıca bkz.
- Parse(String)
- String
- .NET'te Biçimlendirme Türleri
- Nasıl yapılır: Bir Sayıyı Baştaki Sıfırlarla Doldurma