(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Int64.ToString-Methode (String, IFormatProvider)

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

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

public string ToString(
	string format,
	IFormatProvider provider
)

Parameter

format
Typ: System.String
Eine numerische Formatierungszeichenfolge.
provider
Typ: System.IFormatProvider
Ein Objekt, das kulturabhängige Formatierungsinformationen über diese Instanz liefert.

Rückgabewert

Typ: System.String
Die Zeichenfolgendarstellung des Werts dieser Instanz entsprechend den Angaben von format und provider.

Implementiert

IFormattable.ToString(String, IFormatProvider)

AusnahmeBedingung
FormatException

format ist ungültig oder wird nicht unterstützt.

Die ToString(String, IFormatProvider)-Methode formatiert einen Int64-Wert in einem bestimmten Format, indem das NumberFormatInfo-Objekt einer bestimmten Kultur verwendet. Wenn Sie Standardformat verwenden oder Einstellungen ermöglichen möchten, verwenden Sie die übrigen Überladungen der ToString-Methode, wie folgt:

So Format verwenden

Eine Kultur

Verwenden der Überladung

Gehen Sie ("G") Format den Standardwert an

Standardkultur (aktuelle)

ToString()

Gehen Sie ("G") Format den Standardwert an

Einer bestimmten Kultur

ToString(IFormatProvider)

Ein bestimmtes Format

Standardkultur (aktuelle)

ToString(String)

Der format-Parameter kann entweder eine standardmäßige oder eine benutzerdefinierte numerische Formatierungszeichenfolge sein. Alle standardmäßigen numerischen Formatierungszeichenfolgen außer "R" (oder "r") werden ebenso wie alle benutzerdefinierten numerischen Formatierungszeichen unterstützt. Wenn formatnull oder eine leere Zeichenfolge ("") ist, wird der Rückgabewert für diese Instanz mit dem allgemeinen numerischen Formatbezeichner ("G") formatiert.

Der provider-Parameter ist ein Objekt, das die IFormatProvider-Schnittstelle implementiert. Die zugehörige GetFormat-Methode gibt ein NumberFormatInfo-Objekt zurück, das kulturspezifische Informationen über das Format der von dieser Methode zurückgegebenen Zeichenfolge bereitstellt. Das Objekt, das IFormatProvider implementiert, kann eines der folgenden sein:

  • Ein CultureInfo-Objekt, das die Kultur darstellt, deren Formatierungsregeln verwendet werden sollen.

  • Ein NumberFormatInfo-Objekt, das bestimmte numerische Formatierungsinformationen für diesen Wert enthält.

  • Ein benutzerdefiniertes Objekt, das IFormatProvider implementiert und dessen GetFormat-Methode ein NumberFormatInfo-Objekt mit Formatierungsinformationen zurückgibt.

Wenn provider gleich null ist oder kein NumberFormatInfo-Objekt von provider abgerufen werden kann, wird der Rückgabewert für diese Instanz mit der NumberFormatInfo für die aktuelle Kultur formatiert.

.NET Framework bietet eine umfassende Unterstützung von Formatierungen, die in den folgenden Themen zur Formatierung ausführlicher beschrieben werden.

Im folgenden Beispiel werden ein positiver und ein negativer Wert mit den einzelnen unterstützten numerischen Standardformatbezeichnern für drei verschiedene Kulturen angezeigt.


// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"), 
                          CultureInfo.CreateSpecificCulture("fr-FR"), 
                          CultureInfo.CreateSpecificCulture("es-ES") };
long positiveNumber = 1679;
long negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}; 

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} 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 to the console:
//    G format using en-US culture:             1679            -3045
//    G format using fr-FR culture:             1679            -3045
//    G format using es-ES culture:             1679            -3045
//    
//    C format using en-US culture:        $1,679.00      ($3,045.00)
//    C format using fr-FR culture:       1�679,00 ?      -3�045,00 ?
//    C format using es-ES culture:       1.679,00 ?      -3.045,00 ?
//    
//    D8 format using en-US culture:         00001679        -00003045
//    D8 format using fr-FR culture:         00001679        -00003045
//    D8 format using es-ES culture:         00001679        -00003045
//    
//    E2 format using en-US culture:        1.68E+003       -3.05E+003
//    E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//    E2 format using es-ES culture:        1,68E+003       -3,05E+003
//    
//    F format using en-US culture:          1679.00         -3045.00
//    F format using fr-FR culture:          1679,00         -3045,00
//    F format using es-ES culture:          1679,00         -3045,00
//    
//    N format using en-US culture:         1,679.00        -3,045.00
//    N format using fr-FR culture:         1�679,00        -3�045,00
//    N format using es-ES culture:         1.679,00        -3.045,00
//    
//    P format using en-US culture:     167,900.00 %    -304,500.00 %
//    P format using fr-FR culture:     167�900,00 %    -304�500,00 %
//    P format using es-ES culture:     167.900,00 %    -304.500,00 %
//    
//    X8 format using en-US culture:         0000068F         FFFFF41B
//    X8 format using fr-FR culture:         0000068F         FFFFF41B
//    X8 format using es-ES culture:         0000068F         FFFFF41B


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft