Convert.ToString Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Belirtilen değeri eşdeğer dize gösterimine dönüştürür.

Aşırı Yüklemeler

ToString(Int32, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 32 bit imzalı tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(Int16, Int32)	16 bit imzalı tamsayı değerini belirtilen tabandaki eşdeğer dize gösterimine dönüştürür.
ToString(DateTime, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen DateTime değerini eşdeğer dize gösterimine dönüştürür.
ToString(Double, IFormatProvider)	Belirtilen çift duyarlıklı kayan nokta sayısının değerini eşdeğer dize gösterimine dönüştürür.
ToString(Decimal, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen ondalık sayının değerini eşdeğer dize gösterimine dönüştürür.
ToString(Int32, Int32)	32 bit imzalı tamsayı değerini belirtilen tabandaki eşdeğer dize gösterimine dönüştürür.
ToString(Int16, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 16 bit imzalı tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(Int64, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 64 bit imzalı tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(Single, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen tek duyarlıklı kayan nokta sayısının değerini eşdeğer dize gösterimine dönüştürür.
ToString(Object, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen nesnenin değerini eşdeğer dize gösterimine dönüştürür.
ToString(SByte, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 8 bit imzalı tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(String, IFormatProvider)	Belirtilen dize örneğini döndürür; gerçek dönüştürme gerçekleştirilmemesi.
ToString(UInt16, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 16 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(UInt32, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 32 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(UInt64, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 64 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(Char, IFormatProvider)	Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen Unicode karakterinin değerini eşdeğer dize gösterimine dönüştürür.
ToString(Int64, Int32)	64 bit imzalı tamsayı değerini belirtilen tabandaki eşdeğer dize gösterimine dönüştürür.
ToString(Byte, Int32)	8 bit işaretsiz tamsayı değerini belirtilen tabandaki eşdeğer dize gösterimine dönüştürür.
ToString(Boolean, IFormatProvider)	Belirtilen Boole değerini eşdeğer dize gösterimine dönüştürür.
ToString(Byte, IFormatProvider)	Belirtilen 8 bit işaretsiz tamsayı değerini, belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.
ToString(Boolean)	Belirtilen Boole değerini eşdeğer dize gösterimine dönüştürür.
ToString(Byte)	Belirtilen 8 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(Char)	Belirtilen Unicode karakterinin değerini eşdeğer dize gösterimine dönüştürür.
ToString(DateTime)	Belirtilen DateTime değerini eşdeğer dize gösterimine dönüştürür.
ToString(Double)	Belirtilen çift duyarlıklı kayan nokta sayısının değerini eşdeğer dize gösterimine dönüştürür.
ToString(Int16)	Belirtilen 16 bit işaretli tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(Int32)	Belirtilen 32 bit işaretli tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(Decimal)	Belirtilen ondalık sayının değerini eşdeğer dize gösterimine dönüştürür.
ToString(Object)	Belirtilen nesnenin değerini eşdeğer dize gösterimine dönüştürür.
ToString(SByte)	Belirtilen 8 bit işaretli tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(Single)	Belirtilen tek duyarlıklı kayan nokta sayısının değerini eşdeğer dize gösterimine dönüştürür.
ToString(String)	Belirtilen dize örneğini döndürür; gerçek dönüştürme gerçekleştirilmemesi.
ToString(UInt16)	Belirtilen 16 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(UInt32)	Belirtilen 32 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(UInt64)	Belirtilen 64 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.
ToString(Int64)	Belirtilen 64 bit işaretli tamsayı değerini eşdeğer dize gösterimine dönüştürür.

ToString(Int32, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 32 bit imzalı tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (int value, IFormatProvider? provider);

Parametreler

value

Int32

Dönüştürülecek 32 bit işaretli tamsayı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, negatif işaretini "~" dizesi ve pozitif işaretini "!" dizesi olarak tanımlayan özel NumberFormatInfo bir sınıf tanımlar. Ardından bir tamsayı dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürmek için yöntemini çağırır ToString(Int32, IFormatProvider) . Dönüştürme, sabit kültürün yanı sıra özel NumberFormatInfo nesneyi de kullanır.

C#

int[] numbers = { Int32.MinValue, Int32.MaxValue};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

foreach (int number in numbers)
   Console.WriteLine("{0,-12}  -->  {1,12}",
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                     Convert.ToString(number, nfi));
// The example displays the following output:
//       -2147483648  -->  ~2147483648
//       2147483647  -->  2147483647

Açıklamalar

Bu uygulama ile Int32.ToString(IFormatProvider)aynıdır.

ToString(Int16, Int32)

Kaynak:

Convert.cs

16 bit imzalı tamsayı değerini belirtilen tabandaki eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (short value, int toBase);

Parametreler

value

Int16

Dönüştürülecek 16 bitlik işaretli tamsayı.

toBase

Int32

2, 8, 10 veya 16 olması gereken dönüş değeri tabanı.

Döndürülenler

String

tabanlı toBasedize gösterimivalue.

Özel durumlar

ArgumentException

toBase 2, 8, 10 veya 16 değildir.

Örnekler

Aşağıdaki örnek, 16 bit imzalı tamsayılar dizisindeki her öğeyi eşdeğer ikili, sekizli, ondalık ve onaltılık dize gösterimlerine dönüştürür.

C#

int[] bases = { 2, 8, 10, 16};
short[] numbers = { Int16.MinValue, -13621, -18, 12, 19142, Int16.MaxValue };

foreach (int baseValue in bases)
{
   Console.WriteLine("Base {0} conversion:", baseValue);
   foreach (short number in numbers)
   {
      Console.WriteLine("   {0,-8}  -->  0x{1}",
                        number, Convert.ToString(number, baseValue));
   }
}
// The example displays the following output:
//       Base 2 conversion:
//          -32768    -->  0x1000000000000000
//          -13621    -->  0x1100101011001011
//          -18       -->  0x1111111111101110
//          12        -->  0x1100
//          19142     -->  0x100101011000110
//          32767     -->  0x111111111111111
//       Base 8 conversion:
//          -32768    -->  0x100000
//          -13621    -->  0x145313
//          -18       -->  0x177756
//          12        -->  0x14
//          19142     -->  0x45306
//          32767     -->  0x77777
//       Base 10 conversion:
//          -32768    -->  0x-32768
//          -13621    -->  0x-13621
//          -18       -->  0x-18
//          12        -->  0x12
//          19142     -->  0x19142
//          32767     -->  0x32767
//       Base 16 conversion:
//          -32768    -->  0x8000
//          -13621    -->  0xcacb
//          -18       -->  0xffee
//          12        -->  0xc
//          19142     -->  0x4ac6
//          32767     -->  0x7fff

Açıklamalar

value Pozitifse ve toBase 2, 8 veya 16 ise, döndürülen dizede işaret ve büyüklük gösterimi kullanılır. value Negatifse ve toBase 2, 8 veya 16 ise, döndürülen dize ikinin tamamlayıcı gösterimini kullanır. Bu, yüksek sıralı baytın (bit 15) yüksek sıra bitinin işaret biti olarak yorumlandığı anlamına gelir. ToString(Int16, Int32) Daha sonra bir sayıya geri dönüştürülecek bir dize oluşturmak için yöntemi çağrılırsa, dönüştürmeyi gerçekleştirmek için benzer bir sayısal gösterim varsayan ilgili bir yöntem çağrılmalıdır. Bu tür yöntemler arasında ve Int16.Parse(String, NumberStyles)bulunurConvert.ToInt16(String, Int32).

ToString(DateTime, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen DateTime değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (DateTime value, IFormatProvider? provider);

Parametreler

value

DateTime

Dönüştürülecek tarih ve saat değeri.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, bir DateTime değeri sekiz farklı kültürde eşdeğer dize gösterimine dönüştürür.

C#

// Specify the date to be formatted using various cultures.
DateTime tDate = new DateTime(2010, 4, 15, 20, 30, 40, 333);
// Specify the cultures.
string[] cultureNames = { "en-US", "es-AR", "fr-FR", "hi-IN",
                          "ja-JP", "nl-NL", "ru-RU", "ur-PK" };

Console.WriteLine("Converting the date {0}: ",
                  Convert.ToString(tDate,
                          System.Globalization.CultureInfo.InvariantCulture));

foreach (string cultureName in cultureNames)
{
   System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
   string dateString = Convert.ToString(tDate, culture);
   Console.WriteLine("   {0}:  {1,-12}",
                     culture.Name, dateString);
}
// The example displays the following output:
//       Converting the date 04/15/2010 20:30:40:
//          en-US:  4/15/2010 8:30:40 PM
//          es-AR:  15/04/2010 08:30:40 p.m.
//          fr-FR:  15/04/2010 20:30:40
//          hi-IN:  15-04-2010 20:30:40
//          ja-JP:  2010/04/15 20:30:40
//          nl-NL:  15-4-2010 20:30:40
//          ru-RU:  15.04.2010 20:30:40
//          ur-PK:  15/04/2010 8:30:40 PM

Açıklamalar

Bu uygulama ile DateTime.ToString(IFormatProvider)aynıdır.

ToString(Double, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen çift duyarlıklı kayan nokta sayısının değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (double value, IFormatProvider? provider);

Parametreler

value

Double

Dönüştürülecek çift duyarlıklı kayan nokta sayısı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki Double her öğeyi dört farklı kültürdeki eşdeğer dize gösterimine dönüştürür.

C#

// Define an array of numbers to display.
double[] numbers = { -1.5345e16, -123.4321, 19092.123, 1.1734231911290e16 };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR", "ja-JP", "ru-RU" };

foreach (double number in numbers)
{
   Console.WriteLine("{0}:", Convert.ToString(number,
                             System.Globalization.CultureInfo.InvariantCulture));
   foreach (string cultureName in cultureNames)
   {
      System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
      Console.WriteLine("   {0}: {1,20}",
                        culture.Name, Convert.ToString(number, culture));
   }
   Console.WriteLine();
}
// The example displays the following output:
//    -1.5345E+16:
//       en-US:          -1.5345E+16
//       fr-FR:          -1,5345E+16
//       ja-JP:          -1.5345E+16
//       ru-RU:          -1,5345E+16
//
//    -123.4321:
//       en-US:            -123.4321
//       fr-FR:            -123,4321
//       ja-JP:            -123.4321
//       ru-RU:            -123,4321
//
//    19092.123:
//       en-US:            19092.123
//       fr-FR:            19092,123
//       ja-JP:            19092.123
//       ru-RU:            19092,123
//
//    1.173423191129E+16:
//       en-US:   1.173423191129E+16
//       fr-FR:   1,173423191129E+16
//       ja-JP:   1.173423191129E+16
//       ru-RU:   1,173423191129E+16

Açıklamalar

Bu uygulama ile aynıdır Double.ToString(IFormatProvider)

ToString(Decimal, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen ondalık sayının değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (decimal value, IFormatProvider? provider);

Parametreler

value

Decimal

Dönüştürülecek ondalık sayı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki Decimal her öğeyi dört farklı kültürdeki eşdeğer dize gösterimine dönüştürür.

C#

// Define an array of numbers to display.
decimal[] numbers = { 1734231911290.16m, -17394.32921m,
                      3193.23m, 98012368321.684m };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR", "ja-JP", "ru-RU" };

foreach (decimal number in numbers)
{
   Console.WriteLine("{0}:", Convert.ToString(number,
                             System.Globalization.CultureInfo.InvariantCulture));
   foreach (string cultureName in cultureNames)
   {
      System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
      Console.WriteLine("   {0}: {1,20}",
                        culture.Name, Convert.ToString(number, culture));
   }
   Console.WriteLine();
}
// The example displays the following output:
//    1734231911290.16:
//       en-US:     1734231911290.16
//       fr-FR:     1734231911290,16
//       ja-JP:     1734231911290.16
//       ru-RU:     1734231911290,16
//
//    -17394.32921:
//       en-US:         -17394.32921
//       fr-FR:         -17394,32921
//       ja-JP:         -17394.32921
//       ru-RU:         -17394,32921
//
//    3193.23:
//       en-US:              3193.23
//       fr-FR:              3193,23
//       ja-JP:              3193.23
//       ru-RU:              3193,23
//
//    98012368321.684:
//       en-US:      98012368321.684
//       fr-FR:      98012368321,684
//       ja-JP:      98012368321.684
//       ru-RU:      98012368321,684

Açıklamalar

Bu uygulama ile Decimal.ToString(IFormatProvider)aynıdır.

ToString(Int32, Int32)

Kaynak:

Convert.cs

32 bit imzalı tamsayı değerini belirtilen tabandaki eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (int value, int toBase);

Parametreler

value

Int32

Dönüştürülecek 32 bit işaretli tamsayı.

toBase

Int32

2, 8, 10 veya 16 olması gereken dönüş değeri tabanı.

Döndürülenler

String

tabanlı toBasedize gösterimivalue.

Özel durumlar

ArgumentException

toBase 2, 8, 10 veya 16 değildir.

Örnekler

Aşağıdaki örnek, bir tamsayı dizisindeki her öğeyi eşdeğer ikili, onaltılık, ondalık ve onaltılık dize gösterimlerine dönüştürür.

C#

int[] bases = { 2, 8, 10, 16};
int[] numbers = { Int32.MinValue, -19327543, -13621, -18, 12,
                             19142, Int32.MaxValue };

foreach (int baseValue in bases)
{
   Console.WriteLine("Base {0} conversion:", baseValue);
   foreach (int number in numbers)
   {
      Console.WriteLine("   {0,-15}  -->  0x{1}",
                        number, Convert.ToString(number, baseValue));
   }
}
// The example displays the following output:
//    Base 2 conversion:
//       -2147483648      -->  0x10000000000000000000000000000000
//       -19327543        -->  0x11111110110110010001010111001001
//       -13621           -->  0x11111111111111111100101011001011
//       -18              -->  0x11111111111111111111111111101110
//       12               -->  0x1100
//       19142            -->  0x100101011000110
//       2147483647       -->  0x1111111111111111111111111111111
//    Base 8 conversion:
//       -2147483648      -->  0x20000000000
//       -19327543        -->  0x37666212711
//       -13621           -->  0x37777745313
//       -18              -->  0x37777777756
//       12               -->  0x14
//       19142            -->  0x45306
//       2147483647       -->  0x17777777777
//    Base 10 conversion:
//       -2147483648      -->  0x-2147483648
//       -19327543        -->  0x-19327543
//       -13621           -->  0x-13621
//       -18              -->  0x-18
//       12               -->  0x12
//       19142            -->  0x19142
//       2147483647       -->  0x2147483647
//    Base 16 conversion:
//       -2147483648      -->  0x80000000
//       -19327543        -->  0xfed915c9
//       -13621           -->  0xffffcacb
//       -18              -->  0xffffffee
//       12               -->  0xc
//       19142            -->  0x4ac6
//       2147483647       -->  0x7fffffff

Açıklamalar

value Pozitifse ve toBase 2, 8 veya 16 ise, döndürülen dizede işaret ve büyüklük gösterimi kullanılır. value Negatifse ve toBase 2, 8 veya 16 ise, döndürülen dize ikinin tamamlayıcı gösterimini kullanır. Bu, en yüksek sıralı baytın (bit 31) yüksek sıra bitinin işaret biti olarak yorumlandığı anlamına gelir. ToString(Int32, Int32) Daha sonra bir sayıya geri dönüştürülecek bir dize oluşturmak için yöntemi çağrılırsa, dönüştürmeyi gerçekleştirmek için benzer bir sayısal gösterim varsayan ilgili bir yöntem çağrılmalıdır. Bu tür yöntemler arasında ve Int32.Parse(String, NumberStyles)bulunurConvert.ToInt32(String, Int32).

ToString(Int16, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 16 bit imzalı tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (short value, IFormatProvider? provider);

Parametreler

value

Int16

Dönüştürülecek 16 bitlik işaretli tamsayı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, negatif işaretini "~" dizesi ve pozitif işaretini "!" dizesi olarak tanımlayan özel NumberFormatInfo bir sınıf tanımlar. Ardından, 16 bitlik bir tamsayı dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürmek için yöntemini çağırır ToString(Int16, IFormatProvider) . Dönüştürme, sabit kültürün yanı sıra özel NumberFormatInfo nesneyi de kullanır.

C#

short[] numbers = { Int16.MinValue, Int16.MaxValue};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

foreach (short number in numbers)
   Console.WriteLine("{0,-8}  -->  {1,8}",
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                     Convert.ToString(number, nfi));
// The example displays the following output:
//       -32768    -->    ~32768
//       32767     -->     32767

Açıklamalar

Bu uygulama ile Int16.ToString(IFormatProvider)aynıdır.

ToString(Int64, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 64 bit imzalı tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (long value, IFormatProvider? provider);

Parametreler

value

Int64

Dönüştürülecek 64 bit işaretli tamsayı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, negatif işaretini "~" dizesi ve pozitif işaretini "!" dizesi olarak tanımlayan özel NumberFormatInfo bir sınıf tanımlar. Ardından, uzun bir tamsayı dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürmek için yöntemini çağırır ToString(Int64, IFormatProvider) . Dönüştürme, sabit kültürün yanı sıra özel NumberFormatInfo nesneyi de kullanır.

C#

long[] numbers = { ((long) Int32.MinValue) * 2, ((long) Int32.MaxValue) * 2};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

foreach (long number in numbers)
   Console.WriteLine("{0,-12}  -->  {1,12}",
                     Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                     Convert.ToString(number, nfi));
// The example displays the following output:
//       -4294967296  -->  ~4294967296
//       4294967294  -->  4294967294

Açıklamalar

Bu uygulama ile Int64.ToString(IFormatProvider)aynıdır.

ToString(Single, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen tek duyarlıklı kayan nokta sayısının değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (float value, IFormatProvider? provider);

Parametreler

value

Single

Dönüştürülecek tek duyarlıklı kayan nokta sayısı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki Single her öğeyi dört farklı kültürdeki eşdeğer dize gösterimine dönüştürür.

C#

// Define an array of numbers to display.
float[] numbers = { -1.5345e16f, -123.4321f, 19092.123f, 1.1734231911290e16f };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR", "ja-JP", "ru-RU" };

foreach (float number in numbers)
{
   Console.WriteLine("{0}:", Convert.ToString(number,
                             System.Globalization.CultureInfo.InvariantCulture));
   foreach (string cultureName in cultureNames)
   {
      System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
      Console.WriteLine("   {0}: {1,20}",
                        culture.Name, Convert.ToString(number, culture));
   }
   Console.WriteLine();
}
// The example displays the following output:
//    -1.5345E+16:
//       en-US:          -1.5345E+16
//       fr-FR:          -1,5345E+16
//       ja-JP:          -1.5345E+16
//       ru-RU:          -1,5345E+16
//
//    -123.4321:
//       en-US:            -123.4321
//       fr-FR:            -123,4321
//       ja-JP:            -123.4321
//       ru-RU:            -123,4321
//
//    19092.123:
//       en-US:            19092.123
//       fr-FR:            19092,123
//       ja-JP:            19092.123
//       ru-RU:            19092,123
//
//    1.173423191129E+16:
//       en-US:   1.173423191129E+16
//       fr-FR:   1,173423191129E+16
//       ja-JP:   1.173423191129E+16
//       ru-RU:   1,173423191129E+16

Açıklamalar

Bu uygulama ile Single.ToString(IFormatProvider)aynıdır.

ToString(Object, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen nesnenin değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string? ToString (object? value, IFormatProvider? provider);

Parametreler

value

Object

Dönüştürülecek değeri sağlayan bir nesne veya null.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi valueveya değeri olan bir nesneyse valuenull.Empty ise valuenullyöntemi döndürür null.

Örnekler

Aşağıdaki örnek, yöntemini geçersiz kılan ancak arabirimini uygulamayan Object.ToStringIConvertible bir Temperature sınıf tanımlar. Örnekte yöntemine çağrıların Convert.ToString(Object, IFormatProvider) sırayla yöntemini nasıl çağıracakları gösterilmektedir Temperature.ToString .

C#

using System;

public class Temperature
{
   private decimal m_Temp;

   public Temperature(decimal temperature)
   {
      this.m_Temp = temperature;
   }

   public decimal Celsius
   {
      get { return this.m_Temp; }
   }

   public decimal Kelvin
   {
      get { return this.m_Temp + 273.15m; }
   }

   public decimal Fahrenheit
   {
      get { return Math.Round((decimal) (this.m_Temp * 9 / 5 + 32), 2); }
   }

   public override string ToString()
   {
      return m_Temp.ToString("N2") + " °C";
   }
}

public class Example
{
   public static void Main()
   {
      Temperature cold = new Temperature(-40);
      Temperature freezing = new Temperature(0);
      Temperature boiling = new Temperature(100);

      Console.WriteLine(Convert.ToString(cold, null));
      Console.WriteLine(Convert.ToString(freezing, null));
      Console.WriteLine(Convert.ToString(boiling, null));
   }
}
// The example dosplays the following output:
//       -40.00 °C
//       0.00 °C
//       100.00 °C

Aşağıdaki örnek, arabirimini uygulayan ancak arabirimini uygulamayan IFormattableIConvertible bir Temperature sınıf tanımlar. Uygulaması IFormattable.ToString , biçim dizesine Temperature bağlı olarak Celsius, Fahrenheit veya Kelvin'deki değeri temsil eder. Örnek ayrıca sınıfın uygulanması Temperature tarafından IFormattable kullanılan rastgele oluşturulmuş bir biçim dizesi uygulayan IFormatProvider ve sağlayan bir sınıfı tanımlarTemperatureProvider.

C#

using System;

public class Temperature : IFormattable
{
   private decimal m_Temp;

   public Temperature(decimal temperature)
   {
      this.m_Temp = temperature;
   }

   public decimal Celsius
   { get { return this.m_Temp; } }

   public decimal Kelvin
   { get { return this.m_Temp + 273.15m; } }

   public decimal Fahrenheit
   {  get { return Math.Round(this.m_Temp * 9m / 5m + 32m, 2); } }

   public override String ToString()
   {
      return ToString("G", null);
   }

   public String ToString(String fmt, IFormatProvider provider)
   {
      TemperatureProvider formatter = null;
      if (provider != null)
         formatter = provider.GetFormat(typeof(TemperatureProvider))
                                       as TemperatureProvider;

      if (String.IsNullOrWhiteSpace(fmt)) {
         if (formatter != null)
            fmt = formatter.Format;
         else
            fmt = "G";
      }

      switch (fmt.ToUpper()) {
         case "G":
         case "C":
            return m_Temp.ToString("N2") + " °C";
         case "F":
            return Fahrenheit.ToString("N2") + " °F";
         case "K":
            return Kelvin.ToString("N2") + " K";
         default:
            throw new FormatException(String.Format("'{0}' is not a valid format specifier.", fmt));
      }
   }
}

public class TemperatureProvider : IFormatProvider
{
   private String[] fmtStrings = { "C", "G", "F", "K" };
   private Random rnd = new Random();

   public Object GetFormat(Type formatType)
   {
      return this;
   }

   public String Format
   { get { return fmtStrings[rnd.Next(0, fmtStrings.Length)]; } }
}

public class Example
{
   public static void Main()
   {
      Temperature cold = new Temperature (-40);
      Temperature freezing = new Temperature (0);
      Temperature boiling = new Temperature (100);

      TemperatureProvider tp = new TemperatureProvider();

      Console.WriteLine(Convert.ToString(cold, tp));
      Console.WriteLine(Convert.ToString(freezing, tp));
      Console.WriteLine(Convert.ToString(boiling, tp));
   }
}
// The example displays output like the following:
//       -40.00 °C
//       273.15 K
//       100.00 °C

Açıklamalar

value parametresi arabirimini IConvertible uygularsa, yöntemi uygulamasını valueçağırırIConvertible.ToString(IFormatProvider). Aksi takdirde, parametresi arabirimini uygularsa valueIFormattable , yöntemi onun IFormattable.ToString(String, IFormatProvider) uygulamasını çağırır. Herhangi bir arabirim uygulanmazsa value , yöntemi parametresinin valueToString() yöntemini çağırır ve provider parametresi yoksayılır.

provider parametresi veya IFormattable arabirimini value uyguluyorsa IConvertible parametresi kullanılır. parametresinin provider en yaygın kullanımı, dönüştürmesinde kullanılan kültüre özgü bilgileri belirtmektir value. Örneğin, parametre negatif bir ondalık sayıysa value , provider parametre negatif işareti ve ondalık ayırıcısı için kullanılan gösterimi hakkında kültüre özgü bilgiler sağlayabilir. Sonraki bölümdeki ikinci örnekte kültüre duyarlı biçimlendirme bilgileri vermeyen bir biçim sağlayıcısı gösterilmektedir.

ToString(SByte, IFormatProvider)

Kaynak:

Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 8 bit imzalı tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

[System.CLSCompliant(false)]
public static string ToString (sbyte value, IFormatProvider? provider);

Parametreler

value

SByte

Dönüştürülecek 8 bit işaretli tamsayı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Öznitelikler

CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, negatif işaretini "~" dizesi ve pozitif işaretini "!" dizesi olarak tanımlayan özel NumberFormatInfo bir sınıf tanımlar. Ardından, imzalı bayt dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürmek için yöntemini çağırır Convert.ToString(SByte, IFormatProvider) . Dönüştürme, sabit kültürün yanı sıra özel NumberFormatInfo nesneyi de kullanır.

C#

sbyte[] numbers = { SByte.MinValue, -12, 17, SByte.MaxValue};
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";
foreach (sbyte number in numbers)
   Console.WriteLine(Convert.ToString(number, nfi));
// The example displays the following output:
//       ~128
//       ~12
//       17
//       127

Açıklamalar

Bu uygulama ile SByte.ToString(IFormatProvider)aynıdır.

ToString(String, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen dize örneğini döndürür; gerçek dönüştürme gerçekleştirilmemesi.

C#

public static string? ToString (string? value, IFormatProvider? provider);

Parametreler

value

String

Döndürülecek dize.

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan nesne. Bu parametre yoksayıldı.

Döndürülenler

String

value değiştirilmeden döndürülür.

Örnekler

Aşağıdaki örnek yöntemini bir String parametresiyle çağırırToString. yöntemi, nesneye başvurmadan değiştirilmemiş String değerini IFormatProvider döndürür.

C#

// Example of Convert.ToString( non-numeric types, IFormatProvider ).
using System;
using System.Globalization;

// An instance of this class can be passed to methods that require
// an IFormatProvider.
public class DummyProvider : IFormatProvider
{
    // Normally, GetFormat returns an object of the requested type
    // (usually itself) if it is able; otherwise, it returns Nothing.
    public object GetFormat( Type argType )
    {
        // Here, the type of argType is displayed, and GetFormat
        // always returns Nothing.
        Console.Write( "{0,-40}", argType.ToString( ) );
        return null;
    }
}

class ConvertNonNumericProviderDemo
{
    static void Main( )
    {
        // Create an instance of the IFormatProvider.
        DummyProvider provider = new DummyProvider( );
        string converted;

        // Convert these values using DummyProvider.
        int      Int32A     = -252645135;
        double   DoubleA    = 61680.3855;
        object   ObjDouble  = (object)( -98765.4321 );
        DateTime DayTimeA   = new DateTime( 2001, 9, 11, 13, 45, 0 );

        bool     BoolA      = true;
        string   StringA    = "Qwerty";
        char     CharA      = '$';
        TimeSpan TSpanA     = new TimeSpan( 0, 18, 0 );
        object   ObjOther   = (object)provider;

        Console.WriteLine( "This example of " +
            "Convert.ToString( non-numeric, IFormatProvider ) \n" +
            "generates the following output. The provider type, " +
            "argument type, \nand argument value are displayed." );
        Console.WriteLine( "\nNote: The IFormatProvider object is " +
            "not called for Boolean, String, \nChar, TimeSpan, " +
            "and non-numeric Object." );

        // The format provider is called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( Int32A, provider );
        Console.WriteLine( "int      {0}", converted );
        converted = Convert.ToString( DoubleA, provider );
        Console.WriteLine( "double   {0}", converted );
        converted = Convert.ToString( ObjDouble, provider );
        Console.WriteLine( "object   {0}", converted );
        converted = Convert.ToString( DayTimeA, provider );
        Console.WriteLine( "DateTime {0}", converted );

        // The format provider is not called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( BoolA, provider );
        Console.WriteLine( "bool     {0}", converted );
        converted = Convert.ToString( StringA, provider );
        Console.WriteLine( "string   {0}", converted );
        converted = Convert.ToString( CharA, provider );
        Console.WriteLine( "char     {0}", converted );
        converted = Convert.ToString( TSpanA, provider );
        Console.WriteLine( "TimeSpan {0}", converted );
        converted = Convert.ToString( ObjOther, provider );
        Console.WriteLine( "object   {0}", converted );
    }
}

/*
This example of Convert.ToString( non-numeric, IFormatProvider )
generates the following output. The provider type, argument type,
and argument value are displayed.

Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.

System.Globalization.NumberFormatInfo   int      -252645135
System.Globalization.NumberFormatInfo   double   61680.3855
System.Globalization.NumberFormatInfo   object   -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM

bool     True
string   Qwerty
char     $
TimeSpan 00:18:00
object   DummyProvider

*/

ToString(UInt16, IFormatProvider)

Kaynak:

Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 16 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

[System.CLSCompliant(false)]
public static string ToString (ushort value, IFormatProvider? provider);

Parametreler

value

UInt16

Dönüştürülecek 16 bitlik işaretsiz tamsayı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Öznitelikler

CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, negatif işaretini "~" dizesi ve pozitif işaretini "!" dizesi olarak tanımlayan özel NumberFormatInfo bir sınıf tanımlar. Ardından 16 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürmek için yöntemini çağırır ToString(UInt16, IFormatProvider) . Dönüştürme hem sabit kültürü hem de özel NumberFormatInfo nesneyi kullanır. Varsayılan olarak "G" biçim tanımlayıcısı pozitif değerlerle pozitif bir işaret içermediğinden, çıkış bu biçimlendirme bilgilerinin kullanılmadığını gösterir.

C#

ushort number = UInt16.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

Console.WriteLine("{0,-6}  -->  {1,6}",
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                  Convert.ToString(number, nfi));
// The example displays the following output:
//       65535   -->   65535

Açıklamalar

Bu uygulama ile UInt16.ToString(IFormatProvider)aynıdır.

ToString(UInt32, IFormatProvider)

Kaynak:

Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 32 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

[System.CLSCompliant(false)]
public static string ToString (uint value, IFormatProvider? provider);

Parametreler

value

UInt32

Dönüştürülecek 32 bit işaretsiz tamsayı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Öznitelikler

CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, negatif işaretini "~" dizesi ve pozitif işaretini "!" dizesi olarak tanımlayan özel NumberFormatInfo bir sınıf tanımlar. Ardından, imzalanmamış bir tamsayı değerini eşdeğer dize gösterimine dönüştürmek için yöntemini çağırır ToString(UInt32, IFormatProvider) . Dönüştürme hem sabit kültürü hem de özel NumberFormatInfo nesneyi kullanır. Varsayılan olarak "G" biçim tanımlayıcısı pozitif değerlerle pozitif bir işaret içermediğinden, çıkış bu biçimlendirme bilgilerinin kullanılmadığını gösterir.

C#

uint number = UInt32.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

Console.WriteLine("{0,-8}  -->  {1,8}",
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                  Convert.ToString(number, nfi));
// The example displays the following output:
//       4294967295  -->  4294967295

Açıklamalar

Bu uygulama ile UInt32.ToString(IFormatProvider)aynıdır.

ToString(UInt64, IFormatProvider)

Kaynak:

Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen 64 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

[System.CLSCompliant(false)]
public static string ToString (ulong value, IFormatProvider? provider);

Parametreler

value

UInt64

Dönüştürülecek 64 bit işaretsiz tamsayı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Öznitelikler

CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, negatif işaretini "~" dizesi ve pozitif işaretini "!" dizesi olarak tanımlayan özel NumberFormatInfo bir sınıf tanımlar. Ardından, işaretsiz bir uzun tamsayı değerini eşdeğer dize gösterimine dönüştürmek için yöntemini çağırır ToString(UInt64, IFormatProvider) . Dönüştürme hem sabit kültürü hem de özel NumberFormatInfo nesneyi kullanır. Varsayılan olarak "G" biçim tanımlayıcısı pozitif değerlerle pozitif bir işaret içermediğinden, çıkış bu biçimlendirme bilgilerinin kullanılmadığını gösterir.

C#

ulong number = UInt64.MaxValue;
System.Globalization.NumberFormatInfo nfi = new System.Globalization.NumberFormatInfo();
nfi.NegativeSign = "~";
nfi.PositiveSign = "!";

Console.WriteLine("{0,-12}  -->  {1,12}",
                  Convert.ToString(number, System.Globalization.CultureInfo.InvariantCulture),
                  Convert.ToString(number, nfi));
// The example displays the following output:
//    18446744073709551615  -->  18446744073709551615

Açıklamalar

Bu uygulama ile UInt64.ToString(IFormatProvider)aynıdır.

ToString(Char, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak belirtilen Unicode karakterinin değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (char value, IFormatProvider? provider);

Parametreler

value

Char

Dönüştürülecek Unicode karakteri.

provider

IFormatProvider

Kültüre özgü biçimlendirme bilgileri sağlayan nesne. Bu parametre yoksayıldı.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, çağrıldığı biçim sağlayıcısının türünü görüntüleyen bir nesne kullanarak yöntemini kullanarak bir değeri String yöntemiyle ToString değerine dönüştürür CharIFormatProvider. Örnekte nesneye IFormatProvider başvurulmuyor.

C#

// Example of Convert.ToString( non-numeric types, IFormatProvider ).
using System;
using System.Globalization;

// An instance of this class can be passed to methods that require
// an IFormatProvider.
public class DummyProvider : IFormatProvider
{
    // Normally, GetFormat returns an object of the requested type
    // (usually itself) if it is able; otherwise, it returns Nothing.
    public object GetFormat( Type argType )
    {
        // Here, the type of argType is displayed, and GetFormat
        // always returns Nothing.
        Console.Write( "{0,-40}", argType.ToString( ) );
        return null;
    }
}

class ConvertNonNumericProviderDemo
{
    static void Main( )
    {
        // Create an instance of the IFormatProvider.
        DummyProvider provider = new DummyProvider( );
        string converted;

        // Convert these values using DummyProvider.
        int      Int32A     = -252645135;
        double   DoubleA    = 61680.3855;
        object   ObjDouble  = (object)( -98765.4321 );
        DateTime DayTimeA   = new DateTime( 2001, 9, 11, 13, 45, 0 );

        bool     BoolA      = true;
        string   StringA    = "Qwerty";
        char     CharA      = '$';
        TimeSpan TSpanA     = new TimeSpan( 0, 18, 0 );
        object   ObjOther   = (object)provider;

        Console.WriteLine( "This example of " +
            "Convert.ToString( non-numeric, IFormatProvider ) \n" +
            "generates the following output. The provider type, " +
            "argument type, \nand argument value are displayed." );
        Console.WriteLine( "\nNote: The IFormatProvider object is " +
            "not called for Boolean, String, \nChar, TimeSpan, " +
            "and non-numeric Object." );

        // The format provider is called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( Int32A, provider );
        Console.WriteLine( "int      {0}", converted );
        converted = Convert.ToString( DoubleA, provider );
        Console.WriteLine( "double   {0}", converted );
        converted = Convert.ToString( ObjDouble, provider );
        Console.WriteLine( "object   {0}", converted );
        converted = Convert.ToString( DayTimeA, provider );
        Console.WriteLine( "DateTime {0}", converted );

        // The format provider is not called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( BoolA, provider );
        Console.WriteLine( "bool     {0}", converted );
        converted = Convert.ToString( StringA, provider );
        Console.WriteLine( "string   {0}", converted );
        converted = Convert.ToString( CharA, provider );
        Console.WriteLine( "char     {0}", converted );
        converted = Convert.ToString( TSpanA, provider );
        Console.WriteLine( "TimeSpan {0}", converted );
        converted = Convert.ToString( ObjOther, provider );
        Console.WriteLine( "object   {0}", converted );
    }
}

/*
This example of Convert.ToString( non-numeric, IFormatProvider )
generates the following output. The provider type, argument type,
and argument value are displayed.

Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.

System.Globalization.NumberFormatInfo   int      -252645135
System.Globalization.NumberFormatInfo   double   61680.3855
System.Globalization.NumberFormatInfo   object   -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM

bool     True
string   Qwerty
char     $
TimeSpan 00:18:00
object   DummyProvider

*/

Açıklamalar

Bu uygulama ile Char.ToString()aynıdır. provider parametresi yoksayılır.

ToString(Int64, Int32)

Kaynak:

Convert.cs

64 bit imzalı tamsayı değerini belirtilen tabandaki eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (long value, int toBase);

Parametreler

value

Int64

Dönüştürülecek 64 bit işaretli tamsayı.

toBase

Int32

2, 8, 10 veya 16 olması gereken dönüş değeri tabanı.

Döndürülenler

String

tabanlı toBasedize gösterimivalue.

Özel durumlar

ArgumentException

toBase 2, 8, 10 veya 16 değildir.

Örnekler

Aşağıdaki örnek, uzun bir tamsayı dizisindeki her öğeyi eşdeğer ikili, onaltılık, ondalık ve onaltılık dize gösterimlerine dönüştürür.

C#

int[] bases = { 2, 8, 10, 16};
long[] numbers = { Int64.MinValue, -193275430, -13621, -18, 12,
                   1914206117, Int64.MaxValue };

foreach (int baseValue in bases)
{
   Console.WriteLine("Base {0} conversion:", baseValue);
   foreach (long number in numbers)
   {
      Console.WriteLine("   {0,-23}  -->  0x{1}",
                        number, Convert.ToString(number, baseValue));
   }
}
// The example displays the following output:
//    Base 2 conversion:
//       -9223372036854775808     -->  0x1000000000000000000000000000000000000000000000000000000000000000
//       -193275430               -->  0x1111111111111111111111111111111111110100011110101101100111011010
//       -13621                   -->  0x1111111111111111111111111111111111111111111111111100101011001011
//       -18                      -->  0x1111111111111111111111111111111111111111111111111111111111101110
//       12                       -->  0x1100
//       1914206117               -->  0x1110010000110000111011110100101
//       9223372036854775807      -->  0x111111111111111111111111111111111111111111111111111111111111111
//    Base 8 conversion:
//       -9223372036854775808     -->  0x1000000000000000000000
//       -193275430               -->  0x1777777777776436554732
//       -13621                   -->  0x1777777777777777745313
//       -18                      -->  0x1777777777777777777756
//       12                       -->  0x14
//       1914206117               -->  0x16206073645
//       9223372036854775807      -->  0x777777777777777777777
//    Base 10 conversion:
//       -9223372036854775808     -->  0x-9223372036854775808
//       -193275430               -->  0x-193275430
//       -13621                   -->  0x-13621
//       -18                      -->  0x-18
//       12                       -->  0x12
//       1914206117               -->  0x1914206117
//       9223372036854775807      -->  0x9223372036854775807
//    Base 16 conversion:
//       -9223372036854775808     -->  0x8000000000000000
//       -193275430               -->  0xfffffffff47ad9da
//       -13621                   -->  0xffffffffffffcacb
//       -18                      -->  0xffffffffffffffee
//       12                       -->  0xc
//       1914206117               -->  0x721877a5
//       9223372036854775807      -->  0x7fffffffffffffff

Açıklamalar

value Pozitifse ve toBase 10 değilse, döndürülen dize sign-and-magnide gösterimini kullanır. Negatifse value ve toBase 10 değilse, döndürülen dize ikinin tamamlayıcı gösterimini kullanır. Bu, en yüksek sıralı baytın (bit 63) yüksek sıra bitinin işaret biti olarak yorumlandığı anlamına gelir. ToString(Int64, Int32) Daha sonra bir sayıya geri dönüştürülecek bir dize oluşturmak için yöntemi çağrılırsa, dönüştürmeyi gerçekleştirmek için benzer bir sayısal gösterim varsayan ilgili bir yöntem çağrılmalıdır. Bu tür yöntemler arasında ve Int64.Parse(String, NumberStyles)bulunurConvert.ToInt64(String, Int32).

ToString(Byte, Int32)

Kaynak:

Convert.cs

8 bit işaretsiz tamsayı değerini belirtilen tabandaki eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (byte value, int toBase);

Parametreler

value

Byte

Dönüştürülecek 8 bit işaretsiz tamsayı.

toBase

Int32

2, 8, 10 veya 16 olması gereken dönüş değeri tabanı.

Döndürülenler

String

tabanlı toBasedize gösterimivalue.

Özel durumlar

ArgumentException

toBase 2, 8, 10 veya 16 değildir.

Örnekler

Aşağıdaki örnek, bayt dizisindeki her öğeyi eşdeğer ikili, onaltılık, ondalık ve onaltılık dize gösterimlerine dönüştürür.

C#

int[] bases = { 2, 8, 10, 16};
byte[] numbers = { Byte.MinValue, 12, 103, Byte.MaxValue};

foreach (int baseValue in bases)
{
   Console.WriteLine("Base {0} conversion:", baseValue);
   foreach (byte number in numbers)
   {
      Console.WriteLine("   {0,-5}  -->  0x{1}",
                        number, Convert.ToString(number, baseValue));
   }
}
// The example displays the following output:
//       Base 2 conversion:
//          0      -->  0x0
//          12     -->  0x1100
//          103    -->  0x1100111
//          255    -->  0x11111111
//       Base 8 conversion:
//          0      -->  0x0
//          12     -->  0x14
//          103    -->  0x147
//          255    -->  0x377
//       Base 10 conversion:
//          0      -->  0x0
//          12     -->  0x12
//          103    -->  0x103
//          255    -->  0x255
//       Base 16 conversion:
//          0      -->  0x0
//          12     -->  0xc
//          103    -->  0x67
//          255    -->  0xff

Açıklamalar

10'a eşit değilse toBase , yöntemi tarafından Convert.ToString(Byte, Int32) döndürülen dize yalnızca büyüklüğüyle temsil eder value . Daha sonra bir sayıya geri dönüştürülecek bir dize oluşturmak için yöntemi çağrılırsa, dönüştürmeyi gerçekleştirmek için yalnızca büyük bir sayısal gösterim varsayan ilgili bir yöntem çağrılmalıdır. Bu tür yöntemler arasında veya Byte.Parse(String, NumberStyles)bulunurConvert.ToByte(String, Int32).

ToString(Boolean, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen Boole değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (bool value, IFormatProvider? provider);

Parametreler

value

Boolean

Dönüştürülecek Boole değeri.

provider

IFormatProvider

Bir nesnenin örneği. Bu parametre yoksayıldı.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, çağrıldığı biçim sağlayıcısının türünü görüntüleyen bir nesne kullanarak yöntemini kullanarak bir değeri String yöntemiyle ToString değerine dönüştürür BooleanIFormatProvider. Örnekte nesneye IFormatProvider başvurulmuyor.

C#

// Example of Convert.ToString( non-numeric types, IFormatProvider ).
using System;
using System.Globalization;

// An instance of this class can be passed to methods that require
// an IFormatProvider.
public class DummyProvider : IFormatProvider
{
    // Normally, GetFormat returns an object of the requested type
    // (usually itself) if it is able; otherwise, it returns Nothing.
    public object GetFormat( Type argType )
    {
        // Here, the type of argType is displayed, and GetFormat
        // always returns Nothing.
        Console.Write( "{0,-40}", argType.ToString( ) );
        return null;
    }
}

class ConvertNonNumericProviderDemo
{
    static void Main( )
    {
        // Create an instance of the IFormatProvider.
        DummyProvider provider = new DummyProvider( );
        string converted;

        // Convert these values using DummyProvider.
        int      Int32A     = -252645135;
        double   DoubleA    = 61680.3855;
        object   ObjDouble  = (object)( -98765.4321 );
        DateTime DayTimeA   = new DateTime( 2001, 9, 11, 13, 45, 0 );

        bool     BoolA      = true;
        string   StringA    = "Qwerty";
        char     CharA      = '$';
        TimeSpan TSpanA     = new TimeSpan( 0, 18, 0 );
        object   ObjOther   = (object)provider;

        Console.WriteLine( "This example of " +
            "Convert.ToString( non-numeric, IFormatProvider ) \n" +
            "generates the following output. The provider type, " +
            "argument type, \nand argument value are displayed." );
        Console.WriteLine( "\nNote: The IFormatProvider object is " +
            "not called for Boolean, String, \nChar, TimeSpan, " +
            "and non-numeric Object." );

        // The format provider is called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( Int32A, provider );
        Console.WriteLine( "int      {0}", converted );
        converted = Convert.ToString( DoubleA, provider );
        Console.WriteLine( "double   {0}", converted );
        converted = Convert.ToString( ObjDouble, provider );
        Console.WriteLine( "object   {0}", converted );
        converted = Convert.ToString( DayTimeA, provider );
        Console.WriteLine( "DateTime {0}", converted );

        // The format provider is not called for these conversions.
        Console.WriteLine( );
        converted = Convert.ToString( BoolA, provider );
        Console.WriteLine( "bool     {0}", converted );
        converted = Convert.ToString( StringA, provider );
        Console.WriteLine( "string   {0}", converted );
        converted = Convert.ToString( CharA, provider );
        Console.WriteLine( "char     {0}", converted );
        converted = Convert.ToString( TSpanA, provider );
        Console.WriteLine( "TimeSpan {0}", converted );
        converted = Convert.ToString( ObjOther, provider );
        Console.WriteLine( "object   {0}", converted );
    }
}

/*
This example of Convert.ToString( non-numeric, IFormatProvider )
generates the following output. The provider type, argument type,
and argument value are displayed.

Note: The IFormatProvider object is not called for Boolean, String,
Char, TimeSpan, and non-numeric Object.

System.Globalization.NumberFormatInfo   int      -252645135
System.Globalization.NumberFormatInfo   double   61680.3855
System.Globalization.NumberFormatInfo   object   -98765.4321
System.Globalization.DateTimeFormatInfo DateTime 9/11/2001 1:45:00 PM

bool     True
string   Qwerty
char     $
TimeSpan 00:18:00
object   DummyProvider

*/

Açıklamalar

Bu uygulama ile Boolean.ToStringaynıdır. Değerler ve trueBoolean.FalseString değerler için false döndürürBoolean.TrueString.

ToString(Byte, IFormatProvider)

Kaynak:

Convert.cs

Belirtilen 8 bit işaretsiz tamsayı değerini, belirtilen kültüre özgü biçimlendirme bilgilerini kullanarak eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (byte value, IFormatProvider? provider);

Parametreler

value

Byte

Dönüştürülecek 8 bit işaretsiz tamsayı.

provider

IFormatProvider

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

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, en-US ve fr-FR kültürlerinin biçimlendirme kurallarını kullanarak işaretsiz bir bayt dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürür. Varsayılan olarak "G" tanımlayıcısı bayt değerinin dize gösteriminde yalnızca ondalık basamaklar oluşturduğundan, provider parametre döndürülen dizenin biçimlendirmesini etkilemez.

C#

byte[] numbers = { 12, 100, Byte.MaxValue };
// Define the culture names used to display them.
string[] cultureNames = { "en-US", "fr-FR" };

foreach (byte number in numbers)
{
   Console.WriteLine("{0}:", Convert.ToString(number,
                             System.Globalization.CultureInfo.InvariantCulture));
   foreach (string cultureName in cultureNames)
   {
      System.Globalization.CultureInfo culture = new System.Globalization.CultureInfo(cultureName);
      Console.WriteLine("   {0}: {1,20}",
                        culture.Name, Convert.ToString(number, culture));
   }
   Console.WriteLine();
}
// The example displays the following output:
//       12:
//          en-US:                   12
//          fr-FR:                   12
//
//       100:
//          en-US:                  100
//          fr-FR:                  100
//
//       255:
//          en-US:                  255
//          fr-FR:                  255

Açıklamalar

Bu uygulama ile Byte.ToStringaynıdır.

ToString(Boolean)

Kaynak:

Convert.cs

Belirtilen Boole değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (bool value);

Parametreler

value

Boolean

Dönüştürülecek Boole değeri.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnekte kullanılarak ToStringbir Boolean öğesine dönüştürülmesi Stringgösterilmektedir. Ayrıca, dönüştürme tarafından döndürülen dizenin veya Boolean.FalseStringdeğerine eşit Boolean.TrueString olduğunu gösterir.

C#

bool falseFlag = false;
bool trueFlag = true;

Console.WriteLine(Convert.ToString(falseFlag));
Console.WriteLine(Convert.ToString(falseFlag).Equals(Boolean.FalseString));
Console.WriteLine(Convert.ToString(trueFlag));
Console.WriteLine(Convert.ToString(trueFlag).Equals(Boolean.TrueString));
// The example displays the following output:
//       False
//       True
//       True
//       True

Açıklamalar

Bu uygulama ile Boolean.ToStringaynıdır. Değerler ve trueBoolean.FalseString değerler için false döndürürBoolean.TrueString.

ToString(Byte)

Kaynak:

Convert.cs

Belirtilen 8 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (byte value);

Parametreler

value

Byte

Dönüştürülecek 8 bit işaretsiz tamsayı.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, bir Byte dizideki her değeri dizeye dönüştürür.

C#

using System;

public class Example
{
   public static void Main()
   {
      byte[] values = { Byte.MinValue, 12, 100, 179, Byte.MaxValue } ;

      foreach (var value in values)
         Console.WriteLine("{0,3} ({1}) --> {2}", value,
                           value.GetType().Name,
                           Convert.ToString(value));
   }
}
// The example displays the following output:
//       0 (Byte) --> 0
//      12 (Byte) --> 12
//     100 (Byte) --> 100
//     179 (Byte) --> 179
//     255 (Byte) --> 255

Açıklamalar

Bu uygulama ile Byte.ToString()aynıdır.

ToString(Char)

Kaynak:

Convert.cs

Belirtilen Unicode karakterinin değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (char value);

Parametreler

value

Char

Dönüştürülecek Unicode karakteri.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, öğesini öğesine CharStringdönüştürür.

C#

public void ConvertStringChar(string stringVal) {
    char charVal = 'a';

    // A string must be one character long to convert to char.
    try {
        charVal = System.Convert.ToChar(stringVal);
        System.Console.WriteLine("{0} as a char is {1}",
            stringVal, charVal);
    }
    catch (System.FormatException) {
        System.Console.WriteLine(
            "The string is longer than one character.");
    }
    catch (System.ArgumentNullException) {
        System.Console.WriteLine("The string is null.");
    }

    // A char to string conversion will always succeed.
    stringVal = System.Convert.ToString(charVal);
    System.Console.WriteLine("The character as a string is {0}",
            stringVal);
}

Açıklamalar

Bu uygulama ile Char.ToStringaynıdır.

ToString(DateTime)

Kaynak:

Convert.cs

Belirtilen DateTime değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (DateTime value);

Parametreler

value

DateTime

Dönüştürülecek tarih ve saat değeri.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki her öğeyi bir DateTimeString değere dönüştürür.

C#

DateTime[] dates = { new DateTime(2009, 7, 14),
                     new DateTime(1, 1, 1, 18, 32, 0),
                     new DateTime(2009, 2, 12, 7, 16, 0) };
string result;

foreach (DateTime dateValue in dates)
{
   result = Convert.ToString(dateValue);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        dateValue.GetType().Name, dateValue,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the DateTime value 7/14/2009 12:00:00 AM to a String value 7/14/2009 12:00:00 AM.
//    Converted the DateTime value 1/1/0001 06:32:00 PM to a String value 1/1/0001 06:32:00 PM.
//    Converted the DateTime value 2/12/2009 07:16:00 AM to a String value 2/12/2009 07:16:00 AM.

Açıklamalar

Bu uygulama ile DateTime.ToString()aynıdır. Bir değeri dize gösterimine dönüştürmek DateTime için geçerli kültürün biçimlendirme kurallarını ve "G" biçim tanımlayıcısını kullanır.

ToString(Double)

Kaynak:

Convert.cs

Belirtilen çift duyarlıklı kayan nokta sayısının değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (double value);

Parametreler

value

Double

Dönüştürülecek çift duyarlıklı kayan nokta sayısı.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, öğesini öğesine DoubleStringdönüştürür.

C#

public void ConvertDoubleString(double doubleVal) {
    
    string	stringVal;

    // A conversion from Double to string cannot overflow.
    stringVal = System.Convert.ToString(doubleVal);
    System.Console.WriteLine("{0} as a string is: {1}",
        doubleVal, stringVal);

    try {
        doubleVal = System.Convert.ToDouble(stringVal);
        System.Console.WriteLine("{0} as a double is: {1}",
            stringVal, doubleVal);
    }
    catch (System.OverflowException) {
        System.Console.WriteLine(
            "Conversion from string-to-double overflowed.");
    }
    catch (System.FormatException) {
        System.Console.WriteLine(
            "The string was not formatted as a double.");
    }
    catch (System.ArgumentException) {
        System.Console.WriteLine(
            "The string pointed to null.");
    }
}

Açıklamalar

Bu uygulama ile Double.ToString()aynıdır.

ToString(Int16)

Kaynak:

Convert.cs

Belirtilen 16 bit işaretli tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (short value);

Parametreler

value

Int16

Dönüştürülecek 16 bitlik işaretli tamsayı.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, 16 bitlik bir tamsayı dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürür.

C#

short[] numbers = { Int16.MinValue, -138, 0, 19, Int16.MaxValue };
string result;

foreach (short number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the Int16 value -32768 to the String value -32768.
//    Converted the Int16 value -138 to the String value -138.
//    Converted the Int16 value 0 to the String value 0.
//    Converted the Int16 value 19 to the String value 19.
//    Converted the Int16 value 32767 to the String value 32767.

Açıklamalar

Bu uygulama ile Int16.ToString()aynıdır.

ToString(Int32)

Kaynak:

Convert.cs

Belirtilen 32 bit işaretli tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (int value);

Parametreler

value

Int32

Dönüştürülecek 32 bit işaretli tamsayı.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek yöntemini yöntemiyle ToString(UInt16, IFormatProvider) karşılaştırırToString(Int32). Negatif işareti temsil etmek için "eksi" sokmasını kullanan özel NumberFormatInfo bir nesne tanımlar. Varsayılan biçimlendirmeyi (geçerli kültürün biçimlendirme kuralları) ve özel biçim sağlayıcısını kullanarak bir tamsayı dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürür.

C#

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Create a NumberFormatInfo object and set its NegativeSigns
      // property to use for integer formatting.
      NumberFormatInfo provider = new NumberFormatInfo();
      provider.NegativeSign = "minus ";

      int[] values = { -20, 0, 100 };

      Console.WriteLine("{0,-8} --> {1,10} {2,10}\n", "Value",
                         CultureInfo.CurrentCulture.Name,
                         "Custom");
      foreach (int value in values)
         Console.WriteLine("{0,-8} --> {1,10} {2,10}",
                           value, Convert.ToString(value),
                           Convert.ToString(value, provider));
      // The example displays output like the following:
      //       Value    -->      en-US     Custom
      //
      //       -20      -->        -20   minus 20
      //       0        -->          0          0
      //       100      -->        100        100
   }
}

Açıklamalar

Bu uygulama ile Int32.ToString()aynıdır. Geçerli kültürün biçimlendirme kurallarını kullanarak biçimlendirmektedir value .

ToString(Decimal)

Kaynak:

Convert.cs

Belirtilen ondalık sayının değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (decimal value);

Parametreler

value

Decimal

Dönüştürülecek ondalık sayı.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, öğesini öğesine DecimalStringdönüştürür.

C#

public void ConvertStringDecimal(string stringVal) {
    decimal decimalVal = 0;
    
    try {
        decimalVal = System.Convert.ToDecimal(stringVal);
        System.Console.WriteLine(
            "The string as a decimal is {0}.", decimalVal);
    }
    catch (System.OverflowException){
        System.Console.WriteLine(
            "The conversion from string to decimal overflowed.");
    }
    catch (System.FormatException) {
        System.Console.WriteLine(
            "The string is not formatted as a decimal.");
    }
    catch (System.ArgumentNullException) {
        System.Console.WriteLine(
            "The string is null.");
    }

    // Decimal to string conversion will not overflow.
    stringVal = System.Convert.ToString(decimalVal);
    System.Console.WriteLine(
        "The decimal as a string is {0}.", stringVal);
}

Açıklamalar

Bu uygulama ile Decimal.ToString()aynıdır.

ToString(Object)

Kaynak:

Convert.cs

Belirtilen nesnenin değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string? ToString (object? value);

Parametreler

value

Object

Dönüştürülecek değeri sağlayan bir nesne veya null.

Döndürülenler

String

dize gösterimi valueveya Empty ise valuenull.

Örnekler

Aşağıdaki örnek, bir nesne dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürür.

C#

object[] values = { false, 12.63m, new DateTime(2009, 6, 1, 6, 32, 15), 16.09e-12,
                    'Z', 15.15322, SByte.MinValue, Int32.MaxValue };
string result;

foreach (object value in values)
{
   result = Convert.ToString(value);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        value.GetType().Name, value,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the Boolean value False to the String value False.
//    Converted the Decimal value 12.63 to the String value 12.63.
//    Converted the DateTime value 6/1/2009 06:32:15 AM to the String value 6/1/2009 06:32:15 AM.
//    Converted the Double value 1.609E-11 to the String value 1.609E-11.
//    Converted the Char value Z to the String value Z.
//    Converted the Double value 15.15322 to the String value 15.15322.
//    Converted the SByte value -128 to the String value -128.
//    Converted the Int32 value 2147483647 to the String value 2147483647.

Açıklamalar

dize gösterimine dönüştürmek value için yöntemi uygulamasını valueçağırmaya IConvertible.ToString çalışır. arabirimini IConvertible uygulamazsa value yöntemi uygulamasını valueçağırmaya IFormattable.ToString çalışır. Değer arabirimini IFormattable uygulamazsa yöntemi temel türündeki valueyöntemini çağırırToString.

ToString(SByte)

Kaynak:

Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 8 bit işaretli tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

[System.CLSCompliant(false)]
public static string ToString (sbyte value);

Parametreler

value

SByte

Dönüştürülecek 8 bit işaretli tamsayı.

Döndürülenler

String

dize gösterimi value.

Öznitelikler

CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, imzalı bayt dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürür.

C#

sbyte[] numbers = { SByte.MinValue, -12, 0, 16, SByte.MaxValue };
string result;

foreach (sbyte number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the SByte value -128 to the String value -128.
//    Converted the SByte value -12 to the String value -12.
//    Converted the SByte value 0 to the String value 0.
//    Converted the SByte value 16 to the String value 16.
//    Converted the SByte value 127 to the String value 127.

Açıklamalar

Bu uygulama ile SByte.ToString()aynıdır.

ToString(Single)

Kaynak:

Convert.cs

Belirtilen tek duyarlıklı kayan nokta sayısının değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (float value);

Parametreler

value

Single

Dönüştürülecek tek duyarlıklı kayan nokta sayısı.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, bir değer dizisindeki Single her öğeyi eşdeğer dize gösterimine dönüştürür.

C#

float[] numbers = { Single.MinValue, -1011.351f, -17.45f, -3e-16f,
                    0f, 4.56e-12f, 16.0001f, 10345.1221f, Single.MaxValue };
string result;

foreach (float number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the Single value -3.402823E+38 to the String value -3.402823E+38.
//    Converted the Single value -1011.351 to the String value -1011.351.
//    Converted the Single value -17.45 to the String value -17.45.
//    Converted the Single value -3E-16 to the String value -3E-16.
//    Converted the Single value 0 to the String value 0.
//    Converted the Single value 4.56E-12 to the String value 4.56E-12.
//    Converted the Single value 16.0001 to the String value 16.0001.
//    Converted the Single value 10345.12 to the String value 10345.12.
//    Converted the Single value 3.402823E+38 to the String value 3.402823E+38.

Açıklamalar

Bu uygulama ile Single.ToString()aynıdır.

ToString(String)

Kaynak:

Convert.cs

Belirtilen dize örneğini döndürür; gerçek dönüştürme gerçekleştirilmemesi.

C#

public static string? ToString (string? value);

Parametreler

value

String

Döndürülecek dize.

Döndürülenler

String

value değiştirilmeden döndürülür.

Örnekler

Aşağıdaki örnek yöntemine ToString(String) bir dize geçirir ve yöntemini çağırarak Object.ReferenceEquals yöntemin özgün dizeyi döndürdüğünü onaylar. Örnek, özgün dizenin iç içe String.IsInterned geçmiş olması nedeniyle iki dizenin aynı olmadığından emin olmak için yöntemini de çağırır.

C#

using System;

public class Example
{
   public static void Main()
   {
      String article = "An";
      String noun = "apple";
      String str1 = String.Format("{0} {1}", article, noun);
      String str2 = Convert.ToString(str1);

      Console.WriteLine("str1 is interned: {0}",
                        ! (String.IsInterned(str1) == null));
      Console.WriteLine("str1 and str2 are the same reference: {0}",
                        Object.ReferenceEquals(str1, str2));
   }
}
// The example displays the following output:
//       str1 is interned: False
//       str1 and str2 are the same reference: True

ToString(UInt16)

Kaynak:

Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 16 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

[System.CLSCompliant(false)]
public static string ToString (ushort value);

Parametreler

value

UInt16

Dönüştürülecek 16 bitlik işaretsiz tamsayı.

Döndürülenler

String

dize gösterimi value.

Öznitelikler

CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, işaretsiz 16 bit tamsayı değerleri dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürür.

C#

ushort[] numbers = { UInt16.MinValue, 103, 1045, UInt16.MaxValue };
string result;

foreach (ushort number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the UInt16 value 0 to the String value 0.
//    Converted the UInt16 value 103 to the String value 103.
//    Converted the UInt16 value 1045 to the String value 1045.
//    Converted the UInt16 value 65535 to the String value 65535.

Açıklamalar

Bu uygulama ile UInt16.ToString()aynıdır.

ToString(UInt32)

Kaynak:

Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 32 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

[System.CLSCompliant(false)]
public static string ToString (uint value);

Parametreler

value

UInt32

Dönüştürülecek 32 bit işaretsiz tamsayı.

Döndürülenler

String

dize gösterimi value.

Öznitelikler

CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, işaretsiz bir tamsayı dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürür.

C#

uint[] numbers = { UInt32.MinValue, 103, 1045, 119543, UInt32.MaxValue };
string result;

foreach (uint number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the UInt32 value 0 to the String value 0.
//    Converted the UInt32 value 103 to the String value 103.
//    Converted the UInt32 value 1045 to the String value 1045.
//    Converted the UInt32 value 119543 to the String value 119543.
//    Converted the UInt32 value 4294967295 to the String value 4294967295.

Açıklamalar

Bu uygulama ile UInt32.ToString()aynıdır.

ToString(UInt64)

Kaynak:

Convert.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen 64 bit işaretsiz tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

[System.CLSCompliant(false)]
public static string ToString (ulong value);

Parametreler

value

UInt64

Dönüştürülecek 64 bit işaretsiz tamsayı.

Döndürülenler

String

dize gösterimi value.

Öznitelikler

CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, işaretsiz bir uzun tamsayı dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürür.

C#

ulong[] numbers = { UInt64.MinValue, 1031, 189045, UInt64.MaxValue };
string result;

foreach (ulong number in numbers)
{
   result = Convert.ToString(number);
   Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                        number.GetType().Name, number,
                        result.GetType().Name, result);
}
// The example displays the following output:
//    Converted the UInt64 value 0 to the String value 0.
//    Converted the UInt64 value 1031 to the String value 1031.
//    Converted the UInt64 value 189045 to the String value 189045.
//    Converted the UInt64 value 18446744073709551615 to the String value 18446744073709551615.

Açıklamalar

Bu uygulama ile UInt64.ToString()aynıdır.

ToString(Int64)

Kaynak:

Convert.cs

Belirtilen 64 bit işaretli tamsayı değerini eşdeğer dize gösterimine dönüştürür.

C#

public static string ToString (long value);

Parametreler

value

Int64

Dönüştürülecek 64 bit işaretli tamsayı.

Döndürülenler

String

dize gösterimi value.

Örnekler

Aşağıdaki örnek, uzun bir tamsayı dizisindeki her öğeyi eşdeğer dize gösterimine dönüştürür.

C#

// Create a NumberFormatInfo object and set several of its
// properties that control default integer formatting.
System.Globalization.NumberFormatInfo provider = new System.Globalization.NumberFormatInfo();
provider.NegativeSign = "minus ";

long[] values = { -200, 0, 1000 };

foreach (long value in values)
   Console.WriteLine("{0,-6}  -->  {1,10}",
                     value, Convert.ToString(value, provider));
// The example displays the following output:
//       -200    -->   minus 200
//       0       -->           0
//       1000    -->        1000

Açıklamalar

Bu uygulama ile Int64.ToString()aynıdır.