UInt16.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(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) |
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) |
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() |
Bu örneğin sayısal değerini eşdeğer dize gösterimine dönüştürür. |
ToString(IFormatProvider)
- Kaynak:
- UInt16.cs
- Kaynak:
- UInt16.cs
- Kaynak:
- UInt16.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
Bu örneğin değerinin, işareti veya başında sıfır olmadan 0 ile 9 arasında bir basamak dizisinden oluşan dize gösterimi.
Uygulamalar
Örnekler
Aşağıdaki örnek, sabit kültür için bir tane de dahil olmak üzere çeşitli biçim sağlayıcıları kullanarak 16 bit imzalı bir tamsayı değerini biçimlendirmektedir. Örnekten elde edilen çıktı, biçim sağlayıcısından bağımsız olarak yöntemi tarafından ToString(IFormatProvider) döndürülen biçimlendirilmiş dizenin aynı olduğunu gösterir.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Define an array of CultureInfo objects.
CultureInfo[] ci = { new CultureInfo("en-US"),
new CultureInfo("fr-FR"),
CultureInfo.InvariantCulture };
UInt16 value = 18924;
Console.WriteLine(" {0,12} {1,12} {2,12}",
GetName(ci[0]), GetName(ci[1]), GetName(ci[2]));
Console.WriteLine(" {0,12} {1,12} {2,12}",
value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2]));
}
private static string GetName(CultureInfo ci)
{
if (ci.Equals(CultureInfo.InvariantCulture))
return "Invariant";
else
return ci.Name;
}
}
// The example displays the following output:
// en-US fr-FR Invariant
// 18924 18924 18924
open System.Globalization
let getName (ci: CultureInfo) =
if ci.Equals CultureInfo.InvariantCulture then "Invariant"
else ci.Name
// Define an array of CultureInfo objects.
let ci =
[| CultureInfo "en-US"
CultureInfo "fr-FR"
CultureInfo.InvariantCulture |]
let value = 18924us
printfn $" {getName ci[0],12} {getName ci[1],12} {getName ci[2],12}"
printfn $" {value.ToString ci[0],12} {value.ToString ci[1],12} {value.ToString ci[2],12}"
// The example displays the following output:
// en-US fr-FR Invariant
// 18924 18924 18924
Imports System.Globalization
Module Example
Public Sub Main()
' Define an array of CultureInfo objects.
Dim ci() As CultureInfo = { New CultureInfo("en-US"), _
New CultureInfo("fr-FR"), _
CultureInfo.InvariantCulture }
Dim value As UInt16 = 18924
Console.WriteLine(" {0,12} {1,12} {2,12}", _
GetName(ci(0)), GetName(ci(1)), GetName(ci(2)))
Console.WriteLine(" {0,12} {1,12} {2,12}", _
value.ToString(ci(0)), value.ToString(ci(1)), value.ToString(ci(2)))
End Sub
Private Function GetName(ci As CultureInfo) As String
If ci.Equals(CultureInfo.InvariantCulture) Then
Return "Invariant"
Else
Return ci.Name
End If
End Function
End Module
' The example displays the following output:
' en-US fr-FR Invariant
' 18924 18924 18924
Açıklamalar
yöntemi, ToString(IFormatProvider) belirtilen kültürün nesnesini kullanarak NumberFormatInfo bir UInt16 değeri 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) |
provider
parametresi bir IFormatProvider uygulamadır.
GetFormat yöntemi, kültüre özgü biçimlendirme bilgileri sağlayan bir NumberFormatInfo nesne döndürür. Ancak, genel sayısal biçim tanımlayıcısı ("G") ile biçimlendirme yaparken özelliklerinin NumberFormatInfo hiçbiri kullanılmaz.
Ayrıca bkz.
Şunlara uygulanır
ToString(String)
- Kaynak:
- UInt16.cs
- Kaynak:
- UInt16.cs
- Kaynak:
- UInt16.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
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
Parametre geçersiz.
Örnekler
Aşağıdaki örnek, her standart biçim dizesini ve bazı özel biçim dizelerini kullanarak 16 bit işaretsiz bir tamsayı değeri görüntüler.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
ushort value = 21708;
string[] specifiers = { "G", "C", "D3", "E2", "e3", "F",
"N", "P", "X", "000000.0", "#.0",
"00000000;(0);**Zero**" };
foreach (string specifier in specifiers)
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
}
}
// The example displays the following output:
// G: 21708
// C: $21,708.00
// D3: 21708
// E2: 2.17E+004
// e3: 2.171e+004
// F: 21708.00
// N: 21,708.00
// P: 2,170,800.00 %
// X: 54CC
// 000000.0: 021708.0
// #.0: 21708.0
// 00000000;(0);**Zero**: 00021708
let value = 21708us
let specifiers =
[| "G"; "C"; "D3"; "E2"; "e3"; "F"
"N"; "P"; "X"; "000000.0"; "#.0"
"00000000(0)**Zero**" |]
for specifier in specifiers do
printfn $"{specifier}: {value.ToString specifier}"
// The example displays the following output:
// G: 21708
// C: $21,708.00
// D3: 21708
// E2: 2.17E+004
// e3: 2.171e+004
// F: 21708.00
// N: 21,708.00
// P: 2,170,800.00 %
// X: 54CC
// 000000.0: 021708.0
// #.0: 21708.0
// 00000000(0)**Zero**: 00021708
Imports System.Globalization
Module Example
Public Sub Main()
Dim value As UShort = 21708
Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
"N", "P", "X", "000000.0", "#.0", _
"00000000;(0);**Zero**" }
For Each specifier As String In specifiers
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next
End Sub
End Module
' The example displays the following output:
' G: 21708
' C: $21,708.00
' D3: 21708
' E2: 2.17E+004
' e3: 2.171e+004
' F: 21708.00
' N: 21,708.00
' P: 2,170,800.00 %
' X: 54CC
' 000000.0: 021708.0
' #.0: 21708.0
' 00000000;(0);**Zero**: 00021708
Açıklamalar
yöntemi, ToString(String) geçerli kültürün kurallarını temsil eden bir NumberFormatInfo nesne kullanarak değeri belirtilen biçimde biçimlendirmektedirUInt16. Varsayılan ("G" veya genel) biçimini kullanmak veya farklı bir kültür belirtmek istiyorsanız, aşağıdaki gibi yöntemin ToString diğer aşırı yüklemelerini 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) |
format
Parametre geçerli herhangi bir standart sayısal biçim belirticisi veya özel sayısal biçim tanımlayıcılarının herhangi bir bileşimi olabilir. veya null
değerine eşitse String.Emptyformat
, geçerli UInt16 nesnenin dönüş değeri genel biçim belirtici ("G") ile biçimlendirilir. Başka bir değer ise format
, yöntemi bir FormatExceptionoluşturur.
.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.
.NET'te biçimlendirme desteği hakkında daha fazla bilgi için bkz . Biçimlendirme Türleri.
Döndürülen dizenin biçimi geçerli kültür için nesnesi tarafından NumberFormatInfo belirlenir. Parametreye format
bağlı olarak, bu nesne grup ayırıcısı ve çıkış dizesindeki ondalık nokta simgesi gibi simgeleri denetler. Geçerli kültür dışındaki kültürler için biçimlendirme bilgileri sağlamak için aşırı yüklemeyi çağırın ToString(String, IFormatProvider) .
Ayrıca bkz.
Şunlara uygulanır
ToString(String, IFormatProvider)
- Kaynak:
- UInt16.cs
- Kaynak:
- UInt16.cs
- Kaynak:
- UInt16.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
belirtildiği gibi bu örneğin değerinin dize gösterimi.
Uygulamalar
Özel durumlar
format
geçersizdir.
Örnekler
Aşağıdaki örnek, standart sayısal biçim tanımlayıcılarını ve belirli CultureInfo nesne sayısını kullanarak 16 bit işaretsiz bir tamsayı değeri görüntüler.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"),
CultureInfo.CreateSpecificCulture("fr-FR"),
CultureInfo.CreateSpecificCulture("es-ES") };
string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"};
ushort value = 22042;
foreach (string specifier in specifiers)
{
foreach (CultureInfo culture in cultures)
Console.WriteLine("{0,2} format using {1} culture: {2, 16}",
specifier, culture.Name,
value.ToString(specifier, culture));
Console.WriteLine();
}
}
}
// The example displays the following output:
// G format using en-US culture: 22042
// G format using fr-FR culture: 22042
// G format using es-ES culture: 22042
//
// C format using en-US culture: $22,042.00
// C format using fr-FR culture: 22 042,00 €
// C format using es-ES culture: 22.042,00 €
//
// D4 format using en-US culture: 22042
// D4 format using fr-FR culture: 22042
// D4 format using es-ES culture: 22042
//
// E2 format using en-US culture: 2.20E+004
// E2 format using fr-FR culture: 2,20E+004
// E2 format using es-ES culture: 2,20E+004
//
// F format using en-US culture: 22042.00
// F format using fr-FR culture: 22042,00
// F format using es-ES culture: 22042,00
//
// N format using en-US culture: 22,042.00
// N format using fr-FR culture: 22 042,00
// N format using es-ES culture: 22.042,00
//
// P format using en-US culture: 2,204,200.00 %
// P format using fr-FR culture: 2 204 200,00 %
// P format using es-ES culture: 2.204.200,00 %
//
// X2 format using en-US culture: 561A
// X2 format using fr-FR culture: 561A
// X2 format using es-ES culture: 561A
open System.Globalization
// Define cultures whose formatting conventions are to be used.
let cultures =
[| CultureInfo.CreateSpecificCulture "en-US"
CultureInfo.CreateSpecificCulture "fr-FR"
CultureInfo.CreateSpecificCulture "es-ES" |]
let specifiers = [| "G"; "C"; "D4"; "E2"; "F"; "N"; "P"; "X2" |]
let value = 22042us
for specifier in specifiers do
for culture in cultures do
printfn $"{specifier,2} format using {culture.Name} culture: {value.ToString(specifier, culture), 16}"
printfn ""
// The example displays the following output:
// G format using en-US culture: 22042
// G format using fr-FR culture: 22042
// G format using es-ES culture: 22042
//
// C format using en-US culture: $22,042.00
// C format using fr-FR culture: 22 042,00 €
// C format using es-ES culture: 22.042,00 €
//
// D4 format using en-US culture: 22042
// D4 format using fr-FR culture: 22042
// D4 format using es-ES culture: 22042
//
// E2 format using en-US culture: 2.20E+004
// E2 format using fr-FR culture: 2,20E+004
// E2 format using es-ES culture: 2,20E+004
//
// F format using en-US culture: 22042.00
// F format using fr-FR culture: 22042,00
// F format using es-ES culture: 22042,00
//
// N format using en-US culture: 22,042.00
// N format using fr-FR culture: 22 042,00
// N format using es-ES culture: 22.042,00
//
// P format using en-US culture: 2,204,200.00 %
// P format using fr-FR culture: 2 204 200,00 %
// P format using es-ES culture: 2.204.200,00 %
//
// X2 format using en-US culture: 561A
// X2 format using fr-FR culture: 561A
// X2 format using es-ES culture: 561A
Imports System.Globalization
Module Example
Public Sub Main()
' 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 specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}
Dim value As UShort = 22042
For Each specifier As String In specifiers
For Each culture As CultureInfo In Cultures
Console.WriteLine("{0,2} format using {1} culture: {2, 16}", _
specifier, culture.Name, _
value.ToString(specifier, culture))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' G format using en-US culture: 22042
' G format using fr-FR culture: 22042
' G format using es-ES culture: 22042
'
' C format using en-US culture: $22,042.00
' C format using fr-FR culture: 22 042,00 €
' C format using es-ES culture: 22.042,00 €
'
' D4 format using en-US culture: 22042
' D4 format using fr-FR culture: 22042
' D4 format using es-ES culture: 22042
'
' E2 format using en-US culture: 2.20E+004
' E2 format using fr-FR culture: 2,20E+004
' E2 format using es-ES culture: 2,20E+004
'
' F format using en-US culture: 22042.00
' F format using fr-FR culture: 22042,00
' F format using es-ES culture: 22042,00
'
' N format using en-US culture: 22,042.00
' N format using fr-FR culture: 22 042,00
' N format using es-ES culture: 22.042,00
'
' P format using en-US culture: 2,204,200.00 %
' P format using fr-FR culture: 2 204 200,00 %
' P format using es-ES culture: 2.204.200,00 %
'
' X2 format using en-US culture: 561A
' X2 format using fr-FR culture: 561A
' X2 format using es-ES culture: 561A
Açıklamalar
yöntemi, ToString(String, IFormatProvider) belirtilen bir UInt16 kültürün NumberFormatInfo nesnesini kullanarak değeri belirtilen biçimde 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) |
format
parametresi geçerli herhangi bir Standart Sayısal Biçim Dizeleri veya Özel Sayısal Biçim Dizelerinin herhangi bir bileşimi olabilir. veya null
değerine eşitse String.Emptyformat
, geçerli UInt16 nesnenin dönüş değeri genel biçim belirtici ("G") ile biçimlendirilir. Başka bir değer ise format
, yöntemi bir FormatExceptionoluşturur.
.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 bir IFormatProvider uygulamadır.
GetFormat yöntemi, bu yöntem tarafından döndürülen dizenin biçimi hakkında kültüre özgü bilgiler sağlayan bir NumberFormatInfo nesnesi döndürür.
ToString(String, IFormatProvider) yöntemi çağrıldığında parametresinin provider
IFormatProvider.GetFormat yöntemini çağırır ve türü temsil NumberFormatInfo eden bir Type nesne iletir. Ardından GetFormat yöntemi, geçerli UInt16 değeri biçimlendirmek için grup ayırıcı simgesi veya ondalık ayırıcı simgesi gibi bilgiler sağlayan nesneyi döndürürNumberFormatInfo. yöntemine provider
biçimlendirme bilgileri ToString(String, IFormatProvider) sağlamak için parametresini kullanmanın üç yolu vardır:
Biçimlendirme bilgileri sağlayan kültürü temsil eden bir CultureInfo nesne geçirebilirsiniz. yöntemi GetFormat , bu kültür için sayısal biçimlendirme bilgileri sağlayan nesneyi döndürür NumberFormatInfo .
Sayısal biçimlendirme bilgileri sağlayan gerçek NumberFormatInfo nesneyi geçirebilirsiniz. (Uygulaması GetFormat yalnızca kendini döndürür.)
uygulayan IFormatProviderözel bir nesne geçirebilirsiniz. Yöntemi GetFormat , biçimlendirme bilgileri sağlayan nesnesinin örneğini NumberFormatInfo oluşturur ve döndürür.
ise provider
null
, döndürülen dizenin biçimlendirmesi geçerli kültürün NumberFormatInfo nesnesini temel alır.
Ayrıca bkz.
- Parse(String)
- .NET'te Biçimlendirme Türleri
- Nasıl yapılır: Bir Sayıyı Baştaki Sıfırlarla Doldurma
- Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (C#)
- Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (Visual Basic)
Şunlara uygulanır
ToString()
- Kaynak:
- UInt16.cs
- Kaynak:
- UInt16.cs
- Kaynak:
- UInt16.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, işareti veya başında sıfır olmadan 0 ile 9 arasında bir basamak dizisinden oluşan dize gösterimi.
Örnekler
Aşağıdaki örnek, varsayılan ToString() yöntemi kullanarak bir UInt16 değer görüntüler. Ayrıca, bazı standart biçim tanımlayıcıları kullanılarak elde edilen değerin dize gösterimlerini UInt16 görüntüler. Örnekler, İngilizce (ABD) kültürünün biçimlendirme kurallarını kullanarak görüntülenir.
using System;
public class Example
{
public static void Main()
{
ushort value = 16324;
// Display value using default ToString method.
Console.WriteLine(value.ToString());
Console.WriteLine();
// Define an array of format specifiers.
string[] formats = { "G", "C", "D", "F", "N", "X" };
// Display value using the standard format specifiers.
foreach (string format in formats)
Console.WriteLine("{0} format specifier: {1,12}",
format, value.ToString(format));
}
}
// The example displays the following output:
// 16324
//
// G format specifier: 16324
// C format specifier: $16,324.00
// D format specifier: 16324
// F format specifier: 16324.00
// N format specifier: 16,324.00
// X format specifier: 3FC4
let value = 16324us
// Display value using default ToString method.
printfn $"{value.ToString()}\n"
// Define an array of format specifiers.
let formats = [| "G"; "C"; "D"; "F"; "N"; "X" |]
// Display value using the standard format specifiers.
for format in formats do
printfn $"{format} format specifier: {value.ToString format,12}"
// The example displays the following output:
// 16324
//
// G format specifier: 16324
// C format specifier: $16,324.00
// D format specifier: 16324
// F format specifier: 16324.00
// N format specifier: 16,324.00
// X format specifier: 3FC4
Module Example
Public Sub Main()
Dim value As UInt16 = 16324
' Display value using default ToString method.
Console.WriteLine(value.ToString())
Console.WriteLine()
' Define an array of format specifiers.
Dim formats() As String = { "G", "C", "D", "F", "N", "X" }
' Display value using the standard format specifiers.
For Each format As String In formats
Console.WriteLine("{0} format specifier: {1,12}", _
format, value.ToString(format))
Next
End Sub
End Module
' The example displays the following output:
' 16324
'
' G format specifier: 16324
' C format specifier: $16,324.00
' D format specifier: 16324
' F format specifier: 16324.00
' N format specifier: 16,324.00
' X format specifier: 3FC4
Açıklamalar
yöntemi, ToString() geçerli kültürün nesnesini kullanarak NumberFormatInfo bir UInt16 değeri 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) |