NumberFormatInfo.PercentGroupSizes NumberFormatInfo.PercentGroupSizes NumberFormatInfo.PercentGroupSizes NumberFormatInfo.PercentGroupSizes Property

정의

백분율 값에서 정수 부분의 각 그룹 자릿수를 가져오거나 설정합니다.Gets or sets the number of digits in each group to the left of the decimal in percent values.

public:
 property cli::array <int> ^ PercentGroupSizes { cli::array <int> ^ get(); void set(cli::array <int> ^ value); };
public int[] PercentGroupSizes { get; set; }
member this.PercentGroupSizes : int[] with get, set
Public Property PercentGroupSizes As Integer()

속성 값

Int32[]

백분율 값에서 정수 부분의 각 그룹 자릿수입니다.The number of digits in each group to the left of the decimal in percent values. InvariantInfo의 기본값은 3으로 설정된 하나의 요소만 있는 1차원 배열입니다.The default for InvariantInfo is a one-dimensional array with only one element, which is set to 3.

예외

속성이 null로 설정되어 있습니다.The property is being set to null.

속성이 설정되거나 배열에 0보다 작거나 9보다 큰 항목이 포함되어 있습니다.The property is being set and the array contains an entry that is less than 0 or greater than 9.

또는-or-

속성이 설정되거나 배열의 마지막 항목 이외의 항목이 0으로 설정되어 있습니다.The property is being set and the array contains an entry, other than the last entry, that is set to 0.

속성이 설정되어 있으며 NumberFormatInfo 개체가 읽기 전용입니다.The property is being set and the NumberFormatInfo object is read-only.

예제

다음 예제에서는 변경의 효과 보여 줍니다.는 PercentGroupSizes 속성입니다.The following example demonstrates the effect of changing the PercentGroupSizes property.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Gets a NumberFormatInfo associated with the en-US culture.
   CultureInfo^ MyCI = gcnew CultureInfo( "en-US",false );
   NumberFormatInfo^ nfi = MyCI->NumberFormat;
   
   // Displays a value with the default separator (S".").
   Double myInt = 123456789012345.6789;
   Console::WriteLine( myInt.ToString( "P", nfi ) );
   
   // Displays the same value with different groupings.
   array<Int32>^mySizes1 = {2,3,4};
   array<Int32>^mySizes2 = {2,3,0};
   nfi->PercentGroupSizes = mySizes1;
   Console::WriteLine( myInt.ToString( "P", nfi ) );
   nfi->PercentGroupSizes = mySizes2;
   Console::WriteLine( myInt.ToString( "P", nfi ) );
}

/*
This code produces the following output.

12, 345, 678, 901, 234, 600.00 %
1234, 5678, 9012, 346, 00.00 %
123456789012, 346, 00.00 %
*/
using System;
using System.Globalization;

class NumberFormatInfoSample {

   public static void Main() {

      // Gets a NumberFormatInfo associated with the en-US culture.
      NumberFormatInfo nfi = new CultureInfo( "en-US", false ).NumberFormat;

      // Displays a value with the default separator (".").
      Double myInt = 123456789012345.6789;
      Console.WriteLine( myInt.ToString( "P", nfi ) );

      // Displays the same value with different groupings.
      int[] mySizes1 = {2,3,4};
      int[] mySizes2 = {2,3,0};
      nfi.PercentGroupSizes = mySizes1;
      Console.WriteLine( myInt.ToString( "P", nfi ) );
      nfi.PercentGroupSizes = mySizes2;
      Console.WriteLine( myInt.ToString( "P", nfi ) );

   }
}


/* 
This code produces the following output.

12,345,678,901,234,600.00 %
1234,5678,9012,346,00.00 %
123456789012,346,00.00 %
*/
   
Imports System.Globalization

Class NumberFormatInfoSample

   Public Shared Sub Main()

      ' Gets a NumberFormatInfo associated with the en-US culture.
      Dim nfi As NumberFormatInfo = New CultureInfo("en-US", False).NumberFormat

      ' Displays a value with the default separator (".").
      Dim myInt As [Double] = 123456789012345.6789
      Console.WriteLine(myInt.ToString("P", nfi))

      ' Displays the same value with different groupings.
      Dim mySizes1 As Integer() =  {2, 3, 4}
      Dim mySizes2 As Integer() =  {2, 3, 0}
      nfi.PercentGroupSizes = mySizes1
      Console.WriteLine(myInt.ToString("P", nfi))
      nfi.PercentGroupSizes = mySizes2
      Console.WriteLine(myInt.ToString("P", nfi))

   End Sub

End Class


'This code produces the following output.

'

'12,345,678,901,234,600.00 %

'1234,5678,9012,346,00.00 %

'123456789012,346,00.00 %


설명

PercentGroupSizes 속성은 정수 계열 그룹에 나타나는 자릿수를 정의 하려면 "P" 표준 서식 문자열을 함께 사용 합니다.The PercentGroupSizes property is used with the "P" standard format string to define the number of digits that appear in integral groups. 자세한 내용은 표준 숫자 형식 문자열을 참조하세요.For more information, see Standard Numeric Format Strings. 1 차원 배열의 모든 요소에는 1에서 9 사이의 정수 여야 합니다.Every element in the one-dimensional array must be an integer from 1 through 9. 마지막 요소에는 0 일 수 있습니다.The last element can be 0.

자릿수의 왼쪽에 바로 가장 중요 하지 않은 그룹의 요소 수를 정의 하는 배열의 첫 번째 요소는 PercentDecimalSeparator합니다.The first element of the array defines the number of elements in the least significant group of digits immediately to the left of the PercentDecimalSeparator. 각 후속 요소에서 이전 그룹의 왼쪽으로 자릿수 다음 중요 한 그룹을 가리킵니다.Each subsequent element refers to the next significant group of digits to the left of the previous group. 배열의 마지막 요소 다음 위치에 있는 경우 0이 아닌 나머지 숫자는 기준으로 그룹화 배열의 마지막 요소입니다.If the last element of the array is not 0, the remaining digits are grouped based on the last element of the array. 마지막 요소의 0 인 경우에 나머지 자릿수 그룹화 되지 않습니다.If the last element is 0, the remaining digits are not grouped.

예를 들어, 배열 {3, 4, 5}를 포함 하는 경우 숫자 묶여 비슷합니다 "55,55555,55555,55555,4444,333.00%"입니다.For example, if the array contains { 3, 4, 5 }, the digits are grouped similar to "55,55555,55555,55555,4444,333.00%". 숫자 배열 {3, 4, 0}를 포함 하는 경우 비슷합니다 그룹화 됩니다 "55555555555555555,4444,333.00%"입니다.If the array contains { 3, 4, 0 }, the digits are grouped similar to "55555555555555555,4444,333.00%".

적용 대상

추가 정보