İngilizce dilinde oku

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.

C#
public override string ToString ();

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.

C#
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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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.

C#
public string ToString (IFormatProvider provider);
C#
public string ToString (IFormatProvider? provider);

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.

C#
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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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.

C#
public string ToString (string format);
C#
public string ToString (string? format);

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.

C#
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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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.

C#
public string ToString (string format, IFormatProvider provider);
C#
public string ToString (string? format, IFormatProvider? provider);

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.

C#
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

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

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0