Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

Double.ToString — formátování čísla s explicitním poskytovatelem

Double.ToString(string, IFormatProvider) převádí hodnotu double na text a umožňuje samostatně zvolit číselný formát a kulturní pravidla. Pokud metoda GetFormat poskytovatele při požadavku na NumberFormatInfo vrátí null, použijí se při formátování pravidla aktuální kultury.

Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

public string ToString(string? format, IFormatProvider? provider);

Double.ToString(string, IFormatProvider) vrací textovou reprezentaci hodnoty double. Parametr format vybírá zápis, zatímco provider poskytuje kulturní pravidla, obvykle prostřednictvím CultureInfo nebo NumberFormatInfo.

ToString() používá "G" a aktuální kulturu. ToString(string) mění pouze formát, zatímco ToString(IFormatProvider) mění pouze poskytovatele pravidel formátování. U přetížení se dvěma argumenty znamená null nebo prázdný format hodnotu "G"; null v parametru provider znamená aktuální kulturu.

"F2" vytvoří dvě číslice za desetinným oddělovačem, zatímco "N2" navíc seskupuje číslice. Formátování může zaokrouhlit výsledný text, ale uloženou hodnotu nemění. V .NET 10 vyvolá nepodporovaný specifikátor číselného formátu, například "D", u konečných hodnot typu double výjimku FormatException. Pro NaN a kladné i záporné nekonečno vrátí metoda příslušný symbol podle použité kultury dříve, než ověří specifikátor, takže "D" u těchto hodnot výjimku nevyvolá.

Příklad používá CultureInfo.InvariantCulture a kopii jejích formátovacích pravidel se změněným desetinným oddělovačem. Ukazuje tak rozdíl mezi 1234.50 a 1234,50 bez závislosti na místním nastavení počítače.

Příklady

using System;
using System.Globalization;

double value = 1234.5;
var commaFormat = (NumberFormatInfo)CultureInfo.InvariantCulture.NumberFormat.Clone();
commaFormat.NumberDecimalSeparator = ",";

Console.WriteLine(value.ToString("F2", CultureInfo.InvariantCulture));
Console.WriteLine(value.ToString("F2", commaFormat));

Výsledek

1234.50
1234,50

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje