SByte.ToString Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von provider
.
Implementiert
Beispiele
Im folgenden Beispiel wird ein benutzerdefiniertes -Objekt definiert NumberFormatInfo und der -Eigenschaft das Zeichen "~" NegativeSign zugewiesen. Im Beispiel werden dann dieses benutzerdefinierte -Objekt und das NumberFormatInfo -Objekt der invarianten Kultur verwendet, um eine Reihe von Werten zu SByte formatieren.
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. Wenn Sie ein anderes Format oder die aktuelle Kultur angeben möchten, verwenden Sie die anderen Überladungen der ToString -Methode 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 Informationen zum Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt. Wenn provider
null
ist, wird der SByte Wert mit dem NumberFormatInfo -Objekt der aktuellen Kultur formatiert. Die einzige Eigenschaft des NumberFormatInfo -Objekts, das die Zeichenfolgendarstellung des SByte Werts mithilfe des allgemeinen Formatbezeichners steuert, ist NumberFormatInfo.NegativeSign , die das Zeichen definiert, das das negative Vorzeichen darstellt.
Der provider
Parameter kann eine der folgenden Sein:
Ein CultureInfo -Objekt, das die Kultur darstellt, die Formatierungsinformationen liefert.
Das NumberFormatInfo -Objekt, das Formatierungsinformationen liefert.
Ein benutzerdefiniertes -Objekt, das IFormatProvider implementiert. Die GetFormat -Methode gibt das NumberFormatInfo -Objekt zurück, das Formatierungsinformationen angibt.
Siehe auch
- Formatieren von Typen in .NET
- Standardmäßige Zahlenformatzeichenfolgen
- Benutzerdefinierte Zahlenformatzeichenfolgen
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 standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.
- provider
- IFormatProvider
Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.
Gibt zurück
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format
und provider
.
Implementiert
Ausnahmen
format
ist ungültig.
Beispiele
Im folgenden Beispiel werden sowohl ein positiver als auch ein negativer SByte Wert mit den standardmäßigen numerischen Formatbezeichnern und einer Reihe von bestimmten CultureInfo Objekten 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") };
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. Wenn Sie Standardformat- oder Kultureinstellungen verwenden möchten, verwenden Sie die anderen Überladungen der ToString -Methode 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 ein beliebiger gültiger numerischer Standardformatbezeichner oder eine beliebige Kombination benutzerdefinierter numerischer Formatbezeichner sein. Wenn format
gleich String.Empty oder null
ist, wird der Rückgabewert des aktuellen SByte Objekts mit dem allgemeinen Formatbezeichner ("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:
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Standardmäßige numerische Formatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Unterstützung der Formatierung in .NET finden Sie unter Formatieren von Typen.
Der provider
-Parameter ist eine IFormatProvider -Implementierung. Die GetFormat -Methode gibt ein NumberFormatInfo -Objekt zurück, das kulturspezifische Informationen zum Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt. Wenn die ToString(String, IFormatProvider) Methode aufgerufen wird, ruft sie die -Methode des Parameters auf provider
und IFormatProvider.GetFormat übergibt ihr ein Type -Objekt, das den NumberFormatInfo Typ darstellt. Die GetFormat -Methode gibt dann das NumberFormatInfo -Objekt zurück, das Informationen zum Formatieren des value
Parameters bereitstellt, z. B. das Minuszeichen, das Gruppentrennzeichen oder das Dezimaltrennzeichen. Es gibt drei Möglichkeiten, den -Parameter zum Bereitstellen von provider
Formatierungsinformationen für die -Methode zu ToString(String, IFormatProvider) verwenden:
Sie können ein CultureInfo -Objekt übergeben, das die Kultur darstellt, die Formatierungsinformationen angibt. Die GetFormat -Methode gibt das NumberFormatInfo -Objekt zurück, das numerische Formatierungsinformationen für diese Kultur bereitstellt.
Sie können das tatsächliche NumberFormatInfo Objekt übergeben, das numerische Formatierungsinformationen bereitstellt. (Die Implementierung von GetFormat gibt sich einfach selbst zurück.)
Sie können ein benutzerdefiniertes -Objekt übergeben, das IFormatProvider implementiert. Die GetFormat -Methode instanziiert das NumberFormatInfo -Objekt, das Formatierungsinformationen bereitstellt, und gibt es zurück.
Wenn provider
null
ist, basiert die Formatierung der zurückgegebenen Zeichenfolge auf dem NumberFormatInfo -Objekt der aktuellen Kultur.
Siehe auch
- Formatieren von Typen in .NET
- Vorgehensweise: Auffüllen einer Zahl mit führenden Nullen
- Standardmäßige Zahlenformatzeichenfolgen
- Benutzerdefinierte Zahlenformatzeichenfolgen
- Beispiel: .NET Core-Hilfsprogramm zur Formatierung von WinForms (C#)
- Beispiel: .NET Core-Hilfsprogramm zur Formatierung von WinForms (Visual Basic)
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 standardmäßige oder benutzerdefinierte numerische Formatierungszeichenfolge.
Gibt zurück
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format
.
Ausnahmen
format
ist ungültig.
Beispiele
Im folgenden Beispiel wird ein Array von Werten initialisiert SByte und mithilfe jeder Standardformatzeichenfolge und einiger benutzerdefinierter Formatzeichenfolgen angezeigt.
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. Wenn Sie das Standardformat ("G" oder "Allgemein") verwenden oder eine andere Kultur angeben möchten, verwenden Sie die anderen Überladungen der ToString -Methode 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 ein beliebiger gültiger numerischer Standardformatbezeichner oder eine beliebige Kombination benutzerdefinierter numerischer Formatbezeichner sein. Wenn format
gleich String.Empty oder null
ist, wird der Rückgabewert des aktuellen SByte Objekts mit dem allgemeinen Formatbezeichner ("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:
Weitere Informationen zu numerischen Formatbezeichnern finden Sie unter Standardmäßige numerische Formatzeichenfolgen und benutzerdefinierte numerische Formatzeichenfolgen.
Weitere Informationen zur Unterstützung der Formatierung in .NET finden Sie unter Formatieren von Typen.
Das Format der zurückgegebenen Zeichenfolge wird durch das NumberFormatInfo -Objekt für die aktuelle Kultur bestimmt. Abhängig vom format
Parameter steuert dieses Objekt Symbole wie das negative Vorzeichen, das Gruppentrennzeichen und das Dezimaltrennzeichen in der Ausgabezeichenfolge. Um Formatierungsinformationen für andere Kulturen als die aktuelle Kultur bereitzustellen, rufen Sie die ToString(String, IFormatProvider) -Überladung auf.
Siehe auch
- Formatieren von Typen in .NET
- Vorgehensweise: Auffüllen einer Zahl mit führenden Nullen
- Standardmäßige Zahlenformatzeichenfolgen
- Benutzerdefinierte Zahlenformatzeichenfolgen
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
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.
Beispiele
Im folgenden Beispiel wird ein SByte Wert mithilfe der ToString() Standardmethode angezeigt. Außerdem werden die Zeichenfolgendarstellungen des SByte Werts angezeigt, die sich aus der Verwendung einer Reihe von Standardformatbezeichnern ergeben. Die Beispiele werden mithilfe der Formatierungskonventionen der Kultur "en-US" angezeigt.
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. Wenn Sie ein anderes Format oder eine andere Kultur angeben möchten, verwenden Sie die anderen Überladungen der ToString -Methode 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) |
Der Rückgabewert wird mit dem allgemeinen numerischen Formatbezeichner ("G") formatiert. Die Zeichenfolgendarstellung des SByte Werts enthält ein negatives Vorzeichen, wenn sein Wert negativ ist, und eine Sequenz von Ziffern im Bereich von 0 bis 9 ohne führende Nullen. Das negative Vorzeichen wird durch das NumberFormatInfo -Objekt für die aktuelle Kultur definiert.
Um die Formatierung der Zeichenfolgendarstellung des Werts mit Vorzeichen zu definieren, rufen Sie die ToString(String) -Methode auf.
Siehe auch
- Formatieren von Typen in .NET
- Standardmäßige Zahlenformatzeichenfolgen
- Benutzerdefinierte Zahlenformatzeichenfolgen