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 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 }, цифры группируются примерно так же, как "5555555 55555,55555,4444,333,00%". Если массив содержит { 3, 4, 0 }, цифры группируются примерно так же, как "555555555555555555555,4444,333,00%".
