Convert.ToString Methode

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Konvertiert den angegebenen Wert in die entsprechende Zeichenfolgendarstellung.

Überlädt

ToString(Int32, IFormatProvider)	Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl mit Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(Int16, Int32)	Konvertiert den Wert einer 16-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung in einer angegebenen Basis.
ToString(DateTime, IFormatProvider)	Konvertiert den Wert der angegebenen DateTime unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(Double, IFormatProvider)	Konvertiert den Wert der angegebenen Gleitkommazahl mit doppelter Genauigkeit in die entsprechende Zeichenfolgendarstellung.
ToString(Decimal, IFormatProvider)	Konvertiert den Wert der angegebenen Dezimalzahl unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(Int32, Int32)	Konvertiert den Wert einer 32-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung in einer angegebenen Basis.
ToString(Int16, IFormatProvider)	Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl mit Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(Int64, IFormatProvider)	Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl mit Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(Single, IFormatProvider)	Konvertiert den Wert der angegebenen Gleitkommazahl mit einfacher Genauigkeit unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(Object, IFormatProvider)	Konvertiert den Wert des angegebenen Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(SByte, IFormatProvider)	Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl mit Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(String, IFormatProvider)	Gibt die angegebene Zeichenfolgeninstanz zurück. Es wird keine wirkliche Konvertierung durchgeführt.
ToString(UInt16, IFormatProvider)	Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl ohne Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(UInt32, IFormatProvider)	Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl ohne Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(UInt64, IFormatProvider)	Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl ohne Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(Char, IFormatProvider)	Konvertiert den Wert des angegebenen Unicode-Zeichens unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(Int64, Int32)	Konvertiert den Wert einer 64-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung in einer angegebenen Basis.
ToString(Byte, Int32)	Konvertiert den Wert einer 8-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung in einer angegebenen Basis.
ToString(Boolean, IFormatProvider)	Konvertiert den angegebenen booleschen Wert in die entsprechende Zeichenfolgendarstellung.
ToString(Byte, IFormatProvider)	Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl ohne Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
ToString(Boolean)	Konvertiert den angegebenen booleschen Wert in die entsprechende Zeichenfolgendarstellung.
ToString(Byte)	Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung.
ToString(Char)	Konvertiert den Wert des angegebenen Unicode-Zeichens in die entsprechende Zeichenfolgendarstellung.
ToString(DateTime)	Konvertiert den Wert der angegebenen DateTime in die entsprechende Zeichenfolgendarstellung.
ToString(Double)	Konvertiert den Wert der angegebenen Gleitkommazahl mit doppelter Genauigkeit in die entsprechende Zeichenfolgendarstellung.
ToString(Int16)	Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung.
ToString(Int32)	Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung.
ToString(Decimal)	Konvertiert den Wert der angegebenen Dezimalzahl in die entsprechende Zeichenfolgendarstellung.
ToString(Object)	Konvertiert den Wert des angegebenen Objekts in die entsprechende Zeichenfolgendarstellung.
ToString(SByte)	Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung.
ToString(Single)	Konvertiert den Wert der angegebenen Gleitkommazahl mit einfacher Genauigkeit in die entsprechende Zeichenfolgendarstellung.
ToString(String)	Gibt die angegebene Zeichenfolgeninstanz zurück. Es wird keine wirkliche Konvertierung durchgeführt.
ToString(UInt16)	Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung.
ToString(UInt32)	Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung.
ToString(UInt64)	Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung.
ToString(Int64)	Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung.

ToString(Int32, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl mit Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Int32

Die zu konvertierende 32-Bit-Ganzzahl mit Vorzeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte NumberFormatInfo Klasse definiert, die ihr negatives Vorzeichen als die Zeichenfolge "~" und ihr positives Zeichen als die Zeichenfolge "!" definiert. Anschließend wird die ToString(Int32, IFormatProvider) -Methode aufgerufen, um jedes Element in einem Array von Ganzen in die entsprechende Zeichenfolgendarstellung zu konvertieren. Bei der Konvertierung werden die invariante Kultur sowie das benutzerdefinierte NumberFormatInfo Objekt verwendet.

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

Hinweise

Diese Implementierung ist identisch mit Int32.ToString(IFormatProvider).

ToString(Int16, Int32)

Quelle:

Convert.cs

Konvertiert den Wert einer 16-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung in einer angegebenen Basis.

C#

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

Parameter

value

Int16

Die zu konvertierende 16-Bit-Ganzzahl mit Vorzeichen.

toBase

Int32

Die Basis des Rückgabewerts, die 2, 8, 10 oder 16 sein muss.

Gibt zurück

String

Die Zeichenfolgendarstellung von value zur Basis toBase.

Ausnahmen

ArgumentException

toBase ist nicht 2, 8, 10 oder 16.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array von 16-Bit-Ganzzahlen mit Vorzeichen in die entsprechenden binären, oktalen, dezimalen und hexadezimalen Zeichenfolgendarstellungen konvertiert.

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

Hinweise

Wenn value positiv ist und toBase 2, 8 oder 16 ist, verwendet die zurückgegebene Zeichenfolge die Darstellung von Vorzeichen und Größen. Wenn value negativ ist und toBase 2, 8 oder 16 ist, verwendet die zurückgegebene Zeichenfolge die Komplementdarstellung von zwei. Dies bedeutet, dass das High-Order-Bit des Byte mit hoher Ordnung (Bit 15) als Vorzeichenbit interpretiert wird. Wenn die ToString(Int16, Int32) -Methode aufgerufen wird, um eine Zeichenfolge zu erstellen, die später wieder in eine Zahl konvertiert wird, sollte eine entsprechende Methode aufgerufen werden, die eine ähnliche numerische Darstellung voraussetzt, um die Konvertierung durchzuführen. Zu diesen Methoden gehören Convert.ToInt16(String, Int32) und Int16.Parse(String, NumberStyles).

ToString(DateTime, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen DateTime unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

DateTime

Der Datums- und Uhrzeitwert, der konvertiert werden soll.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird ein DateTime Wert in die entsprechende Zeichenfolgendarstellung in acht verschiedenen Kulturen konvertiert.

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

Hinweise

Diese Implementierung ist identisch mit DateTime.ToString(IFormatProvider).

ToString(Double, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen Gleitkommazahl mit doppelter Genauigkeit in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Double

Die zu konvertierende Gleitkommazahl mit doppelter Genauigkeit.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array von Double Werten in die entsprechende Zeichenfolgendarstellung in vier verschiedenen Kulturen konvertiert.

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

Hinweise

Diese Implementierung ist identisch mit Double.ToString(IFormatProvider)

ToString(Decimal, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen Dezimalzahl unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Decimal

Die zu konvertierende Dezimalzahl.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array von Decimal Werten in die entsprechende Zeichenfolgendarstellung in vier verschiedenen Kulturen konvertiert.

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

Hinweise

Diese Implementierung ist identisch mit Decimal.ToString(IFormatProvider).

ToString(Int32, Int32)

Quelle:

Convert.cs

Konvertiert den Wert einer 32-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung in einer angegebenen Basis.

C#

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

Parameter

value

Int32

Die zu konvertierende 32-Bit-Ganzzahl mit Vorzeichen.

toBase

Int32

Die Basis des Rückgabewerts, die 2, 8, 10 oder 16 sein muss.

Gibt zurück

String

Die Zeichenfolgendarstellung von value zur Basis toBase.

Ausnahmen

ArgumentException

toBase ist nicht 2, 8, 10 oder 16.

Beispiele

Im folgenden Beispiel wird jedes Element in einem ganzzahligen Array in die entsprechenden binären, hexadezimalen, dezimalen und hexadezimalen Zeichenfolgendarstellungen konvertiert.

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

Hinweise

Wenn value positiv ist und toBase 2, 8 oder 16 ist, verwendet die zurückgegebene Zeichenfolge die Darstellung von Vorzeichen und Größen. Wenn value negativ ist und toBase 2, 8 oder 16 ist, verwendet die zurückgegebene Zeichenfolge die Komplementdarstellung von zwei. Dies bedeutet, dass das Bit mit hoher Ordnung des Byte der höchsten Ordnung (Bit 31) als Vorzeichenbit interpretiert wird. Wenn die ToString(Int32, Int32) -Methode aufgerufen wird, um eine Zeichenfolge zu erstellen, die später wieder in eine Zahl konvertiert wird, sollte eine entsprechende Methode aufgerufen werden, die eine ähnliche numerische Darstellung voraussetzt, um die Konvertierung durchzuführen. Zu diesen Methoden gehören Convert.ToInt32(String, Int32) und Int32.Parse(String, NumberStyles).

ToString(Int16, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl mit Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Int16

Die zu konvertierende 16-Bit-Ganzzahl mit Vorzeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte NumberFormatInfo Klasse definiert, die ihr negatives Vorzeichen als die Zeichenfolge "~" und ihr positives Zeichen als die Zeichenfolge "!" definiert. Anschließend wird die ToString(Int16, IFormatProvider) -Methode aufgerufen, um jedes Element in einem Array von 16-Bit-Ganzzahlen in die entsprechende Zeichenfolgendarstellung zu konvertieren. Bei der Konvertierung werden die invariante Kultur sowie das benutzerdefinierte NumberFormatInfo Objekt verwendet.

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

Hinweise

Diese Implementierung ist identisch mit Int16.ToString(IFormatProvider).

ToString(Int64, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl mit Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Int64

Die zu konvertierende 64-Bit-Ganzzahl mit Vorzeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte NumberFormatInfo Klasse definiert, die ihr negatives Vorzeichen als die Zeichenfolge "~" und ihr positives Zeichen als die Zeichenfolge "!" definiert. Anschließend wird die ToString(Int64, IFormatProvider) -Methode aufgerufen, um jedes Element in einem array mit langer Ganzzahl in die entsprechende Zeichenfolgendarstellung zu konvertieren. Bei der Konvertierung werden die invariante Kultur sowie das benutzerdefinierte NumberFormatInfo Objekt verwendet.

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

Hinweise

Diese Implementierung ist identisch mit Int64.ToString(IFormatProvider).

ToString(Single, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen Gleitkommazahl mit einfacher Genauigkeit unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Single

Die zu konvertierende Gleitkommazahl mit einfacher Genauigkeit.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array von Single Werten in die entsprechende Zeichenfolgendarstellung in vier verschiedenen Kulturen konvertiert.

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

Hinweise

Diese Implementierung ist identisch mit Single.ToString(IFormatProvider).

ToString(Object, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert des angegebenen Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Object

Ein Objekt, das den zu konvertierenden Wert angibt, oder null.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Die Zeichenfolgendarstellung von value oder Empty, wenn value ein Objekt ist, dessen Wert null beträgt. Wenn value gleich null ist, gibt die Methode null zurück.

Beispiele

Im folgenden Beispiel wird eine Temperature Klasse definiert, die die Object.ToString -Methode überschreibt, aber die IConvertible -Schnittstelle nicht implementiert. Das Beispiel veranschaulicht, wie Aufrufe der Convert.ToString(Object, IFormatProvider) -Methode wiederum die Temperature.ToString -Methode aufrufen.

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

Im folgenden Beispiel wird eine Temperature Klasse definiert, die die IFormattable -Schnittstelle implementiert, aber nicht die IConvertible -Schnittstelle implementiert. Die IFormattable.ToString Implementierung stellt abhängig von der Formatzeichenfolge den Temperature Wert in Celsius, Fahrenheit oder Kelvin dar. Im Beispiel wird auch eine Klasse definiert, die eine TemperatureProvider zufällig generierte Formatzeichenfolge implementiert IFormatProvider und bereitstellt, die von der IFormattable Implementierung der Temperature -Klasse verwendet wird.

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

Hinweise

Wenn der value Parameter die IConvertible -Schnittstelle implementiert, ruft die -Methode die IConvertible.ToString(IFormatProvider) Implementierung von auf value. Wenn der value Parameter die IFormattable -Schnittstelle implementiert, ruft die Methode andernfalls ihre IFormattable.ToString(String, IFormatProvider) Implementierung auf. Wenn value keine Schnittstelle implementiert wird, ruft die -Methode die value -Methode des Parameters auf ToString() , und der provider Parameter wird ignoriert.

Der provider Parameter wird verwendet, wenn der value Parameter die IConvertible -Schnittstelle oder IFormattable implementiert. Der -Parameter wird am häufigsten verwendet provider , um kulturspezifische Informationen anzugeben, die bei der Konvertierung von valueverwendet werden. Wenn der value Parameter beispielsweise eine negative Dezimalzahl ist, kann der provider Parameter kulturspezifische Informationen zur Notation bereitstellen, die für das negative Vorzeichen und das Dezimaltrennzeichen verwendet wird. Das zweite Beispiel im nächsten Abschnitt veranschaulicht einen Formatanbieter, der keine kulturabhängigen Formatierungsinformationen bereitstellt.

ToString(SByte, IFormatProvider)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl mit Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

SByte

Die zu konvertierende 8-Bit-Ganzzahl mit Vorzeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte NumberFormatInfo Klasse definiert, die ihr negatives Vorzeichen als die Zeichenfolge "~" und ihr positives Zeichen als die Zeichenfolge "!" definiert. Anschließend wird die Convert.ToString(SByte, IFormatProvider) -Methode aufgerufen, um jedes Element im Bytearray mit Vorzeichen in die entsprechende Zeichenfolgendarstellung zu konvertieren. Bei der Konvertierung werden die invariante Kultur sowie das benutzerdefinierte NumberFormatInfo Objekt verwendet.

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

Hinweise

Diese Implementierung ist identisch mit SByte.ToString(IFormatProvider).

ToString(String, IFormatProvider)

Quelle:

Convert.cs

Gibt die angegebene Zeichenfolgeninstanz zurück. Es wird keine wirkliche Konvertierung durchgeführt.

C#

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

Parameter

value

String

Die zurückzugebende Zeichenfolge.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt. Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

String

value wird unverändert zurückgegeben.

Beispiele

Im folgenden Beispiel wird die ToString -Methode mit einem String -Parameter aufgerufen. Die -Methode gibt das unveränderte String zurück, ohne auf das IFormatProvider -Objekt zu verweisen.

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)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl ohne Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

UInt16

Die zu konvertierende 16-Bit-Ganzzahl ohne Vorzeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte NumberFormatInfo Klasse definiert, die ihr negatives Vorzeichen als die Zeichenfolge "~" und ihr positives Zeichen als die Zeichenfolge "!" definiert. Anschließend wird die ToString(UInt16, IFormatProvider) -Methode aufgerufen, um einen 16-Bit-Ganzzahlwert ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung zu konvertieren. Bei der Konvertierung werden sowohl die invariante Kultur als auch das benutzerdefinierte NumberFormatInfo Objekt verwendet. Die Ausgabe gibt an, dass diese Formatierungsinformationen nicht verwendet werden, da der Formatbezeichner "G" standardmäßig kein positives Zeichen mit positiven Werten enthält.

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

Hinweise

Diese Implementierung ist identisch mit UInt16.ToString(IFormatProvider).

ToString(UInt32, IFormatProvider)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl ohne Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

UInt32

Die zu konvertierende 32-Bit-Ganzzahl ohne Vorzeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte NumberFormatInfo Klasse definiert, die ihr negatives Vorzeichen als die Zeichenfolge "~" und ihr positives Zeichen als die Zeichenfolge "!" definiert. Anschließend wird die ToString(UInt32, IFormatProvider) -Methode aufgerufen, um einen ganzzahligen Wert ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung zu konvertieren. Bei der Konvertierung werden sowohl die invariante Kultur als auch das benutzerdefinierte NumberFormatInfo Objekt verwendet. Die Ausgabe gibt an, dass diese Formatierungsinformationen nicht verwendet werden, da der Formatbezeichner "G" standardmäßig kein positives Zeichen mit positiven Werten enthält.

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

Hinweise

Diese Implementierung ist identisch mit UInt32.ToString(IFormatProvider).

ToString(UInt64, IFormatProvider)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl ohne Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

UInt64

Die zu konvertierende 64-Bit-Ganzzahl ohne Vorzeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird eine benutzerdefinierte NumberFormatInfo Klasse definiert, die ihr negatives Vorzeichen als die Zeichenfolge "~" und ihr positives Zeichen als die Zeichenfolge "!" definiert. Anschließend wird die ToString(UInt64, IFormatProvider) -Methode aufgerufen, um einen wert ohne Vorzeichen (long integer) ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung zu konvertieren. Bei der Konvertierung werden sowohl die invariante Kultur als auch das benutzerdefinierte NumberFormatInfo Objekt verwendet. Die Ausgabe gibt an, dass diese Formatierungsinformationen nicht verwendet werden, da der Formatbezeichner "G" standardmäßig kein positives Zeichen mit positiven Werten enthält.

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

Hinweise

Diese Implementierung ist identisch mit UInt64.ToString(IFormatProvider).

ToString(Char, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert des angegebenen Unicode-Zeichens unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Char

Das zu konvertierende Unicode-Zeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt. Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird ein Char Wert mit der ToString -Methode in ein String konvertiert, wobei ein IFormatProvider -Objekt verwendet wird, das den Typ des Formatanbieters anzeigt, für den er aufgerufen wird. Das Beispiel zeigt, dass nicht auf das IFormatProvider Objekt verwiesen wird.

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

*/

Hinweise

Diese Implementierung ist identisch mit Char.ToString(). Der Parameter provider wird ignoriert.

ToString(Int64, Int32)

Quelle:

Convert.cs

Konvertiert den Wert einer 64-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung in einer angegebenen Basis.

C#

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

Parameter

value

Int64

Die zu konvertierende 64-Bit-Ganzzahl mit Vorzeichen.

toBase

Int32

Die Basis des Rückgabewerts, die 2, 8, 10 oder 16 sein muss.

Gibt zurück

String

Die Zeichenfolgendarstellung von value zur Basis toBase.

Ausnahmen

ArgumentException

toBase ist nicht 2, 8, 10 oder 16.

Beispiele

Im folgenden Beispiel wird jedes Element in einem array mit langer ganzzahliger Zeichenfolge in die entsprechenden binären, hexadezimalen, dezimalen und hexadezimalen Zeichenfolgendarstellungen konvertiert.

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

Hinweise

Wenn value positiv ist und toBase nicht 10 ist, verwendet die zurückgegebene Zeichenfolge die Darstellung von Zeichen und Größen. Wenn value negativ und toBase nicht 10 ist, verwendet die zurückgegebene Zeichenfolge die Komplementdarstellung von zwei. Dies bedeutet, dass das Bit mit hoher Ordnung des Byte der höchsten Ordnung (Bit 63) als Vorzeichenbit interpretiert wird. Wenn die ToString(Int64, Int32) -Methode aufgerufen wird, um eine Zeichenfolge zu erstellen, die später wieder in eine Zahl konvertiert wird, sollte eine entsprechende Methode aufgerufen werden, die eine ähnliche numerische Darstellung voraussetzt, um die Konvertierung durchzuführen. Zu diesen Methoden gehören Convert.ToInt64(String, Int32) und Int64.Parse(String, NumberStyles).

ToString(Byte, Int32)

Quelle:

Convert.cs

Konvertiert den Wert einer 8-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung in einer angegebenen Basis.

C#

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

Parameter

value

Byte

Die zu konvertierende 8-Bit-Ganzzahl ohne Vorzeichen.

toBase

Int32

Die Basis des Rückgabewerts, die 2, 8, 10 oder 16 sein muss.

Gibt zurück

String

Die Zeichenfolgendarstellung von value zur Basis toBase.

Ausnahmen

ArgumentException

toBase ist nicht 2, 8, 10 oder 16.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Bytearray in die entsprechenden binären, hexadezimalen, dezimalen und hexadezimalen Zeichenfolgendarstellungen konvertiert.

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

Hinweise

Wenn toBase nicht gleich 10 ist, stellt die von der Convert.ToString(Byte, Int32) -Methode zurückgegebene Zeichenfolge nur ihre Größe dar value . Wenn die -Methode aufgerufen wird, um eine Zeichenfolge zu erstellen, die später wieder in eine Zahl konvertiert wird, sollte eine entsprechende Methode aufgerufen werden, die von einer numerischen Darstellung nur einer Größenordnung ausgeht, um die Konvertierung durchzuführen. Zu diesen Methoden gehören Convert.ToByte(String, Int32) oder Byte.Parse(String, NumberStyles).

ToString(Boolean, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den angegebenen booleschen Wert in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Boolean

Der zu konvertierende boolesche Wert.

provider

IFormatProvider

Eine Instanz eines Objekts. Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird ein Boolean Wert mit der ToString -Methode in ein String konvertiert, wobei ein IFormatProvider -Objekt verwendet wird, das den Typ des Formatanbieters anzeigt, für den er aufgerufen wird. Das Beispiel zeigt, dass nicht auf das IFormatProvider Objekt verwiesen wird.

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

*/

Hinweise

Diese Implementierung ist identisch mit Boolean.ToString. Sie gibt für true Werte und Boolean.FalseString für false Werte zurückBoolean.TrueString.

ToString(Byte, IFormatProvider)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl ohne Vorzeichen unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

Byte

Die zu konvertierende 8-Bit-Ganzzahl ohne Vorzeichen.

provider

IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Bytearray ohne Vorzeichen mithilfe der Formatierungskonventionen der Kulturen en-US und fr-FR in seine entsprechende Zeichenfolgendarstellung konvertiert. Da der G-Spezifizierer standardmäßig nur Dezimalstellen in der Zeichenfolgendarstellung eines Bytewerts ausgibt, wirkt sich der provider Parameter nicht auf die Formatierung der zurückgegebenen Zeichenfolge aus.

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

Hinweise

Diese Implementierung ist identisch mit Byte.ToString.

ToString(Boolean)

Quelle:

Convert.cs

Konvertiert den angegebenen booleschen Wert in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (bool value);

Parameter

value

Boolean

Der zu konvertierende boolesche Wert.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird die Konvertierung von in Boolean ein StringToStringmit veranschaulicht. Außerdem wird veranschaulicht, dass die von der Konvertierung zurückgegebene Zeichenfolge gleich oder Boolean.TrueStringBoolean.FalseStringist.

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

Hinweise

Diese Implementierung ist identisch mit Boolean.ToString. Sie gibt für true Werte und Boolean.FalseString für false Werte zurückBoolean.TrueString.

ToString(Byte)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (byte value);

Parameter

value

Byte

Die zu konvertierende 8-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird jeder Wert in einem Byte Array in eine Zeichenfolge konvertiert.

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

Hinweise

Diese Implementierung ist identisch mit Byte.ToString().

ToString(Char)

Quelle:

Convert.cs

Konvertiert den Wert des angegebenen Unicode-Zeichens in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (char value);

Parameter

value

Char

Das zu konvertierende Unicode-Zeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird eine Char in eine Stringkonvertiert.

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);
}

Hinweise

Diese Implementierung ist identisch mit Char.ToString.

ToString(DateTime)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen DateTime in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (DateTime value);

Parameter

value

DateTime

Der Datums- und Uhrzeitwert, der konvertiert werden soll.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array eines DateTime Werts in einen String Wert konvertiert.

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.

Hinweise

Diese Implementierung ist identisch mit DateTime.ToString(). Es verwendet die Formatierungskonventionen der aktuellen Kultur und den Formatbezeichner "G", um einen DateTime Wert in seine Zeichenfolgendarstellung zu konvertieren.

ToString(Double)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen Gleitkommazahl mit doppelter Genauigkeit in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (double value);

Parameter

value

Double

Die zu konvertierende Gleitkommazahl mit doppelter Genauigkeit.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird eine Double in eine Stringkonvertiert.

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.");
    }
}

Hinweise

Diese Implementierung ist identisch mit Double.ToString().

ToString(Int16)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (short value);

Parameter

value

Int16

Die zu konvertierende 16-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array von 16-Bit-Ganzzahlen in die entsprechende Zeichenfolgendarstellung konvertiert.

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.

Hinweise

Diese Implementierung ist identisch mit Int16.ToString().

ToString(Int32)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (int value);

Parameter

value

Int32

Die zu konvertierende 32-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird die ToString(Int32) -Methode mit der ToString(UInt16, IFormatProvider) -Methode verglichen. Es definiert ein benutzerdefiniertes NumberFormatInfo -Objekt, das das Sting "minus" verwendet, um das negative Zeichen darzustellen. Jedes Element in einem Ganzzahlarray wird mithilfe der Standardformatierung (den Formatierungskonventionen der aktuellen Kultur) und des benutzerdefinierten Formatanbieters in die entsprechende Zeichenfolgendarstellung konvertiert.

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
   }
}

Hinweise

Diese Implementierung ist identisch mit Int32.ToString(). Sie formatiert value mithilfe der Formatierungskonventionen der aktuellen Kultur.

ToString(Decimal)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen Dezimalzahl in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (decimal value);

Parameter

value

Decimal

Die zu konvertierende Dezimalzahl.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird eine Decimal in eine Stringkonvertiert.

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);
}

Hinweise

Diese Implementierung ist identisch mit Decimal.ToString().

ToString(Object)

Quelle:

Convert.cs

Konvertiert den Wert des angegebenen Objekts in die entsprechende Zeichenfolgendarstellung.

C#

public static string? ToString (object? value);

Parameter

value

Object

Ein Objekt, das den zu konvertierenden Wert angibt, oder null.

Gibt zurück

String

Die Zeichenfolgendarstellung von value, oder Empty, wenn valuenull ist.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Objektarray in die entsprechende Zeichenfolgendarstellung konvertiert.

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.

Hinweise

Um in ihre Zeichenfolgendarstellung zu konvertieren value , versucht die -Methode, die IConvertible.ToString Implementierung von valueaufzurufen. Wenn value die IConvertible -Schnittstelle nicht implementiert, versucht die -Methode, die IFormattable.ToString Implementierung von valueaufzurufen. Wenn value die IFormattable -Schnittstelle nicht implementiert, ruft die -Methode die ToString -Methode des zugrunde liegenden Typs von valueauf.

ToString(SByte)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

SByte

Die zu konvertierende 8-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird jedes Element in einem Bytearray mit Vorzeichen in die entsprechende Zeichenfolgendarstellung konvertiert.

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.

Hinweise

Diese Implementierung ist identisch mit SByte.ToString().

ToString(Single)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen Gleitkommazahl mit einfacher Genauigkeit in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (float value);

Parameter

value

Single

Die zu konvertierende Gleitkommazahl mit einfacher Genauigkeit.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array von Single Werten in die entsprechende Zeichenfolgendarstellung konvertiert.

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.

Hinweise

Diese Implementierung ist identisch mit Single.ToString().

ToString(String)

Quelle:

Convert.cs

Gibt die angegebene Zeichenfolgeninstanz zurück. Es wird keine wirkliche Konvertierung durchgeführt.

C#

public static string? ToString (string? value);

Parameter

value

String

Die zurückzugebende Zeichenfolge.

Gibt zurück

String

value wird unverändert zurückgegeben.

Beispiele

Im folgenden Beispiel wird eine Zeichenfolge an die ToString(String) -Methode übergeben und die Object.ReferenceEquals -Methode aufgerufen, um zu bestätigen, dass die Methode die ursprüngliche Zeichenfolge zurückgibt. Im Beispiel wird auch die String.IsInterned -Methode aufgerufen, um sicherzustellen, dass die beiden Zeichenfolgen nicht identisch sind, da die ursprüngliche Zeichenfolge interniert ist.

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)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

UInt16

Die zu konvertierende 16-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array von 16-Bit-Ganzzahlwerten ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung konvertiert.

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.

Hinweise

Diese Implementierung ist identisch mit UInt16.ToString().

ToString(UInt32)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

UInt32

Die zu konvertierende 32-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird jedes Element in einem ganzzahligen Array ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung konvertiert.

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.

Hinweise

Diese Implementierung ist identisch mit UInt32.ToString().

ToString(UInt64)

Quelle:

Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl ohne Vorzeichen in die entsprechende Zeichenfolgendarstellung.

C#

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

Parameter

value

UInt64

Die zu konvertierende 64-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Attribute

CLSCompliantAttribute

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array ohne Vorzeichen mit langer Ganzzahl in die entsprechende Zeichenfolgendarstellung konvertiert.

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.

Hinweise

Diese Implementierung ist identisch mit UInt64.ToString().

ToString(Int64)

Quelle:

Convert.cs

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl mit Vorzeichen in die entsprechende Zeichenfolgendarstellung.

C#

public static string ToString (long value);

Parameter

value

Int64

Die zu konvertierende 64-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

String

Eine Zeichenfolgendarstellung von value.

Beispiele

Im folgenden Beispiel wird jedes Element in einem Array mit langer Ganzzahl in die entsprechende Zeichenfolgendarstellung konvertiert.

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

Hinweise

Diese Implementierung ist identisch mit Int64.ToString().