PermilleFormatter Kelas

Definisi

Ruang nama:

Windows.Globalization.NumberFormatting

Memformat dan mengurai permillages.

public ref class PermilleFormatter sealed : INumberFormatter, INumberFormatter2, INumberFormatterOptions, INumberParser, INumberRounderOption, ISignedZeroOption, ISignificantDigitsOption

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Globalization.NumberFormatting.IPermilleFormatterFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class PermilleFormatter final : INumberFormatter, INumberFormatter2, INumberFormatterOptions, INumberParser, INumberRounderOption, ISignedZeroOption, ISignificantDigitsOption

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Globalization.NumberFormatting.IPermilleFormatterFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class PermilleFormatter : INumberFormatter, INumberFormatter2, INumberFormatterOptions, INumberParser, INumberRounderOption, ISignedZeroOption, ISignificantDigitsOption

function PermilleFormatter(languages, geographicRegion)

Public NotInheritable Class PermilleFormatter
Implements INumberFormatter, INumberFormatter2, INumberFormatterOptions, INumberParser, INumberRounderOption, ISignedZeroOption, ISignificantDigitsOption

Warisan

Object Platform::Object IInspectable PermilleFormatter

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

INumberFormatter INumberFormatter2 INumberFormatterOptions INumberParser INumberRounderOption ISignedZeroOption ISignificantDigitsOption

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

// This scenario uses the Windows.Globalization.NumberFormatting.PercentFormatter and
// the Windows.Globalization.NumberFormatting.PermilleFormatter classes to format numbers
// as a percent or a permille.

//using System.Text;
//using Windows.Globalization.NumberFormatting;

StringBuilder sb = new StringBuilder();

// Create numbers to format.
double randomNumber = new Random().NextDouble();
ulong fixedNumber = 500;

// Create percent formatters.
PercentFormatter defaultPercentFormatter = new PercentFormatter();
PercentFormatter languagePercentFormatter = new PercentFormatter(new[] { "fr-FR" }, "ZZ");

// Create permille formatters.
PermilleFormatter defaultPermilleFormatter = new PermilleFormatter();
PermilleFormatter languagePermilleFormatter = new PermilleFormatter(new[] { "ar" }, "ZZ");

// Format random numbers as percent or permille.
sb.AppendLine("Random number: " + randomNumber);
sb.AppendLine("Percent formatted: " + defaultPercentFormatter.Format(randomNumber));
sb.AppendLine("Permille formatted: " + defaultPermilleFormatter.Format(randomNumber));
sb.AppendLine();
sb.AppendLine("Language-specific percent formatted: " + languagePercentFormatter.Format(randomNumber));
sb.AppendLine("Language-specific permille formatted: " + languagePermilleFormatter.Format(randomNumber));
sb.AppendLine();
sb.AppendLine("Fixed number: " + fixedNumber);

// Format fixed number with grouping.
defaultPercentFormatter.IsGrouped = true;
sb.AppendLine("Percent formatted (grouped): " + defaultPercentFormatter.Format(fixedNumber));

//Format with grouping using French language.
languagePercentFormatter.IsGrouped = true;
sb.AppendLine("Percent formatted (grouped as fr-FR): " + defaultPercentFormatter.Format(fixedNumber));

// Format with no fraction digits.
defaultPercentFormatter.FractionDigits = 0;
sb.AppendLine("Percent formatted (no fractional digits): " + defaultPercentFormatter.Format(fixedNumber));

// Format always with a decimal point.
defaultPercentFormatter.IsDecimalPointAlwaysDisplayed = true;
sb.AppendLine("Percent formatted (always with a decimal point): " + defaultPercentFormatter.Format(fixedNumber));

Keterangan

Catatan

Jika aplikasi Anda meneruskan tag bahasa yang digunakan di kelas ini ke fungsi Dukungan Bahasa Nasional apa pun, aplikasi harus terlebih dahulu mengonversi tag dengan memanggil ResolveLocaleName.

Konstruktor

PermilleFormatter()	Membuat objek PermilleFormatter dan menginisialisasinya ke nilai default.
PermilleFormatter(IIterable<String>, String)	Membuat objek PermilleFormatter yang diinisialisasi oleh daftar bahasa dan wilayah geografis.

Properti

FractionDigits	Mendapatkan atau mengatur jumlah minimum digit yang akan ditampilkan untuk bagian pecahan permillage.
GeographicRegion	Mendapatkan wilayah yang digunakan saat memformat dan mengurai nilai permille.
IntegerDigits	Mendapatkan atau mengatur jumlah minimum digit yang akan ditampilkan untuk bagian bilangan bulat dari permillage.
IsDecimalPointAlwaysDisplayed	Mendapatkan atau mengatur apakah titik desimal permillage harus selalu ditampilkan.
IsGrouped	Mendapatkan atau mengatur apakah bagian bilangan bulat dari permillage harus dikelompokkan.
IsZeroSigned	Mendapatkan atau mengatur apakah -0 diformat sebagai "-0" atau "0".
Languages	Mendapatkan daftar prioritas pengidentifikasi bahasa yang digunakan saat memformat dan mengurai nilai permille.
NumberRounder	Mendapatkan atau mengatur strategi pembulatan saat ini yang akan digunakan saat memformat permilles.
NumeralSystem	Mendapatkan atau mengatur sistem penomoran yang digunakan untuk memformat dan mengurai nilai permille.
ResolvedGeographicRegion	Mendapatkan wilayah geografis yang terakhir digunakan untuk memformat atau mengurai nilai permille.
ResolvedLanguage	Mendapatkan bahasa yang baru-baru ini digunakan untuk memformat atau mengurai nilai permille.
SignificantDigits	Mendapatkan atau mengatur padding saat ini ke digit signifikan saat permille diformat.

Metode

Format(Double)	Mengembalikan representasi string dari permillage Double .
Format(Int64)	Mengembalikan representasi string dari permillage Int64 .
Format(UInt64)	Mengembalikan representasi string dari permillage UInt64 .
FormatDouble(Double)	Mengembalikan representasi string dari permillage Double .
FormatInt(Int64)	Mengembalikan representasi string dari permillage Int64 .
FormatUInt(UInt64)	Mengembalikan representasi string dari permillage UInt64 .
ParseDouble(String)	Mencoba mengurai representasi string dari permillage Double .
ParseInt(String)	Mencoba mengurai representasi string dari permillage bilangan bulat.
ParseUInt(String)	Mencoba mengurai representasi string dari permillage bilangan bulat yang tidak ditandatangani.

Lihat juga

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• Sampel pemformatan dan penguraian angka
• Sampel pemformatan dan penguraian angka (Windows 10)