Single.ToString Methode

Definitie

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave.

Overloads

Name Description
ToString()

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave.

ToString(IFormatProvider)

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven cultuurspecifieke notatiegegevens.

ToString(String)

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave, met behulp van de opgegeven indeling.

ToString(String, IFormatProvider)

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven indeling en cultuurspecifieke notatiegegevens.

ToString()

Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave.

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

Retouren

De tekenreeksweergave van de waarde van dit exemplaar.

Voorbeelden

In het volgende voorbeeld wordt de standaardmethode Single.ToString gebruikt om de tekenreeksweergaven van een aantal Single waarden weer te geven.

float number;

number = 1.6E20F;
// Displays 1.6E+20.
Console.WriteLine(number.ToString());

number = 1.6E2F;
// Displays 160.
Console.WriteLine(number.ToString());

number = -3.541F;
// Displays -3.541.
Console.WriteLine(number.ToString());

number = -1502345222199E-07F;
// Displays -150234.5222199.
Console.WriteLine(number.ToString());

number = -15023452221990199574E-09F;
// Displays -15023452221.9902.
Console.WriteLine(number.ToString());

number = .60344F;
// Displays 0.60344.
Console.WriteLine(number.ToString());

number = .000000001F;
// Displays 1E-09.
Console.WriteLine(number.ToString());
let number = 1.6E20F
// Displays 1.6E+20.
printfn $"{number.ToString()}"

let number = 1.6E2F
// Displays 160.
printfn $"{number.ToString()}"

let number = -3.541F
// Displays -3.541.
printfn $"{number.ToString()}"

let number = -1502345222199E-07F
// Displays -150234.5222199.
printfn $"{number.ToString()}"

let number = -15023452221990199574E-09F
// Displays -15023452221.9902.
printfn $"{number.ToString()}"

let number = 0.60344F
// Displays 0.60344.
printfn $"{number.ToString()}"

let number = 0.000000001F
// Displays 1E-09.
printfn $"{number.ToString()}"
Dim number As Single

number = 1.6E20
' Displays 1.6E+20.      
Console.WriteLine(number.ToString())

number = 1.6E2
' Displays 160.
Console.WriteLine(number.ToString())

number = -3.541
' Displays -3.541.
Console.WriteLine(number.ToString())

number = -1502345222199E-07
' Displays -150234.5222199.
Console.WriteLine(number.ToString())

number = -15023452221990199574E-09
' Displays -15023452221.9902.
Console.WriteLine(number.ToString())

number = .60344
' Displays 0.60344.
Console.WriteLine(number.ToString())

number = .000000001
' Displays 1E-09.
Console.WriteLine(number.ToString())

Het volgende codevoorbeeld illustreert het gebruik van de Parse(String) methode samen met de ToString() methode.

bool done = false;
string inp;
do
{
    Console.Write("Enter a real number: ");
    inp = Console.ReadLine();
    try
    {
        s = Single.Parse(inp);
        Console.WriteLine("You entered {0}.", s.ToString());
        done = true;
    }
    catch (FormatException)
    {
        Console.WriteLine("You did not enter a number.");
    }
    catch (Exception e)
    {
        Console.WriteLine("An exception occurred while parsing your response: {0}", e.ToString());
    }
} while (!done);
let mutable finished = false
while not finished do
    printf "Enter a real number: "
    let inp = stdin.ReadLine()
    try
        let s = Single.Parse inp
        printfn $"You entered {s}."
        finished <- true
    with 
    | :? FormatException ->
        printfn "You did not enter a number."
    | e ->
        printfn "An exception occurred while parsing your response: {e}"
Dim Done As Boolean = False
Dim Inp As String
Do

    Console.Write("Enter a real number: ")
    Inp = Console.ReadLine()
    Try
        S = Single.Parse(Inp)
        Console.WriteLine("You entered " + S.ToString() + ".")
        Done = True
    Catch E As FormatException
        Console.WriteLine("You did not enter a number.")
    Catch E As Exception
        Console.WriteLine("An exception occurred while parsing your response: " + E.ToString())
    End Try
Loop While Not Done

Opmerkingen

Met ToString() de methode wordt een Single waarde opgemaakt in de standaardnotatie (G of algemeen) van de huidige cultuur. Als u een andere indeling of cultuur wilt opgeven, gebruikt u de andere overbelasting van de ToString methode als volgt:

Indeling gebruiken Voor cultuur De overbelasting gebruiken
Standaardnotatie ('G') Een specifieke cultuur ToString(IFormatProvider)
Een specifieke indeling Standaardcultuur (huidige) ToString(String)
Een specifieke indeling Een specifieke cultuur ToString(String, IFormatProvider)

De retourwaarde kan zijn PositiveInfinitySymbol, NegativeInfinitySymbolof NaNSymboleen tekenreeks van het formulier:

[sign]integral-digits[.[ fractional-digits][e[sign]exponential-digits]

Optionele elementen worden omlijst tussen vierkante haken ([ en ]). Elementen die de term 'cijfers' bevatten, bestaan uit een reeks numerieke tekens tussen 0 en 9. De volgende tabel bevat elk element:

Element Beschrijving
ondertekenen Een negatief teken of een positief teken.
integral-digits Een reeks cijfers die het integraal deel van het getal aangeven. Integrale cijfers kunnen afwezig zijn als er fractionele cijfers zijn.
'.' Een cultuurspecifiek decimaalteken.
fractionele cijfers Een reeks cijfers die het breukgedeelte van het getal aangeven.
'e' Een kleine letter 'e', die exponentiële (wetenschappelijke) notatie aangeeft.
exponentiële cijfers Een reeks cijfers die een exponent aangeeft.

Enkele voorbeelden van de retourwaarde zijn '100', '-123.456.789', '123.45e+6', '500', '3.1416', '600', '-0.123' en '-Infinity'.

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Zie ook

Van toepassing op

ToString(IFormatProvider)

Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven cultuurspecifieke notatiegegevens.

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

Parameters

provider
IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

Retouren

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door provider.

Implementeringen

Voorbeelden

In het volgende voorbeeld wordt de tekenreeksweergave van twee Single waarden weergegeven met behulp van CultureInfo objecten die verschillende culturen vertegenwoordigen.

float value;

value = -16325.62015F;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));

value = 16034.125E21F;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325.62015
//       -16325.62015
//       -16325,62015
//       1.6034125E+25
//       1.6034125E+25
//       1,6034125E+25
let value = -16325.62015F
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""

let value = 16034.125E21F
// Display value using the invariant culture.
printfn $"{value.ToString CultureInfo.InvariantCulture}"
// Display value using the en-GB culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "en-GB")}"""
// Display value using the de-DE culture.
printfn $"""{value.ToString(CultureInfo.CreateSpecificCulture "de-DE")}"""
// This example displays the following output to the console:
//       -16325.62015
//       -16325.62015
//       -16325,62015
//       1.6034125E+25
//       1.6034125E+25
//       1,6034125E+25
Dim value As Single 

value = -16325.62015
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))

value = 16034.125E21
' Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture))
' Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")))
' Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")))
' This example displays the following output to the console:
'       -16325.62015
'       -16325.62015
'       -16325,62015
'       1.6034125E+25
'       1.6034125E+25
'       1,6034125E+25

Opmerkingen

Met ToString(IFormatProvider) de methode wordt een Single waarde opgemaakt in de standaardnotatie (G of algemeen) van een opgegeven cultuur. Als u een andere notatie of de huidige cultuur wilt opgeven, gebruikt u de andere overbelasting van de ToString methode als volgt:

Indeling gebruiken Voor cultuur De overbelasting gebruiken
Standaardnotatie ('G') Standaardcultuur (huidige) ToString()
Een specifieke indeling Standaardcultuur (huidige) ToString(String)
Een specifieke indeling Een specifieke cultuur ToString(String, IFormatProvider)

De retourwaarde kan zijn PositiveInfinitySymbol, NegativeInfinitySymbolof NaNSymboleen tekenreeks van het formulier:

[sign]integral-digits[.[ fractional-digits][e[sign]exponential-digits]

Optionele elementen worden omlijst tussen vierkante haken ([ en ]). Elementen die de term 'cijfers' bevatten, bestaan uit een reeks numerieke tekens tussen 0 en 9. De volgende tabel bevat elk element.

Element Beschrijving
sign Een negatief teken of een positief teken.
integral-digits Een reeks cijfers die het integraal deel van het getal aangeven. Integrale cijfers kunnen afwezig zijn als er fractionele cijfers zijn.
'.' Een cultuurspecifiek decimaalteken.
fractionele cijfers Een reeks cijfers die het breukgedeelte van het getal aangeven.
'e' Een kleine letter 'e', die exponentiële (wetenschappelijke) notatie aangeeft.
exponentiële cijfers Een reeks cijfers die een exponent aangeeft.

Enkele voorbeelden van de retourwaarde zijn '100', '-123.456.789', '123.45e+6', '500', '3.1416', '600', '-0.123' en '-Infinity'.

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

De provider parameter is een IFormatProvider implementatie waarvan de GetFormat methode een NumberFormatInfo object retourneert. provider Dit is meestal een CultureInfo object of een NumberFormatInfo object. De provider parameter levert cultuurspecifieke informatie die wordt gebruikt in opmaak. Als provider dat het is null, wordt de retourwaarde opgemaakt met behulp van de NumberFormatInfo gegevens voor de huidige cultuur.

Als u een Single waarde wilt converteren naar de tekenreeksweergave met behulp van een opgegeven cultuur en een specifieke notatietekenreeks, roept u de Single.ToString(String, IFormatProvider) methode aan.

Zie ook

Van toepassing op

ToString(String)

Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave, met behulp van de opgegeven indeling.

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

Parameters

format
String

Een tekenreeks met een numerieke notatie.

Retouren

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door format.

Uitzonderingen

format is ongeldig.

Voorbeelden

In het volgende voorbeeld wordt een numerieke waarde gedefinieerd en opgemaakt als een valutawaarde met behulp van de standaardtekenreeks voor numerieke notatie 'C' en als een numerieke waarde tot drie decimalen met behulp van de standaardtekenreeks voor numerieke notatie 'N'. De resultaattekenreeksen worden opgemaakt met behulp van de conventies van de en-US cultuur. Zie Tekenreeksen met standaard numerieke notatie en tekenreeksen met aangepaste numerieke notatie voor meer informatie over tekenreeksen met numerieke notatie.

using System;

public class Example
{
   public static void Main()
   {
      Double number = 1764.3789;
      
      // Format as a currency value.
      Console.WriteLine(number.ToString("C"));
      
      // Format as a numeric value with 3 decimal places.
      Console.WriteLine(number.ToString("N3"));
   }
}
// The example displays the following output:
//       $1,764.38
//       1,764.379
let number = 1764.3789

// Format as a currency value.
printfn $"""{number.ToString "C"}"""

// Format as a numeric value with 3 decimal places.
printfn $"""{number.ToString "N3"}"""
// The example displays the following output:
//       $1,764.38
//       1,764.379
Module Example
   Public Sub Main()
      Dim number As Single = 1764.3789
      
      ' Format as a currency value.
      Console.WriteLine(number.ToString("C"))
      
      ' Format as a numeric value with 3 decimal places.
      Console.WriteLine(number.ToString("N3"))
   End Sub
End Module
' The example displays the following output:
'       $1,764.38
'       1,764.379

In het volgende voorbeeld worden verschillende Single waarden weergegeven met behulp van elk van de ondersteunde standaardaanduidingen voor numerieke notatie, samen met twee aangepaste tekenreeksen voor numerieke notatie. Een van deze tekenreeksen voor aangepaste notatie laat zien hoe u een Single waarde met voorloopnullen kunt opvullingen. Bij het converteren van de numerieke waarden naar tekenreeksen gebruikt het voorbeeld de opmaakconventies van de en-US cultuur.

float[] numbers= { 1054.32179F, -195489100.8377F, 1.0437E21F, 
                   -1.0573e-05F };
string[] specifiers = { "C", "E", "e", "F", "G", "N", "P", 
                        "R", "#,000.000", "0.###E-000",
                        "000,000,000,000.00###" };

foreach (float number in numbers)
{
   Console.WriteLine("Formatting of {0}:", number);
   foreach (string specifier in specifiers)
      Console.WriteLine("   {0,5}: {1}", 
                        specifier, number.ToString(specifier));

   Console.WriteLine();
}
// The example displays the following output to the console:
//       Formatting of 1054.32179:
//              C: $1,054.32
//              E: 1.054322E+003
//              e: 1.054322e+003
//              F: 1054.32
//              G: 1054.32179
//              N: 1,054.32
//              P: 105,432.18 %
//              R: 1054.32179
//          #,000.000: 1,054.322
//          0.###E-000: 1.054E003
//          000,000,000,000.00###: 000,000,001,054.322
//       
//       Formatting of -195489100.8377:
//              C: ($195,489,100.84)
//              E: -1.954891E+008
//              e: -1.954891e+008
//              F: -195489100.84
//              G: -195489100.8377
//              N: -195,489,100.84
//              P: -19,548,910,083.77 %
//              R: -195489100.8377
//          #,000.000: -195,489,100.838
//          0.###E-000: -1.955E008
//          000,000,000,000.00###: -000,195,489,100.00
//       
//       Formatting of 1.0437E+21:
//              C: $1,043,700,000,000,000,000,000.00
//              E: 1.043700E+021
//              e: 1.043700e+021
//              F: 1043700000000000000000.00
//              G: 1.0437E+21
//              N: 1,043,700,000,000,000,000,000.00
//              P: 104,370,000,000,000,000,000,000.00 %
//              R: 1.0437E+21
//          #,000.000: 1,043,700,000,000,000,000,000.000
//          0.###E-000: 1.044E021
//          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
//       
//       Formatting of -1.0573E-05:
//              C: $0.00
//              E: -1.057300E-005
//              e: -1.057300e-005
//              F: 0.00
//              G: -1.0573E-05
//              N: 0.00
//              P: 0.00 %
//              R: -1.0573E-05
//          #,000.000: 000.000
//          0.###E-000: -1.057E-005
//          000,000,000,000.00###: -000,000,000,000.00001
let numbers = 
    [| 1054.32179F; -195489100.8377F; 1.0437E21F; -1.0573e-05F |]
let specifiers = 
    [| "C"; "E"; "e"; "F"; "G"; "N"; "P" 
       "R"; "#,000.000"; "0.###E-000"
       "000,000,000,000.00###" |]

for number in numbers do
    printfn $"Formatting of {number}:"
    for specifier in specifiers do
        printfn $"   {specifier,5}: {number.ToString specifier}" 
    printfn ""
// The example displays the following output to the console:
//       Formatting of 1054.32179:
//              C: $1,054.32
//              E: 1.054322E+003
//              e: 1.054322e+003
//              F: 1054.32
//              G: 1054.32179
//              N: 1,054.32
//              P: 105,432.18 %
//              R: 1054.32179
//          #,000.000: 1,054.322
//          0.###E-000: 1.054E003
//          000,000,000,000.00###: 000,000,001,054.322
//       
//       Formatting of -195489100.8377:
//              C: ($195,489,100.84)
//              E: -1.954891E+008
//              e: -1.954891e+008
//              F: -195489100.84
//              G: -195489100.8377
//              N: -195,489,100.84
//              P: -19,548,910,083.77 %
//              R: -195489100.8377
//          #,000.000: -195,489,100.838
//          0.###E-000: -1.955E008
//          000,000,000,000.00###: -000,195,489,100.00
//       
//       Formatting of 1.0437E+21:
//              C: $1,043,700,000,000,000,000,000.00
//              E: 1.043700E+021
//              e: 1.043700e+021
//              F: 1043700000000000000000.00
//              G: 1.0437E+21
//              N: 1,043,700,000,000,000,000,000.00
//              P: 104,370,000,000,000,000,000,000.00 %
//              R: 1.0437E+21
//          #,000.000: 1,043,700,000,000,000,000,000.000
//          0.###E-000: 1.044E021
//          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
//       
//       Formatting of -1.0573E-05:
//              C: $0.00
//              E: -1.057300E-005
//              e: -1.057300e-005
//              F: 0.00
//              G: -1.0573E-05
//              N: 0.00
//              P: 0.00 %
//              R: -1.0573E-05
//          #,000.000: 000.000
//          0.###E-000: -1.057E-005
//          000,000,000,000.00###: -000,000,000,000.00001
Dim numbers() As Single = {1054.32179, -195489100.8377, 1.0437E21, _
                           -1.0573e-05}
Dim specifiers() As String = { "C", "E", "e", "F", "G", "N", "P", _
                               "R", "#,000.000", "0.###E-000", _
                               "000,000,000,000.00###"}
For Each number As Single In numbers
   Console.WriteLine("Formatting of {0}:", number)
   For Each specifier As String In specifiers
      Console.WriteLine("   {0,5}: {1}", _
                        specifier, number.ToString(specifier))
   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'       Formatting of 1054.32179:
'              C: $1,054.32
'              E: 1.054322E+003
'              e: 1.054322e+003
'              F: 1054.32
'              G: 1054.32179
'              N: 1,054.32
'              P: 105,432.18 %
'              R: 1054.32179
'          #,000.000: 1,054.322
'          0.###E-000: 1.054E003
'          000,000,000,000.00###: 000,000,001,054.322      
'       
'       Formatting of -195489100.8377:
'              C: ($195,489,100.84)
'              E: -1.954891E+008
'              e: -1.954891e+008
'              F: -195489100.84
'              G: -195489100.8377
'              N: -195,489,100.84
'              P: -19,548,910,083.77 %
'              R: -195489100.8377
'          #,000.000: -195,489,100.838
'          0.###E-000: -1.955E008
'          000,000,000,000.00###: -000,195,489,100.00
'       
'       Formatting of 1.0437E+21:
'              C: $1,043,700,000,000,000,000,000.00
'              E: 1.043700E+021
'              e: 1.043700e+021
'              F: 1043700000000000000000.00
'              G: 1.0437E+21
'              N: 1,043,700,000,000,000,000,000.00
'              P: 104,370,000,000,000,000,000,000.00 %
'              R: 1.0437E+21
'          #,000.000: 1,043,700,000,000,000,000,000.000
'          0.###E-000: 1.044E021
'          000,000,000,000.00###: 1,043,700,000,000,000,000,000.00
'       
'       Formatting of -1.0573E-05:
'              C: $0.00
'              E: -1.057300E-005
'              e: -1.057300e-005
'              F: 0.00
'              G: -1.0573E-05
'              N: 0.00
'              P: 0.00 %
'              R: -1.0573E-05
'          #,000.000: 000.000
'          0.###E-000: -1.057E-005
'          000,000,000,000.00###: -000,000,000,000.00001

Opmerkingen

Met ToString(String) de methode wordt een Single waarde in een opgegeven indeling opgemaakt met behulp van de conventies van de huidige cultuur. Als u de standaardindeling ('G', of algemeen) wilt gebruiken of een andere cultuur wilt opgeven, gebruikt u de andere overbelastingen van de ToString methode als volgt:

Indeling gebruiken Voor cultuur De overbelasting gebruiken
Standaardnotatie ('G') Standaardcultuur (huidige) ToString()
Standaardnotatie ('G') Een specifieke cultuur ToString(IFormatProvider)
Een specifieke indeling Een specifieke cultuur ToString(String, IFormatProvider)

De retourwaarde kan PositiveInfinitySymbolzijn, NegativeInfinitySymbolof NaNSymbolde tekenreeksweergave van de waarde van het huidige exemplaar, zoals opgegeven door format.

De format parameter kan elke geldige standaardnotatieaanduiding voor numerieke notatie zijn, met uitzondering van D en X, evenals elke combinatie van aangepaste numerieke notatieaanduidingen. Als notatie of een lege tekenreeks is null , wordt de retourwaarde opgemaakt met de algemene numerieke notatieaanduiding ('G').

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

Standaard bevat de retourwaarde slechts 7 cijfers van precisie, hoewel een maximum van 9 cijfers intern wordt bijgehouden. Als de waarde van dit exemplaar groter is dan 7 cijfers, ToString(String) retourneert PositiveInfinitySymbol of NegativeInfinitySymbol in plaats van het verwachte getal. Als u meer precisie nodig hebt, geeft format u op met de notatiespecificatie 'G9', die altijd 9 cijfers van precisie retourneert of R, die 7 cijfers retourneert als het getal kan worden weergegeven met die precisie of 9 cijfers als het getal alleen met maximale precisie kan worden weergegeven.

Zie ook

Van toepassing op

ToString(String, IFormatProvider)

Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs
Bron:
Single.cs

Converteert de numerieke waarde van dit exemplaar naar de equivalente tekenreeksweergave met behulp van de opgegeven indeling en cultuurspecifieke notatiegegevens.

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

Parameters

format
String

Een tekenreeks met een numerieke notatie.

provider
IFormatProvider

Een object dat cultuurspecifieke opmaakinformatie levert.

Retouren

De tekenreeksweergave van de waarde van dit exemplaar zoals opgegeven door format en provider.

Implementeringen

Voorbeelden

In het volgende voorbeeld wordt een Single waarde weergegeven met behulp van elk van de ondersteunde standaardnotatieaanduidingen voor numerieke notaties voor verschillende culturen.

float value = 16325.62901F;
string specifier;
CultureInfo culture;

// Use standard numeric format specifiers.
specifier = "G";
culture = CultureInfo.CreateSpecificCulture("eu-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62901
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture));
// Displays:    16325.62901

specifier = "C";
culture = CultureInfo.CreateSpecificCulture("en-US");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    $16,325.63
culture = CultureInfo.CreateSpecificCulture("en-GB");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    £16,325.63

specifier = "E04";
culture = CultureInfo.CreateSpecificCulture("sv-SE");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ");
 Console.WriteLine(value.ToString(specifier, culture));
// Displays:    1.6326E+004   

specifier = "F";
culture = CultureInfo.CreateSpecificCulture("fr-FR");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,63
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.63

specifier = "N";
culture = CultureInfo.CreateSpecificCulture("es-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16.325,63
culture = CultureInfo.CreateSpecificCulture("fr-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16 325,63

specifier = "P";
culture = CultureInfo.InvariantCulture;
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG");
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.256 %
let value = 16325.62901F

// Use standard numeric format specifiers.
let specifier = "G"
let culture = CultureInfo.CreateSpecificCulture "eu-ES"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16325,62901
printfn $"{value.ToString(specifier, CultureInfo.InvariantCulture)}"
// Displays:    16325.62901

let specifier = "C"
let culture = CultureInfo.CreateSpecificCulture "en-US"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    $16,325.63
let culture = CultureInfo.CreateSpecificCulture "en-GB"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    £16,325.63

let specifier = "E04"
let culture = CultureInfo.CreateSpecificCulture "sv-SE"
printfn $"{value.ToString(specifier, culture)}"
// Displays: 1,6326E+004   
let culture = CultureInfo.CreateSpecificCulture "en-NZ"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    1.6326E+004   

let specifier = "F"
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16325,63
let culture = CultureInfo.CreateSpecificCulture "en-CA"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16325.63

let specifier = "N"
let culture = CultureInfo.CreateSpecificCulture "es-ES"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16.325,63
let culture = CultureInfo.CreateSpecificCulture "fr-CA"
printfn $"{value.ToString(specifier, culture)}"
// Displays:    16 325,63

let specifier = "P"
let culture = CultureInfo.InvariantCulture
printfn $"{(value / 10000f).ToString(specifier, culture)}"
// Displays:    163.26 %
let culture = CultureInfo.CreateSpecificCulture "ar-EG"
printfn $"{(value / 10000f).ToString(specifier, culture)}"
// Displays:    163.256 %
Dim value As Single = 16325.62901
Dim specifier As String
Dim culture As CultureInfo

' Use standard numeric format specifiers.
specifier = "G"
culture = CultureInfo.CreateSpecificCulture("eu-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62901
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays:    16325.62901

specifier = "C"
culture = CultureInfo.CreateSpecificCulture("en-US")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    $16,325.63
culture = CultureInfo.CreateSpecificCulture("en-GB")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    £16,325.63

specifier = "E04"
culture = CultureInfo.CreateSpecificCulture("sv-SE")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ")
 Console.WriteLine(value.ToString(specifier, culture))
' Displays:    1.6326E+004   

specifier = "F"
culture = CultureInfo.CreateSpecificCulture("fr-FR")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,63
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325.63

specifier = "N"
culture = CultureInfo.CreateSpecificCulture("es-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16.325,63
culture = CultureInfo.CreateSpecificCulture("fr-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16 325,63

specifier = "P"
culture = CultureInfo.InvariantCulture
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG")
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.256 %

Opmerkingen

Met ToString(String, IFormatProvider) de methode wordt een Single waarde opgemaakt in een opgegeven notatie van een opgegeven cultuur. Als u standaardindeling of cultuurinstellingen wilt gebruiken, gebruikt u de andere overbelasting van de ToString methode als volgt:

Indeling gebruiken Voor cultuur De overbelasting gebruiken
Standaardnotatie ('G') Standaardcultuur (huidige) ToString()
Standaardnotatie ('G') Een specifieke cultuur ToString(IFormatProvider)
Een specifieke indeling Standaardcultuur (huidige) ToString(String)

De retourwaarde kan PositiveInfinitySymbolzijn, NegativeInfinitySymbolof NaNSymbolde tekenreeksweergave van de waarde van het huidige exemplaar, zoals opgegeven door format.

De format parameter kan elke geldige standaardnotatieaanduiding voor numerieke notatie zijn, met uitzondering van D en X, evenals elke combinatie van aangepaste numerieke notatieaanduidingen. Als format dit een of een lege tekenreeks is null , wordt de retourwaarde voor dit exemplaar opgemaakt met de algemene numerieke notatieaanduiding ('G').

.NET biedt uitgebreide ondersteuning voor opmaak, die uitgebreider wordt beschreven in de volgende opmaakonderwerpen:

De provider parameter is een IFormatProvider implementatie waarvan de GetFormat methode een NumberFormatInfo object retourneert. provider Dit is meestal een CultureInfo object of een NumberFormatInfo object. De provider parameter levert cultuurspecifieke informatie die wordt gebruikt in opmaak. Als provider dat het is null, wordt de retourwaarde opgemaakt met het NumberFormatInfo object voor de huidige cultuur.

Standaard bevat de retourwaarde slechts 7 cijfers van precisie, hoewel een maximum van 9 cijfers intern wordt bijgehouden. Als de waarde van dit exemplaar groter is dan 7 cijfers, ToString retourneert PositiveInfinitySymbol of NegativeInfinitySymbol in plaats van het verwachte getal. Als u meer precisie nodig hebt, geeft format u op met de notatiespecificatie 'G9', die altijd 9 cijfers van precisie retourneert of R, die 7 cijfers retourneert als het getal kan worden weergegeven met die precisie of 9 cijfers als het getal alleen met maximale precisie kan worden weergegeven.

Zie ook

Van toepassing op