NumberFormatInfo.PercentGroupSizes Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает количество цифр в каждой из групп разрядов целой части десятичной дроби в значениях процентов.
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, setPublic Property PercentGroupSizes As Integer()Значение свойства
Число цифр в каждой из групп целой части десятичной дроби в значениях процентов. Для свойства InvariantInfo по умолчанию используется одномерный массив с единственным элементом, для которого задано значение 3.
Исключения
Для свойства задается значение null.
Для свойства задается значение, и массив содержит запись, которая меньше 0 или больше 9.
-или-
Для свойства задается значение, и массив содержит запись, отличную от последней записи, которая имеет значение 0.
Для свойства задается значение, а объект NumberFormatInfo доступен только для чтения.
Примеры
В следующем примере показан эффект изменения PercentGroupSizes свойства .
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", чтобы определить количество цифр, отображаемых в целочисленных группах. Дополнительные сведения см. в статье Строки стандартных числовых форматов. Каждый элемент в одномерном массиве должен быть целым числом от 1 до 9. Последний элемент может иметь значение 0.
Первый элемент массива определяет количество элементов в наименее значимой группе цифр слева от PercentDecimalSeparator. Каждый последующий элемент относится к следующей значительной группе цифр слева от предыдущей группы. Если последний элемент массива не равен 0, остальные цифры группируются по последнему элементу массива. Если последний элемент равен 0, остальные цифры не группируются.
Например, если массив содержит { 3, 4, 5 }, цифры группируются примерно так: "55,555555,55555,555555,4444,333,00%". Если массив содержит { 3, 4, 0 }, цифры группируются примерно так: "5555555555555555555544 333,00%".
