Aracılığıyla paylaş


UInt32.ToString Yöntem

Tanım

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)

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:
UInt32.cs
Kaynak:
UInt32.cs
Kaynak:
UInt32.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, 0 ile 9 arasında bir dizi basamaktan oluşan, bir işaret veya baştaki sıfırlar olmadan dize gösterimi.

Örnekler

Aşağıdaki örnekte, varsayılan ToString() yöntemi kullanılarak bir UInt32 değeri görüntülenir. Ayrıca, bazı standart biçim tanımlayıcılarının kullanılmasından kaynaklanan UInt32 değerinin dize gösterimlerini görüntüler. Örnekler, en-US kültürünün biçimlendirme kuralları kullanılarak görüntülenir.

using System;

public class Example
{
   public static void Main()
   {
      uint value = 1632490;
      // 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,16}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       1632490
//       
//       G format specifier:          1632490
//       C format specifier:    $1,632,490.00
//       D format specifier:          1632490
//       F format specifier:       1632490.00
//       N format specifier:     1,632,490.00
//       X format specifier:           18E8EA
let value = 1632490u
// 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,16}"
// The example displays the following output:
//       1632490
//       
//       G format specifier:          1632490
//       C format specifier:    $1,632,490.00
//       D format specifier:          1632490
//       F format specifier:       1632490.00
//       N format specifier:     1,632,490.00
//       X format specifier:           18E8EA
Module Example
   Public Sub Main()
      Dim value As UInteger = 1632490
      ' 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,16}", _
                           format, value.ToString(format))         
      Next
   End Sub
End Module
' The example displays the following output:
'       1632490
'       
'       G format specifier:          1632490
'       C format specifier:    $1,632,490.00
'       D format specifier:          1632490
'       F format specifier:       1632490.00
'       N format specifier:     1,632,490.00
'       X format specifier:           18E8EA

Açıklamalar

ToString() yöntemi, geçerli kültürün NumberFormatInfo nesnesini kullanarak varsayılan ("G" veya genel) biçiminde bir UInt32 değeri biçimlendirir. Farklı bir biçim veya kültür belirtmek istiyorsanız, ToString yönteminin diğer aşırı yüklemelerini 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)

Ayrıca bkz.

Şunlara uygulanır

ToString(IFormatProvider)

Kaynak:
UInt32.cs
Kaynak:
UInt32.cs
Kaynak:
UInt32.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

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ı, ToString(IFormatProvider) yöntemi tarafından döndürülen biçimlendirilmiş dizenin biçim sağlayıcısından bağımsız olarak 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 }; 
      uint value = 1870924;
      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
//           1870924        1870924        1870924
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 = 1870924u

printfn $"  {getName ci[0],12}   {getName ci[1],12}   {getName ci[3],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
//           1870924        1870924        1870924
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 UInteger = 1870924
      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
'      1870924        1870924        1870924

Açıklamalar

ToString(IFormatProvider) yöntemi, belirtilen kültürün NumberFormatInfo nesnesini kullanarak bir UInt32 değerini varsayılan ("G" veya genel) biçiminde biçimlendirir. Farklı bir biçim veya geçerli kültür belirtmek istiyorsanız, ToString yönteminin diğer aşırı yüklemelerini 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 IFormatProvider bir uygulamadır. GetFormat yöntemi, kültüre özgü biçimlendirme bilgileri sağlayan bir NumberFormatInfo nesnesi döndürür. Ancak, NumberFormatInfo özelliklerinden hiçbiri genel sayısal biçim tanımlayıcısı ("G") ile biçimlendirilirken kullanılmaz.

Ayrıca bkz.

Şunlara uygulanır

ToString(String)

Kaynak:
UInt32.cs
Kaynak:
UInt32.cs
Kaynak:
UInt32.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

formattarafından belirtilen bu örneğin değerinin dize gösterimi.

Özel durumlar

format parametresi geçersiz.

Örnekler

Aşağıdaki örnek, her standart biçim dizesini ve bazı özel biçim dizelerini kullanarak 32 bit işaretsiz bir tamsayı değeri görüntüler.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      uint value = 2179608;
      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: 2179608
//       C: $2,179,608.00
//       D3: 2179608
//       E2: 2.18E+006
//       e3: 2.180e+006
//       F: 2179608.00
//       N: 2,179,608.00
//       P: 217,960,800.00 %
//       X: 214218
//       000000.0: 2179608.0
//       #.0: 2179608.0
//       00000000;(0);**Zero**: 02179608
let value = 2179608u
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: 2179608
//       C: $2,179,608.00
//       D3: 2179608
//       E2: 2.18E+006
//       e3: 2.180e+006
//       F: 2179608.00
//       N: 2,179,608.00
//       P: 217,960,800.00 %
//       X: 214218
//       000000.0: 2179608.0
//       #.0: 2179608.0
//       00000000(0)**Zero**: 02179608
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As UInteger = 2179608 
      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: 2179608
'       C: $2,179,608.00
'       D3: 2179608
'       E2: 2.18E+006
'       e3: 2.180e+006
'       F: 2179608.00
'       N: 2,179,608.00
'       P: 217,960,800.00 %
'       X: 214218
'       000000.0: 2179608.0
'       #.0: 2179608.0
'       00000000;(0);**Zero**: 02179608

Açıklamalar

ToString(String) yöntemi, geçerli kültürün kurallarını temsil eden bir NumberFormatInfo nesnesi kullanarak belirli bir biçimde UInt32 değeri biçimlendirmektedir. Varsayılan ("G" veya genel) biçimini kullanmak veya farklı bir kültür belirtmek istiyorsanız, ToString yönteminin diğer aşırı yüklemelerini 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)

parametresi,geçerli Standart Sayısal Biçim Dizeleri veyaÖzel Sayısal Biçim Dizelerinin herhangi bir bileşimi olabilir. format String.Empty eşitse veya nullise, geçerli UInt32 nesnesinin dönüş değeri genel biçim belirticisi ("G") ile biçimlendirilir. format başka bir değerse, 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:

Döndürülen dizenin biçimi, geçerli kültür için NumberFormatInfo nesnesi tarafından belirlenir. format parametresine 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 ToString(String, IFormatProvider) aşırı yüklemesini çağırın.

Ayrıca bkz.

Şunlara uygulanır

ToString(String, IFormatProvider)

Kaynak:
UInt32.cs
Kaynak:
UInt32.cs
Kaynak:
UInt32.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

Bu örnekle ilgili kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

Döndürülenler

format ve providertarafından belirtilen bu örneğin değerinin dize gösterimi.

Uygulamalar

Özel durumlar

format parametresi geçersiz.

Örnekler

Aşağıdaki örnek, standart sayısal biçim tanımlayıcılarını ve belirli CultureInfo nesneleri kullanarak 32 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"}; 
      uint value = 2222402;
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}",  
                              specifier, culture.Name, 
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:            2222402
//        G format using fr-FR culture:            2222402
//        G format using es-ES culture:            2222402
//       
//        C format using en-US culture:      $2,222,402.00
//        C format using fr-FR culture:     2 222 402,00 €
//        C format using es-ES culture:     2.222.402,00 €
//       
//       D4 format using en-US culture:            2222402
//       D4 format using fr-FR culture:            2222402
//       D4 format using es-ES culture:            2222402
//       
//       E2 format using en-US culture:          2.22E+006
//       E2 format using fr-FR culture:          2,22E+006
//       E2 format using es-ES culture:          2,22E+006
//       
//        F format using en-US culture:         2222402.00
//        F format using fr-FR culture:         2222402,00
//        F format using es-ES culture:         2222402,00
//       
//        N format using en-US culture:       2,222,402.00
//        N format using fr-FR culture:       2 222 402,00
//        N format using es-ES culture:       2.222.402,00
//       
//        P format using en-US culture:   222,240,200.00 %
//        P format using fr-FR culture:   222 240 200,00 %
//        P format using es-ES culture:   222.240.200,00 %
//       
//       X2 format using en-US culture:             21E942
//       X2 format using fr-FR culture:             21E942
//       X2 format using es-ES culture:             21E942
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 = 2222402

for specifier in specifiers do
    for culture in cultures do
        printfn $"{specifier,2} format using {culture.Name} culture: {value.ToString(specifier, culture), 18}"
    printfn ""
// The example displays the following output:
//        G format using en-US culture:            2222402
//        G format using fr-FR culture:            2222402
//        G format using es-ES culture:            2222402
//       
//        C format using en-US culture:      $2,222,402.00
//        C format using fr-FR culture:     2 222 402,00 €
//        C format using es-ES culture:     2.222.402,00 €
//       
//       D4 format using en-US culture:            2222402
//       D4 format using fr-FR culture:            2222402
//       D4 format using es-ES culture:            2222402
//       
//       E2 format using en-US culture:          2.22E+006
//       E2 format using fr-FR culture:          2,22E+006
//       E2 format using es-ES culture:          2,22E+006
//       
//        F format using en-US culture:         2222402.00
//        F format using fr-FR culture:         2222402,00
//        F format using es-ES culture:         2222402,00
//       
//        N format using en-US culture:       2,222,402.00
//        N format using fr-FR culture:       2 222 402,00
//        N format using es-ES culture:       2.222.402,00
//       
//        P format using en-US culture:   222,240,200.00 %
//        P format using fr-FR culture:   222 240 200,00 %
//        P format using es-ES culture:   222.240.200,00 %
//       
//       X2 format using en-US culture:             21E942
//       X2 format using fr-FR culture:             21E942
//       X2 format using es-ES culture:             21E942
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 UInteger = 2222402
      
      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}", _ 
                              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:            2222402
'        G format using fr-FR culture:            2222402
'        G format using es-ES culture:            2222402
'       
'        C format using en-US culture:      $2,222,402.00
'        C format using fr-FR culture:     2 222 402,00 €
'        C format using es-ES culture:     2.222.402,00 €
'       
'       D4 format using en-US culture:            2222402
'       D4 format using fr-FR culture:            2222402
'       D4 format using es-ES culture:            2222402
'       
'       E2 format using en-US culture:          2.22E+006
'       E2 format using fr-FR culture:          2,22E+006
'       E2 format using es-ES culture:          2,22E+006
'       
'        F format using en-US culture:         2222402.00
'        F format using fr-FR culture:         2222402,00
'        F format using es-ES culture:         2222402,00
'       
'        N format using en-US culture:       2,222,402.00
'        N format using fr-FR culture:       2 222 402,00
'        N format using es-ES culture:       2.222.402,00
'       
'        P format using en-US culture:   222,240,200.00 %
'        P format using fr-FR culture:   222 240 200,00 %
'        P format using es-ES culture:   222.240.200,00 %
'       
'       X2 format using en-US culture:             21E942
'       X2 format using fr-FR culture:             21E942
'       X2 format using es-ES culture:             21E942

Açıklamalar

ToString(String, IFormatProvider) yöntemi, belirtilen bir kültürün NumberFormatInfo nesnesini kullanarak bir UInt32 değerini belirtilen biçimde biçimlendirebilir. Varsayılan biçim veya kültür ayarlarını kullanmak istiyorsanız, ToString yönteminin diğer aşırı yüklemelerini 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)

parametresi,geçerli Standart Sayısal Biçim Dizeleri veyaÖzel Sayısal Biçim Dizelerinin herhangi bir bileşimi olabilir. format String.Empty eşitse veya nullise, geçerli UInt32 nesnesinin dönüş değeri genel biçim belirticisi ("G") ile biçimlendirilir. format başka bir değerse, 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:

provider parametresi IFormatProvider bir 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, provider parametresinin IFormatProvider.GetFormat yöntemini çağırır ve NumberFormatInfo türünü temsil eden bir Type nesnesi geçirir. GetFormat yöntemi, geçerli UInt32 değerini biçimlendirmek için grup ayırıcı simgesi veya ondalık nokta simgesi gibi bilgiler sağlayan NumberFormatInfo nesnesini döndürür. provider parametresini kullanarak ToString(String, IFormatProvider) yöntemine biçimlendirme bilgileri sağlamanın üç yolu vardır:

  • Biçimlendirme bilgileri sağlayan kültürü temsil eden bir CultureInfo nesnesi geçirebilirsiniz. GetFormat yöntemi, bu kültür için sayısal biçimlendirme bilgileri sağlayan NumberFormatInfo nesnesini döndürür.

  • Sayısal biçimlendirme bilgileri sağlayan gerçek NumberFormatInfo nesnesini geçirebilirsiniz. (GetFormat uygulaması yalnızca kendini döndürür.)

  • IFormatProvideruygulayan özel bir nesne geçirebilirsiniz. GetFormat yöntemi, biçimlendirme bilgileri sağlayan NumberFormatInfo nesnesini oluşturur ve döndürür.

provider nullise, döndürülen dizenin biçimlendirmesi geçerli kültürün NumberFormatInfo nesnesini temel alır.

Ayrıca bkz.

Şunlara uygulanır