SByte.ToString Methode

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)

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)

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)

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()

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

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

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 benutzerdefiniertes NumberFormatInfo Objekt definiert, und der NegativeSign-Eigenschaft wird das Zeichen "~" 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 von SByte 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 der ToString-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 eine IFormatProvider Implementierung.The provider parameter is an IFormatProvider implementation. Die GetFormat-Methode gibt ein NumberFormatInfo 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 provider nullist, wird der SByte Wert mithilfe des NumberFormatInfo Objekts der aktuellen Kultur formatiert.If 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 des SByte Werts mit dem allgemeinen Format Bezeichner steuert, ist NumberFormatInfo.NegativeSign, der das Zeichen definiert, 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)

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

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

provider
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 wird sowohl ein positiver als auch ein negativer SByte Wert mit den numerischen Standardformat bezeichnerwerten und einer Reihe spezifischer CultureInfo Objekten 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 der ToString-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 gleich String.Empty oder nullist, wird der Rückgabewert des aktuellen SByte Objekts mit dem allgemeinen Format Bezeichner ("G") formatiert.If 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 einen anderen Wert hat, löst die Methode eine FormatExceptionaus.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 eine IFormatProvider Implementierung.The provider parameter is an IFormatProvider implementation. Die GetFormat-Methode gibt ein NumberFormatInfo 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 die IFormatProvider.GetFormat-Methode des provider-Parameters auf und übergibt ihr ein Type Objekt, das den NumberFormatInfo 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 das NumberFormatInfo Objekt zurück, das Informationen zum Formatieren des value Parameters bereitstellt, z. b. das negative Vorzeichen Symbol, das Gruppen Trennzeichen 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. Die GetFormat-Methode gibt das NumberFormatInfo 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 nur sich selbst zurückgegeben.)(Its implementation of GetFormat just returns itself.)

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

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

Siehe auch

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

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 der ToString-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 gleich String.Empty oder nullist, wird der Rückgabewert des aktuellen SByte Objekts mit dem allgemeinen Format Bezeichner ("G") formatiert.If 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 einen anderen Wert hat, löst die Methode eine FormatExceptionaus.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, müssen Sie die ToString(String, IFormatProvider) Überladung aufrufen.To provide formatting information for cultures other than the current culture, call the ToString(String, IFormatProvider) overload.

Siehe auch

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 unter Verwendung der standardmäßigen ToString()-Methode 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 der ToString-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 Darstellung des SByte 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 Byte-Werts mit Vorzeichen zu definieren, müssen Sie die ToString(String)-Methode aufzurufen.To define the formatting of the signed byte value's string representation, call the ToString(String) method.

Siehe auch

Gilt für: