NumberFormatInfo.NativeDigits Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets a string array of native digits equivalent to the Western digits 0 through 9.

Namespace:   System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

<ComVisibleAttribute(False)>
Public Property NativeDigits As String()

Property Value

Type: System.String()

A string array that contains the native equivalent of the Western digits 0 through 9. The default is an array having the elements "0", "1", "2", "3", "4", "5", "6", "7", "8", and "9".

Exception Condition
InvalidOperationException

The current NumberFormatInfo object is read-only.

ArgumentNullException

In a set operation, the value is null.

-or-

In a set operation, an element of the value array is null.

ArgumentException

In a set operation, the value array does not contain 10 elements.

-or-

In a set operation, an element of the value array does not contain either a single Char object or a pair of Char objects that comprise a surrogate pair.

-or-

In a set operation, an element of the value array is not a number digit as defined by the Unicode Standard. That is, the digit in the array element does not have the Unicode Number, Decimal Digit (Nd) General Category value.

-or-

In a set operation, the numeric value of an element in the value array does not correspond to the element's position in the array. That is, the element at index 0, which is the first element of the array, does not have a numeric value of 0, or the element at index 1 does not have a numeric value of 1.

System_CAPS_importantImportant

The character set that is specified by the NativeDigits property has no effect on parsing or formatting operations. Only the Basic Latin digits 0 (U+0030) through 9 (U+0039) are used when formatting or parsing numeric values or date and time values.

The following example demonstrates the NativeDigits property.

' This example demonstrates the NativeDigits property.

Imports System
Imports System.Globalization
Imports System.Threading

Class Sample
    Public Shared Sub Main() 
        Dim currentCI As CultureInfo = Thread.CurrentThread.CurrentCulture
        Dim nfi As NumberFormatInfo = currentCI.NumberFormat
        Dim nativeDigitList As String() = nfi.NativeDigits

        Console.WriteLine("The native digits for the {0} culture are:", currentCI.Name)
        Dim s As String
        For Each s In  nativeDigitList
            Console.Write("""{0}"" ", s)
        Next s
        Console.WriteLine()

    End Sub 'Main
End Class 'Sample

'This code example produces the following results:
'
'The native digits for the en-US culture are:
'"0" "1" "2" "3" "4" "5" "6" "7" "8" "9"
'

.NET Framework
Available since 2.0
Return to top
Show: