SByte.ToString SByte.ToString SByte.ToString SByte.ToString Method

Definition

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation.

Überlädt

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) ToString(String)

Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString() ToString() ToString() ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

public:
 virtual System::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 IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von provider.The string representation of the value of this instance, as specified by provider.

Implementiert

Beispiele

Im folgenden Beispiel wird ein Benutzer NumberFormatInfo definiertes-Objekt definiert und das Zeichen NegativeSign "~" der-Eigenschaft zugewiesen.The following example defines a custom NumberFormatInfo object and assigns the "~" character to its NegativeSign property. Im Beispiel wird dann dieses benutzerdefinierte-Objekt und das NumberFormatInfo -Objekt der invarianten Kultur verwendet, um eine Reihe SByte von Werten zu formatieren.The example then uses this custom object as well as the NumberFormatInfo object of the invariant culture to format a series of SByte values.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Define a custom NumberFormatInfo object with "~" as its negative sign.
      NumberFormatInfo nfi = new NumberFormatInfo();
      nfi.NegativeSign = "~";
      
      // Initialize an array of SByte values.
      sbyte[] bytes = { -122, 17, 124 };

      // Display the formatted result using the custom provider.
      Console.WriteLine("Using the custom NumberFormatInfo object:");
      foreach (sbyte value in bytes)
         Console.WriteLine(value.ToString(nfi));

      Console.WriteLine();
          
      // Display the formatted result using the invariant culture.
      Console.WriteLine("Using the invariant culture:");
      foreach (sbyte value in bytes)
         Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo));
   }
}
// The example displays the following output:
//       Using the custom NumberFormatInfo object:
//       ~122
//       17
//       124
//       
//       Using the invariant culture:
//       -122
//       17
//       124
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Define a custom NumberFormatInfo object with "~" as its negative sign.
      Dim nfi As New NumberFormatInfo()
      nfi.NegativeSign = "~"
      
      ' Initialize an array of SByte values.
      Dim bytes() As SByte = { -122, 17, 124 }

      ' Display the formatted result using the custom provider.
      Console.WriteLine("Using the custom NumberFormatInfo object:")
      For Each value As SByte In bytes
         Console.WriteLine(value.ToString(nfi))
      Next
      Console.WriteLine()
          
      ' Display the formatted result using the invariant culture.
      Console.WriteLine("Using the invariant culture:")
      For Each value As SByte In bytes
         Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo))
      Next   
   End Sub
End Module
' The example displays the following output:
'       Using the custom NumberFormatInfo object:
'       ~122
'       17
'       124
'       
'       Using the invariant culture:
'       -122
'       17
'       124

Hinweise

Die ToString(IFormatProvider) -Methode formatiert einen SByte -Wert im Standardformat ("G" oder allgemein) einer angegebenen Kultur.The ToString(IFormatProvider) method formats an SByte value in the default ("G", or general) format of a specified culture. Wenn Sie ein anderes Format oder die aktuelle Kultur angeben möchten, verwenden Sie die anderen über Ladungen ToString der-Methode wie folgt:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Standardformat ("G")Default ("G") format Standard Kultur (aktuell)Default (current) culture ToString()
Ein bestimmtes FormatA specific format Standard Kultur (aktuell)Default (current) culture ToString(String)
Ein bestimmtes FormatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Der provider -Parameter ist IFormatProvider eine-Implementierung.The provider parameter is an IFormatProvider implementation. Die GetFormat zugehörige- NumberFormatInfo Methode gibt ein-Objekt zurück, das kulturspezifische Informationen zum Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. provider SByte Wenn den Wert NumberFormatInfo hat, wird der Wert mithilfe des-Objekts der aktuellen Kultur formatiert. nullIf provider is null, the SByte value is formatted using the NumberFormatInfo object of the current culture. Die einzige Eigenschaft des NumberFormatInfo -Objekts, das die Zeichen folgen Darstellung SByte des Werts mit dem allgemeinen Format Bezeichner steuert NumberFormatInfo.NegativeSign, ist, wodurch das Zeichen definiert wird, das das negative Vorzeichen darstellt.The only property of the NumberFormatInfo object that controls the string representation of the SByte value using the general format specifier is NumberFormatInfo.NegativeSign, which defines the character that represents the negative sign.

Der provider Parameter kann eines der folgenden sein:The provider parameter can be one of the following:

Siehe auch

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider)

Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::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 String String String

Eine standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.A standard or custom numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.An object that supplies culture-specific formatting information.

Gibt zurück

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format und provider.The string representation of the value of this instance as specified by format and provider.

Implementiert

Ausnahmen

format ist ungültig.format is invalid.

Beispiele

Im folgenden Beispiel werden ein positiver und ein negativer SByte Wert mit den numerischen Standardformat bezeichnerwerten und einer Reihe spezifischer CultureInfo -Objekte angezeigt.The following example displays both a positive and a negative SByte value using the standard numeric format specifiers and a number of specific CultureInfo objects.

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") };
      sbyte positiveNumber = 119;
      sbyte negativeNumber = -45;
      string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}; 
      
      foreach (string specifier in specifiers)
      {
         foreach (CultureInfo culture in cultures)
            Console.WriteLine("{0,2} format using {1} culture: {2, 16} {3, 16}",  
                              specifier, culture.Name, 
                              positiveNumber.ToString(specifier, culture), 
                              negativeNumber.ToString(specifier, culture));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//     G format using en-US culture:              119              -45
//     G format using fr-FR culture:              119              -45
//     G format using es-ES culture:              119              -45
//    
//     C format using en-US culture:          $119.00         ($45.00)
//     C format using fr-FR culture:         119,00 €         -45,00 €
//     C format using es-ES culture:         119,00 €         -45,00 €
//    
//    D4 format using en-US culture:             0119            -0045
//    D4 format using fr-FR culture:             0119            -0045
//    D4 format using es-ES culture:             0119            -0045
//    
//    E2 format using en-US culture:        1.19E+002       -4.50E+001
//    E2 format using fr-FR culture:        1,19E+002       -4,50E+001
//    E2 format using es-ES culture:        1,19E+002       -4,50E+001
//    
//     F format using en-US culture:           119.00           -45.00
//     F format using fr-FR culture:           119,00           -45,00
//     F format using es-ES culture:           119,00           -45,00
//    
//     N format using en-US culture:           119.00           -45.00
//     N format using fr-FR culture:           119,00           -45,00
//     N format using es-ES culture:           119,00           -45,00
//    
//     P format using en-US culture:      11,900.00 %      -4,500.00 %
//     P format using fr-FR culture:      11 900,00 %      -4 500,00 %
//     P format using es-ES culture:      11.900,00 %      -4.500,00 %
//    
//    X2 format using en-US culture:               77               D3
//    X2 format using fr-FR culture:               77               D3
//    X2 format using es-ES culture:               77               D3
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 positiveNumber As SByte = 119
      Dim negativeNumber As SByte = -45
      Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"} 
      
      For Each specifier As String In specifiers
         For Each culture As CultureInfo In Cultures
            Console.WriteLine("{0,2} format using {1} culture: {2, 16} {3, 16}", _ 
                              specifier, culture.Name, _
                              positiveNumber.ToString(specifier, culture), _
                              negativeNumber.ToString(specifier, culture))

         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'     G format using en-US culture:              119              -45
'     G format using fr-FR culture:              119              -45
'     G format using es-ES culture:              119              -45
'    
'     C format using en-US culture:          $119.00         ($45.00)
'     C format using fr-FR culture:         119,00 €         -45,00 €
'     C format using es-ES culture:         119,00 €         -45,00 €
'    
'    D4 format using en-US culture:             0119            -0045
'    D4 format using fr-FR culture:             0119            -0045
'    D4 format using es-ES culture:             0119            -0045
'    
'    E2 format using en-US culture:        1.19E+002       -4.50E+001
'    E2 format using fr-FR culture:        1,19E+002       -4,50E+001
'    E2 format using es-ES culture:        1,19E+002       -4,50E+001
'    
'     F format using en-US culture:           119.00           -45.00
'     F format using fr-FR culture:           119,00           -45,00
'     F format using es-ES culture:           119,00           -45,00
'    
'     N format using en-US culture:           119.00           -45.00
'     N format using fr-FR culture:           119,00           -45,00
'     N format using es-ES culture:           119,00           -45,00
'    
'     P format using en-US culture:      11,900.00 %      -4,500.00 %
'     P format using fr-FR culture:      11 900,00 %      -4 500,00 %
'     P format using es-ES culture:      11.900,00 %      -4.500,00 %
'    
'    X2 format using en-US culture:               77               D3
'    X2 format using fr-FR culture:               77               D3
'    X2 format using es-ES culture:               77               D3

Hinweise

Die ToString(String, IFormatProvider) -Methode formatiert einen SByte -Wert in einem angegebenen Format einer angegebenen Kultur.The ToString(String, IFormatProvider) method formats an SByte value in a specified format of a specified culture. Wenn Sie die Standardformat-oder Kultur Einstellungen verwenden möchten, verwenden Sie die anderen über Ladungen ToString der-Methode wie folgt:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Standardformat ("G")Default ("G") format Standard Kultur (aktuell)Default (current) culture ToString()
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Ein bestimmtes FormatA specific format Standard Kultur (aktuell)Default (current) culture ToString(String)

Der format -Parameter kann ein beliebiger gültiger numerischer Standardformat Bezeichner oder eine beliebige Kombination von benutzerdefinierten numerischen Format Bezeichnern sein.The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. Wenn format SByte gleich oder ist null, wird der Rückgabewert des aktuellen-Objekts mit dem allgemeinen Format Bezeichner ("G") formatiert. String.EmptyIf format is equal to String.Empty or is null, the return value of the current SByte object is formatted with the general format specifier ("G"). Wenn format ein beliebiger anderer Wert ist, löst die FormatExceptionMethode eine aus.If format is any other value, the method throws a FormatException.

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Der provider -Parameter ist IFormatProvider eine-Implementierung.The provider parameter is an IFormatProvider implementation. Die GetFormat zugehörige- NumberFormatInfo Methode gibt ein-Objekt zurück, das kulturspezifische Informationen zum Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string returned by this method. Wenn die ToString(String, IFormatProvider) -Methode aufgerufen wird, ruft Sie provider die- IFormatProvider.GetFormat Methode des-Parameters Type auf und übergibt ihr NumberFormatInfo ein-Objekt, das den-Typ darstellt.When the ToString(String, IFormatProvider) method is invoked, it calls the provider parameter's IFormatProvider.GetFormat method and passes it a Type object that represents the NumberFormatInfo type. Die GetFormat -Methode gibt dann NumberFormatInfo das-Objekt zurück, das Informationen value zum Formatieren des-Parameters bereitstellt, z. b. das negative Vorzeichen Symbol, das Gruppen Trennzeichen Symbol oder das Dezimaltrennzeichen.The GetFormat method then returns the NumberFormatInfo object that provides information for formatting the value parameter, such as the negative sign symbol, the group separator symbol, or the decimal point symbol. Es gibt drei Möglichkeiten, den provider -Parameter zu verwenden, um Formatierungsinformationen für die ToString(String, IFormatProvider) -Methode bereitzustellen:There are three ways to use the provider parameter to supply formatting information to the ToString(String, IFormatProvider) method:

  • Sie können ein CultureInfo -Objekt übergeben, das die Kultur darstellt, die Formatierungsinformationen bereitstellt.You can pass a CultureInfo object that represents the culture that supplies formatting information. NumberFormatInfo Die- GetFormat Methode gibt das-Objekt zurück, das numerische Formatierungsinformationen für diese Kultur bereitstellt.Its GetFormat method returns the NumberFormatInfo object that provides numeric formatting information for that culture.

  • Sie können das tatsächliche NumberFormatInfo -Objekt übergeben, das numerische Formatierungsinformationen bereitstellt.You can pass the actual NumberFormatInfo object that provides numeric formatting information. (Die Implementierung von GetFormat gibt nur sich selbst zurück.)(Its implementation of GetFormat just returns itself.)

  • Sie können ein benutzerdefiniertes Objekt übergeben IFormatProvider, das implementiert.You can pass a custom object that implements IFormatProvider. Die- NumberFormatInfo Methode instanziiert und gibt das Objekt zurück, das Formatierungsinformationen bereitstellt. GetFormatIts GetFormat method instantiates and returns the NumberFormatInfo object that provides formatting information.

Wenn providerden Wert NumberFormatInfo hat, basiert die Formatierung der zurückgegebenen Zeichenfolge auf dem-Objekt der aktuellen Kultur. nullIf provider is null, the formatting of the returned string is based on the NumberFormatInfo object of the current culture.

Siehe auch

ToString(String) ToString(String) ToString(String) ToString(String)

Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

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

Parameter

format
String String String String

Eine standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.A standard or custom numeric format string.

Gibt zurück

Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format.The string representation of the value of this instance as specified by format.

Ausnahmen

format ist ungültig.format is invalid.

Beispiele

Im folgenden Beispiel wird ein Array von SByte -Werten initialisiert und mit den einzelnen Standardformat Zeichenfolgen und einigen benutzerdefinierten Format Zeichenfolgen angezeigt.The following example initializes an array of SByte values and displays them by using each standard format string and some custom format strings.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      sbyte[] values = { -124, 0, 118 };
      string[] specifiers = { "G", "C", "D3", "E2", "e3", "F", 
                              "N", "P", "X", "00.0", "#.0", 
                              "000;(0);**Zero**" };
      
      foreach (sbyte value in values)
      {
         foreach (string specifier in specifiers)
            Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       G: -124
//       C: ($124.00)
//       D3: -124
//       E2: -1.24E+002
//       e3: -1.240e+002
//       F: -124.00
//       N: -124.00
//       P: -12,400.00 %
//       X: 84
//       00.0: -124.0
//       #.0: -124.0
//       000;(0);**Zero**: (124)
//       
//       G: 0
//       C: $0.00
//       D3: 000
//       E2: 0.00E+000
//       e3: 0.000e+000
//       F: 0.00
//       N: 0.00
//       P: 0.00 %
//       X: 0
//       00.0: 00.0
//       #.0: .0
//       000;(0);**Zero**: **Zero**
//       
//       G: 118
//       C: $118.00
//       D3: 118
//       E2: 1.18E+002
//       e3: 1.180e+002
//       F: 118.00
//       N: 118.00
//       P: 11,800.00 %
//       X: 76
//       00.0: 118.0
//       #.0: 118.0
//       000;(0);**Zero**: 118
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As SByte = { -124, 0, 118 }
      Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
                                     "N", "P", "X", "00.0", "#.0", _
                                     "000;(0);**Zero**" }
      
      For Each value As SByte In values
         For Each specifier As String In specifiers
            Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'       G: -124
'       C: ($124.00)
'       D3: -124
'       E2: -1.24E+002
'       e3: -1.240e+002
'       F: -124.00
'       N: -124.00
'       P: -12,400.00 %
'       X: 84
'       00.0: -124.0
'       #.0: -124.0
'       000;(0);**Zero**: (124)
'       
'       G: 0
'       C: $0.00
'       D3: 000
'       E2: 0.00E+000
'       e3: 0.000e+000
'       F: 0.00
'       N: 0.00
'       P: 0.00 %
'       X: 0
'       00.0: 00.0
'       #.0: .0
'       000;(0);**Zero**: **Zero**
'       
'       G: 118
'       C: $118.00
'       D3: 118
'       E2: 1.18E+002
'       e3: 1.180e+002
'       F: 118.00
'       N: 118.00
'       P: 11,800.00 %
'       X: 76
'       00.0: 118.0
'       #.0: 118.0
'       000;(0);**Zero**: 118

Hinweise

Die ToString(String) -Methode formatiert einen SByte -Wert in einem angegebenen Format unter Verwendung der Konventionen der aktuellen Kultur.The ToString(String) method formats an SByte value in a specified format by using the conventions of the current culture. Wenn Sie das Standardformat ("G" oder "Allgemein") verwenden oder eine andere Kultur angeben möchten, verwenden Sie die anderen über Ladungen ToString der-Methode wie folgt:If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Standardformat ("G")Default ("G") format Standard Kultur (aktuell)Default (current) culture ToString()
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Ein bestimmtes FormatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Der format -Parameter kann ein beliebiger gültiger numerischer Standardformat Bezeichner oder eine beliebige Kombination von benutzerdefinierten numerischen Format Bezeichnern sein.The format parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. Wenn format SByte gleich oder ist null, wird der Rückgabewert des aktuellen-Objekts mit dem allgemeinen Format Bezeichner ("G") formatiert. String.EmptyIf format is equal to String.Empty or is null, the return value of the current SByte object is formatted with the general format specifier ("G"). Wenn format ein beliebiger anderer Wert ist, löst die FormatExceptionMethode eine aus.If format is any other value, the method throws a FormatException.

Der .NET Framework bietet umfassende Formatierungs Unterstützung, die in den folgenden Formatierungs Themen ausführlicher beschrieben wird:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Das Format der zurückgegebenen Zeichenfolge wird durch das NumberFormatInfo -Objekt für die aktuelle Kultur bestimmt.The format of the returned string is determined by the NumberFormatInfo object for the current culture. Abhängig vom format -Parameter steuert dieses-Objekt Symbole wie das negative Vorzeichen, das Gruppen Trennzeichen und das Dezimaltrennzeichen in der Ausgabe Zeichenfolge.Depending on the format parameter, this object controls symbols such as the negative sign, the group separator, and the decimal point symbol in the output string. Um Formatierungsinformationen für andere Kulturen als die aktuelle Kultur bereitzustellen, ToString(String, IFormatProvider) müssen Sie die-Überladung aufrufen.To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Siehe auch

ToString() ToString() ToString() ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.Converts the numeric value of this instance to its equivalent string representation.

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

Gibt zurück

Die Zeichenfolgendarstellung des Werts dieser Instanz, die aus einem Minuszeichen, sofern die Zahl negativ ist, und einer Folge von Ziffern zwischen 0 bis 9 ohne führende Nullen besteht.The string representation of the value of this instance, consisting of a negative sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

Beispiele

Im folgenden Beispiel wird ein SByte -Wert mit der ToString() -Standardmethode angezeigt.The following example displays an SByte value using the default ToString() method. Außerdem werden die Zeichen folgen Darstellungen des SByte Werts angezeigt, der sich aus der Verwendung einer Reihe von Standardformat bezeichnerwerten ergibt.It also displays the string representations of the SByte value that results from using a number of standard format specifiers. Die Beispiele werden mithilfe der Formatierungs Konventionen der Kultur "en-US" angezeigt.The examples are displayed using the formatting conventions of the en-US culture.

using System;

public class Example
{
   public static void Main()
   {
      sbyte value = -123;
      // Display value using default ToString method.
      Console.WriteLine(value.ToString());            // Displays -123
      // Display value using some standard format specifiers.
      Console.WriteLine(value.ToString("G"));         // Displays -123
      Console.WriteLine(value.ToString("C"));         // Displays ($-123.00)
      Console.WriteLine(value.ToString("D"));         // Displays -123
      Console.WriteLine(value.ToString("F"));         // Displays -123.00
      Console.WriteLine(value.ToString("N"));         // Displays -123.00
      Console.WriteLine(value.ToString("X"));         // Displays 85
   }
}
Module Example
   Public Sub Main()
      Dim value As SByte = -123
      ' Display value using default ToString method.
      Console.WriteLine(value.ToString())            ' Displays -123
      ' Display value using some standard format specifiers.
      Console.WriteLine(value.ToString("G"))         ' Displays -123
      Console.WriteLine(value.ToString("C"))         ' Displays ($-123.00)
      Console.WriteLine(value.ToString("D"))         ' Displays -123
      Console.WriteLine(value.ToString("F"))         ' Displays -123.00
      Console.WriteLine(value.ToString("N"))         ' Displays -123.00
      Console.WriteLine(value.ToString("X"))         ' Displays 85
   End Sub
End Module

Hinweise

Die ToString() -Methode formatiert einen SByte -Wert im Standardformat ("G" oder allgemein) der aktuellen Kultur.The ToString() method formats an SByte value in the default ("G", or general) format of the current culture. Wenn Sie ein anderes Format oder eine andere Kultur angeben möchten, verwenden Sie die anderen über Ladungen ToString der-Methode wie folgt:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

So verwenden Sie das FormatTo use format Für KulturFor culture Verwenden der ÜberladungUse the overload
Standardformat ("G")Default ("G") format Eine bestimmte KulturA specific culture ToString(IFormatProvider)
Ein bestimmtes FormatA specific format Standard Kultur (aktuell)Default (current) culture ToString(String)
Ein bestimmtes FormatA specific format Eine bestimmte KulturA specific culture ToString(String, IFormatProvider)

Der Rückgabewert wird mithilfe des allgemeinen numerischen Format Bezeichnern ("G") formatiert. die Zeichen folgen SByte Darstellung des Werts enthält ein negatives Vorzeichen, wenn der Wert negativ ist, und eine Folge von Ziffern zwischen 0 und 9 ohne führende Nullen.The return value is formatted using the general numeric format specifier ("G") The string representation of the SByte value includes a negative sign if its value is negative, and a sequence of digits ranging from 0 to 9 without leading zeros. Das negative Vorzeichen wird durch das NumberFormatInfo -Objekt für die aktuelle Kultur definiert.The negative sign is defined by the NumberFormatInfo object for the current culture.

Um die Formatierung der Zeichen folgen Darstellung des Bytewerts zu definieren, müssen ToString(String) Sie die-Methode aufzurufen.To define the formatting of the signed byte value's string representation, call the ToString(String) method.

Siehe auch

Gilt für: