PermilleFormatter 클래스

정의

네임스페이스:

Windows.Globalization.NumberFormatting

permillage 형식 및 구문 분석

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

상속

Object Platform::Object IInspectable PermilleFormatter

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

INumberFormatter INumberFormatter2 INumberFormatterOptions INumberParser INumberRounderOption ISignedZeroOption ISignificantDigitsOption

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

// 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));

설명

참고

앱이 이 클래스에 사용된 언어 태그를 모든 국가 언어 지원 함수에 전달하는 경우 먼저 ResolveLocaleName을 호출하여 태그를 변환해야 합니다.

생성자

PermilleFormatter()	PermilleFormatter 개체를 만들고 기본값으로 초기화합니다.
PermilleFormatter(IIterable<String>, String)	언어 목록 및 지리적 지역에 의해 초기화된 PermilleFormatter 개체를 만듭니다.

속성

FractionDigits	permillage의 소수 부분에 대해 표시할 최소 자릿수를 가져오거나 설정합니다.
GeographicRegion	permille 값의 서식을 지정하고 구문 분석할 때 사용되는 지역을 가져옵니다.
IntegerDigits	permillage의 정수 부분에 대해 표시할 최소 자릿수를 가져오거나 설정합니다.
IsDecimalPointAlwaysDisplayed	permillage의 소수점이 항상 표시되어야 하는지 여부를 가져오거나 설정합니다.
IsGrouped	permillage의 정수 부분을 그룹화할지 여부를 가져오거나 설정합니다.
IsZeroSigned	-0의 서식을 "-0" 또는 "0"으로 지정할지 여부를 가져오거나 설정합니다.
Languages	permille 값의 서식을 지정하고 구문 분석할 때 사용되는 언어 식별자의 우선 순위 목록을 가져옵니다.
NumberRounder	permilles 서식을 지정할 때 사용할 현재 반올림 전략을 가져오거나 설정합니다.
NumeralSystem	permille 값의 서식을 지정하고 구문 분석하는 데 사용되는 번호 매기기 시스템을 가져오거나 설정합니다.
ResolvedGeographicRegion	permille 값의 형식을 지정하거나 구문 분석하는 데 가장 최근에 사용된 지리적 지역을 가져옵니다.
ResolvedLanguage	permille 값의 형식을 지정하거나 구문 분석하는 데 가장 최근에 사용된 언어를 가져옵니다.
SignificantDigits	permille의 서식을 지정할 때 현재 안쪽 여백을 유효 자릿수로 가져오거나 설정합니다.

메서드

Format(Double)	Double permillage의 문자열 표현을 반환합니다.
Format(Int64)	Int64 permillage의 문자열 표현을 반환합니다.
Format(UInt64)	UInt64 permillage의 문자열 표현을 반환합니다.
FormatDouble(Double)	Double permillage의 문자열 표현을 반환합니다.
FormatInt(Int64)	Int64 permillage의 문자열 표현을 반환합니다.
FormatUInt(UInt64)	UInt64 permillage의 문자열 표현을 반환합니다.
ParseDouble(String)	Double permillage의 문자열 표현을 구문 분석하려고 시도합니다.
ParseInt(String)	정수 permillage의 문자열 표현을 구문 분석하려고 시도합니다.
ParseUInt(String)	부호 없는 정수 permillage의 문자열 표현을 구문 분석하려고 시도합니다.

추가 정보

• INumberFormatterOptions
• INumberFormatter
• INumberFormatter2
• INumberParser
• ISignificantDigitsOption
• INumberRounderOption
• 숫자 형식 지정 및 구문 분석 샘플
• 숫자 서식 지정 및 구문 분석 샘플(Windows 10)