UInt32.ToString Methode

Definition

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.

Überlädt

ToString(IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

ToString(String, IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

ToString(String)

Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.

ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.

ToString(IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

public:
 virtual System::String ^ ToString(IFormatProvider ^ provider);
public:
 System::String ^ ToString(IFormatProvider ^ provider);
public string ToString (IFormatProvider provider);
public string ToString (IFormatProvider? provider);
override this.ToString : IFormatProvider -> string
Public Function ToString (provider As IFormatProvider) As String

Parameter

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz, die aus einer Folge von Ziffern zwischen 0 (null) und 9 ohne Vorzeichen und führende Nullen besteht.

Implementiert

Beispiele

Im folgenden Beispiel wird ein 16-Bit-Ganzzahlwert mit Vorzeichen mit mehreren Formatanbietern formatiert, einschließlich eines für die invariante Kultur. Die Ausgabe des Beispiels veranschaulicht, dass die formatierte Zeichenfolge, die von der -Methode zurückgegeben wird, unabhängig vom ToString(IFormatProvider) Formatanbieter identisch ist.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define an array of CultureInfo objects.
      CultureInfo[] ci = { new CultureInfo("en-US"), 
                           new CultureInfo("fr-FR"), 
                           CultureInfo.InvariantCulture }; 
      uint value = 1870924;
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        GetName(ci[0]), GetName(ci[1]), GetName(ci[2])); 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", 
                        value.ToString(ci[0]), value.ToString(ci[1]), value.ToString(ci[2]));   
   }

   private static string GetName(CultureInfo ci)
   {
      if (ci.Equals(CultureInfo.InvariantCulture))
         return "Invariant";
      else
         return ci.Name;         
   }
}
// The example displays the following output:
//             en-US          fr-FR      Invariant
//           1870924        1870924        1870924
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define an array of CultureInfo objects.
      Dim ci() As CultureInfo = { New CultureInfo("en-US"), _
                                  New CultureInfo("fr-FR"), _
                                  CultureInfo.InvariantCulture } 
      Dim value As UInteger = 1870924
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        GetName(ci(0)), GetName(ci(1)), GetName(ci(2))) 
      Console.WriteLine("  {0,12}   {1,12}   {2,12}", _
                        value.ToString(ci(0)), value.ToString(ci(1)), value.ToString(ci(2)))            
      
   End Sub
   
   Private Function GetName(ci As CultureInfo) As String
      If ci.Equals(CultureInfo.InvariantCulture) Then
         Return "Invariant"
      Else
         Return ci.Name
      End If   
   End Function
End Module
' The example displays the following output:
'        en-US          fr-FR      Invariant
'      1870924        1870924        1870924

Hinweise

Die ToString(IFormatProvider) -Methode UInt32 formatiert einen Wert im Standardformat ("G" oder "Allgemein") mithilfe des -Objekts NumberFormatInfo einer angegebenen Kultur. Wenn Sie ein anderes Format oder die aktuelle Kultur angeben möchten, verwenden Sie die anderen Überladungen der -Methode ToString wie folgt:

So verwenden Sie das Format Für Kultur Verwenden der Überladung
Standardformat ("G") Standardkultur (aktuell) ToString()
Ein bestimmtes Format Standardkultur (aktuell) ToString(String)
Ein bestimmtes Format Eine bestimmte Kultur ToString(String, IFormatProvider)

Der provider Parameter ist eine IFormatProvider Implementierung. Die GetFormat -Methode gibt ein NumberFormatInfo -Objekt zurück, das kulturspezifische Formatierungsinformationen enthält. Bei der Formatierung mit dem allgemeinen numerischen Formatbezeichner ("G") wird jedoch keine der Eigenschaften von NumberFormatInfo verwendet.

Siehe auch

Gilt für:

ToString(String, IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.

public:
 virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);
public string ToString (string format, IFormatProvider provider);
public string ToString (string? format, IFormatProvider? provider);
override this.ToString : string * IFormatProvider -> string
Public Function ToString (format As String, provider As IFormatProvider) As String

Parameter

format
String

Eine numerische Formatierungszeichenfolge.

provider
IFormatProvider

Ein Objekt, das kulturabhängige Formatierungsinformationen über diese Instanz liefert.

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format und provider.

Implementiert

Ausnahmen

Der format-Parameter ist ungültig.

Beispiele

Im folgenden Beispiel wird ein 32-Bit-Ganzzahlwert ohne Vorzeichen mithilfe der numerischen Standardformatbezeichner und einer Reihe bestimmter Objekte CultureInfo angezeigt.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define cultures whose formatting conventions are to be used.
      CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"), 
                                 CultureInfo.CreateSpecificCulture("fr-FR"), 
                                 CultureInfo.CreateSpecificCulture("es-ES") };
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}; 
      uint value = 2222402;
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}",  
                              specifier, culture.Name, 
                              value.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//        G format using en-US culture:            2222402
//        G format using fr-FR culture:            2222402
//        G format using es-ES culture:            2222402
//       
//        C format using en-US culture:      $2,222,402.00
//        C format using fr-FR culture:     2 222 402,00 €
//        C format using es-ES culture:     2.222.402,00 €
//       
//       D4 format using en-US culture:            2222402
//       D4 format using fr-FR culture:            2222402
//       D4 format using es-ES culture:            2222402
//       
//       E2 format using en-US culture:          2.22E+006
//       E2 format using fr-FR culture:          2,22E+006
//       E2 format using es-ES culture:          2,22E+006
//       
//        F format using en-US culture:         2222402.00
//        F format using fr-FR culture:         2222402,00
//        F format using es-ES culture:         2222402,00
//       
//        N format using en-US culture:       2,222,402.00
//        N format using fr-FR culture:       2 222 402,00
//        N format using es-ES culture:       2.222.402,00
//       
//        P format using en-US culture:   222,240,200.00 %
//        P format using fr-FR culture:   222 240 200,00 %
//        P format using es-ES culture:   222.240.200,00 %
//       
//       X2 format using en-US culture:             21E942
//       X2 format using fr-FR culture:             21E942
//       X2 format using es-ES culture:             21E942
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define cultures whose formatting conventions are to be used.
      Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
                                       CultureInfo.CreateSpecificCulture("fr-FR"), _
                                       CultureInfo.CreateSpecificCulture("es-ES") }
      Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"} 
      Dim value As UInteger = 2222402
      
      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 18}", _ 
                              specifier, culture.Name, _
                              value.ToString(specifier, culture))

         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'        G format using en-US culture:            2222402
'        G format using fr-FR culture:            2222402
'        G format using es-ES culture:            2222402
'       
'        C format using en-US culture:      $2,222,402.00
'        C format using fr-FR culture:     2 222 402,00 €
'        C format using es-ES culture:     2.222.402,00 €
'       
'       D4 format using en-US culture:            2222402
'       D4 format using fr-FR culture:            2222402
'       D4 format using es-ES culture:            2222402
'       
'       E2 format using en-US culture:          2.22E+006
'       E2 format using fr-FR culture:          2,22E+006
'       E2 format using es-ES culture:          2,22E+006
'       
'        F format using en-US culture:         2222402.00
'        F format using fr-FR culture:         2222402,00
'        F format using es-ES culture:         2222402,00
'       
'        N format using en-US culture:       2,222,402.00
'        N format using fr-FR culture:       2 222 402,00
'        N format using es-ES culture:       2.222.402,00
'       
'        P format using en-US culture:   222,240,200.00 %
'        P format using fr-FR culture:   222 240 200,00 %
'        P format using es-ES culture:   222.240.200,00 %
'       
'       X2 format using en-US culture:             21E942
'       X2 format using fr-FR culture:             21E942
'       X2 format using es-ES culture:             21E942

Hinweise

Die ToString(String, IFormatProvider) -Methode UInt32 formatiert einen Wert in einem angegebenen Format mithilfe des NumberFormatInfo -Objekts einer angegebenen Kultur. Wenn Sie Standardformat- oder Kultureinstellungen verwenden möchten, verwenden Sie die anderen Überladungen der -Methode ToString wie folgt:

So verwenden Sie das Format Für Kultur Verwenden der Überladung
Standardformat ("G") Standardkultur (aktuell) ToString()
Standardformat ("G") Eine bestimmte Kultur ToString(IFormatProvider)
Ein bestimmtes Format Standardkultur (aktuell) ToString(String)

Der format -Parameter kann eine beliebige gültige numerische Standardformatzeichenfolgeoder eine beliebige Kombination aus benutzerdefinierten numerischen Formatzeichenfolgen sein. Wenn gleich oder ist, wird der Rückgabewert des aktuellen Objekts mit dem allgemeinen Formatbezeichner format String.Empty null UInt32 ("G") formatiert. Wenn format ein anderer Wert ist, löst die -Methode eine FormatException aus.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Der provider Parameter ist eine IFormatProvider Implementierung. Die -Methode gibt ein -Objekt zurück, das kulturspezifische Informationen über das Format der von GetFormat NumberFormatInfo dieser Methode zurückgegebenen Zeichenfolge enthält. Wenn die -Methode aufgerufen wird, ruft sie die -Methode des Parameters auf und übergibt ihr ein ToString(String, IFormatProvider) provider IFormatProvider.GetFormat Type -Objekt, das den Typ NumberFormatInfo darstellt. Die -Methode gibt dann das -Objekt zurück, das Informationen zum Formatieren des aktuellen Werts enthält, z. B. das Gruppentrennzeichen oder GetFormat NumberFormatInfo das UInt32 Dezimaltrennzeichen. Es gibt drei Möglichkeiten, den -Parameter provider zu verwenden, um Formatierungsinformationen für die -Methode zur Verfügung ToString(String, IFormatProvider) zu stellen:

  • Sie können ein CultureInfo -Objekt übergeben, das die Kultur darstellt, die Formatierungsinformationen liefert. Die GetFormat -Methode gibt das NumberFormatInfo -Objekt zurück, das numerische Formatierungsinformationen für diese Kultur enthält.

  • Sie können das eigentliche Objekt NumberFormatInfo übergeben, das numerische Formatierungsinformationen enthält. (Die Implementierung von GetFormat gibt sich selbst zurück.)

  • Sie können ein benutzerdefiniertes -Objekt übergeben, das IFormatProvider implementiert. Die GetFormat -Methode instanziiert und gibt das NumberFormatInfo -Objekt zurück, das Formatierungsinformationen enthält.

Wenn provider null ist, basiert die Formatierung der zurückgegebenen Zeichenfolge auf dem NumberFormatInfo -Objekt der aktuellen Kultur.

Siehe auch

Gilt für:

ToString(String)

Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
public string ToString (string? format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parameter

format
String

Eine numerische Formatierungszeichenfolge.

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format.

Ausnahmen

Der format-Parameter ist ungültig.

Beispiele

Im folgenden Beispiel wird ein 32-Bit-Ganzzahlwert ohne Vorzeichen angezeigt, indem jede Standardformatzeichenfolge und einige benutzerdefinierte Formatzeichenfolgen verwendet werden.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      uint value = 2179608;
      string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", 
                              "N", "P", "X", "000000.0", "#.0", 
                              "00000000;(0);**Zero**" };
      
      foreach (string specifier in specifiers)
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
   }
}
// The example displays the following output:
//       G: 2179608
//       C: $2,179,608.00
//       D3: 2179608
//       E2: 2.18E+006
//       e3: 2.180e+006
//       F: 2179608.00
//       N: 2,179,608.00
//       P: 217,960,800.00 %
//       X: 214218
//       000000.0: 2179608.0
//       #.0: 2179608.0
//       00000000;(0);**Zero**: 02179608
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim value As UInteger = 2179608 
      Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
                                     "N", "P", "X", "000000.0", "#.0", _
                                     "00000000;(0);**Zero**" }
      
      For Each specifier As String In specifiers
         Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
      Next
   End Sub
End Module
' The example displays the following output:
'       G: 2179608
'       C: $2,179,608.00
'       D3: 2179608
'       E2: 2.18E+006
'       e3: 2.180e+006
'       F: 2179608.00
'       N: 2,179,608.00
'       P: 217,960,800.00 %
'       X: 214218
'       000000.0: 2179608.0
'       #.0: 2179608.0
'       00000000;(0);**Zero**: 02179608

Hinweise

Die ToString(String) -Methode UInt32 formatiert einen Wert in einem angegebenen Format mithilfe eines -Objekts, NumberFormatInfo das die Konventionen der aktuellen Kultur darstellt. Wenn Sie das Standardformat ("G" oder "Allgemein") verwenden oder eine andere Kultur angeben möchten, verwenden Sie die anderen Überladungen der -Methode ToString wie folgt:

So verwenden Sie das Format Für Kultur Verwenden der Überladung
Standardformat ("G") Standardkultur (aktuell) ToString()
Standardformat ("G") Eine bestimmte Kultur ToString(IFormatProvider)
Ein bestimmtes Format Eine bestimmte Kultur ToString(String, IFormatProvider)

Der format -Parameter kann eine beliebige gültige numerische Standardformatzeichenfolgeoder eine beliebige Kombination aus benutzerdefinierten numerischen Formatzeichenfolgen sein. Wenn gleich oder ist, wird der Rückgabewert des aktuellen Objekts mit dem allgemeinen Formatbezeichner format String.Empty null UInt32 ("G") formatiert. Wenn format ein anderer Wert ist, löst die -Methode eine FormatException aus.

.NET bietet umfassende Formatierungsunterstützung, die in den folgenden Formatierungsthemen ausführlicher beschrieben wird:

Das Format der zurückgegebenen Zeichenfolge wird durch das NumberFormatInfo -Objekt für die aktuelle Kultur bestimmt. Je nach Parameter steuert dieses Objekt Symbole wie das Gruppentrennzeichen und das Dezimaltrennzeichen format in der Ausgabezeichenfolge. Um Formatierungsinformationen für andere Kulturen als die aktuelle Kultur zur Verfügung zu stellen, rufen Sie die -Überladung ToString(String, IFormatProvider) auf.

Siehe auch

Gilt für:

ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Gibt zurück

String

Die Zeichenfolgendarstellung des Werts dieser Instanz, die aus einer Folge von Ziffern zwischen 0 (null) und 9 ohne Vorzeichen und führende Nullen besteht.

Beispiele

Im folgenden Beispiel wird ein UInt32 -Wert mithilfe der Standardmethode ToString() angezeigt. Außerdem werden die Zeichenfolgendarstellungen des Werts angezeigt, der UInt32 sich aus der Verwendung einiger Standardformatbezeichner ergibt. Die Beispiele werden mithilfe der Formatierungskonventionen der Kultur "en-US" angezeigt.

using System;

public class Example
{
   public static void Main()
   {
      uint value = 1632490;
      // Display value using default ToString method.
      Console.WriteLine(value.ToString());      
      Console.WriteLine();
      
      // Define an array of format specifiers.
      string[] formats = { "G", "C", "D", "F", "N", "X" };
      // Display value using the standard format specifiers.
      foreach (string format in formats)
         Console.WriteLine("{0} format specifier: {1,16}", 
                           format, value.ToString(format));         
   }
}
// The example displays the following output:
//       1632490
//       
//       G format specifier:          1632490
//       C format specifier:    $1,632,490.00
//       D format specifier:          1632490
//       F format specifier:       1632490.00
//       N format specifier:     1,632,490.00
//       X format specifier:           18E8EA
Module Example
   Public Sub Main()
      Dim value As UInteger = 1632490
      ' Display value using default ToString method.
      Console.WriteLine(value.ToString())            
      Console.WriteLine()
      
      ' Define an array of format specifiers.
      Dim formats() As String = { "G", "C", "D", "F", "N", "X" }
      ' Display value using the standard format specifiers.
      For Each format As String In formats
         Console.WriteLine("{0} format specifier: {1,16}", _
                           format, value.ToString(format))         
      Next
   End Sub
End Module
' The example displays the following output:
'       1632490
'       
'       G format specifier:          1632490
'       C format specifier:    $1,632,490.00
'       D format specifier:          1632490
'       F format specifier:       1632490.00
'       N format specifier:     1,632,490.00
'       X format specifier:           18E8EA

Hinweise

Die ToString() -Methode UInt32 formatiert einen Wert im Standardformat ("G" oder "Allgemein") mithilfe des -Objekts NumberFormatInfo der aktuellen Kultur. Wenn Sie ein anderes Format oder eine andere Kultur angeben möchten, verwenden Sie die anderen Überladungen der -Methode ToString wie folgt:

So verwenden Sie das Format Für Kultur Verwenden der Überladung
Standardformat ("G") Eine bestimmte Kultur ToString(IFormatProvider)
Ein bestimmtes Format Standardkultur (aktuell) ToString(String)
Ein bestimmtes Format Eine bestimmte Kultur ToString(String, IFormatProvider)

Siehe auch

Gilt für: