NumberFormatInfo NumberFormatInfo NumberFormatInfo NumberFormatInfo Class

Definizione

Fornisce informazioni specifiche delle impostazioni cultura per la formattazione e l'analisi dei valori numerici.Provides culture-specific information for formatting and parsing numeric values.

public ref class NumberFormatInfo sealed : ICloneable, IFormatProvider
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class NumberFormatInfo : ICloneable, IFormatProvider
type NumberFormatInfo = class
    interface ICloneable
    interface IFormatProvider
Public NotInheritable Class NumberFormatInfo
Implements ICloneable, IFormatProvider
Ereditarietà
NumberFormatInfoNumberFormatInfoNumberFormatInfoNumberFormatInfo
Attributi
Implementazioni

Esempi

Nell'esempio seguente viene illustrato come recuperare un NumberFormatInfo oggetto per un oggetto corrispondente CultureInfo oggetti e usare l'oggetto recuperato a numero di query informazioni sulla formattazione per determinate impostazioni cultura.The following example shows how to retrieve a NumberFormatInfo object for a corresponding CultureInfo object, and use the retrieved object to query number formatting information for the particular culture.

using namespace System;
using namespace System::Globalization;
using namespace System::Text;

int main()
{
    StringBuilder^ builder = gcnew StringBuilder();

    // Loop through all the specific cultures known to the CLR.
    for each(CultureInfo^ culture in 
        CultureInfo::GetCultures (CultureTypes::SpecificCultures)) 
    {
        // Only show the currency symbols for cultures 
        // that speak English.
        if (culture->TwoLetterISOLanguageName == "en")
        {
            // Display the culture name and currency symbol.
            NumberFormatInfo^ numberFormat = culture->NumberFormat;
            builder->AppendFormat("The currency symbol for '{0}'"+
                "is '{1}'",culture->DisplayName,
                numberFormat->CurrencySymbol);
            builder->AppendLine();
        }
    }
    Console::WriteLine(builder);
}

// This code produces the following output.
//
// The currency symbol for 'English (United States)' is '$'
// The currency symbol for 'English (United Kingdom)' is 'Ј'
// The currency symbol for 'English (Australia)' is '$'
// The currency symbol for 'English (Canada)' is '$'
// The currency symbol for 'English (New Zealand)' is '$'
// The currency symbol for 'English (Ireland)' is '?'
// The currency symbol for 'English (South Africa)' is 'R'
// The currency symbol for 'English (Jamaica)' is 'J$'
// The currency symbol for 'English (Caribbean)' is '$'
// The currency symbol for 'English (Belize)' is 'BZ$'
// The currency symbol for 'English (Trinidad and Tobago)' is 'TT$'
// The currency symbol for 'English (Zimbabwe)' is 'Z$'
// The currency symbol for 'English (Republic of the Philippines)' is 'Php'
using System;
using System.Globalization;
using System.Text;

public sealed class App 
{
    static void Main() 
    {
        StringBuilder sb = new StringBuilder();

        // Loop through all the specific cultures known to the CLR.
        foreach (CultureInfo ci in CultureInfo.GetCultures(CultureTypes.SpecificCultures)) 
        {
            // Only show the currency symbols for cultures that speak English.
            if (ci.TwoLetterISOLanguageName != "en") continue;
             
            // Display the culture name and currency symbol.
            NumberFormatInfo nfi = ci.NumberFormat;
            sb.AppendFormat("The currency symbol for '{0}' is '{1}'",
                ci.DisplayName, nfi.CurrencySymbol);
            sb.AppendLine();
        }
        Console.WriteLine(sb.ToString());
    }
}

// This code produces the following output.
//
// The currency symbol for 'English (United States)' is '$'
// The currency symbol for 'English (United Kingdom)' is '£'
// The currency symbol for 'English (Australia)' is '$'
// The currency symbol for 'English (Canada)' is '$'
// The currency symbol for 'English (New Zealand)' is '$'
// The currency symbol for 'English (Ireland)' is '?'
// The currency symbol for 'English (South Africa)' is 'R'
// The currency symbol for 'English (Jamaica)' is 'J$'
// The currency symbol for 'English (Caribbean)' is '$'
// The currency symbol for 'English (Belize)' is 'BZ$'
// The currency symbol for 'English (Trinidad and Tobago)' is 'TT$'
// The currency symbol for 'English (Zimbabwe)' is 'Z$'
// The currency symbol for 'English (Republic of the Philippines)' is 'Php'
Imports System.Globalization
Imports System.Text

Public Module Example
   Public Sub Main() 
      Dim sb As New StringBuilder()

      ' Loop through all the specific cultures known to the CLR.
      For Each ci In CultureInfo.GetCultures(CultureTypes.SpecificCultures) 
         ' Only show the currency symbols for cultures that speak English.
         If ci.TwoLetterISOLanguageName <> "en" Then Continue For

         ' Display the culture name and currency symbol.
         Dim nfi As NumberFormatInfo = ci.NumberFormat
         sb.AppendFormat("The currency symbol for '{0}' is '{1}'",
                         ci.DisplayName, nfi.CurrencySymbol)
         sb.AppendLine()
      Next
      Console.WriteLine(sb.ToString())
   End Sub
End Module
' The example displays output like the following:
'       The currency symbol for 'English (United States)' is '$'
'       The currency symbol for 'English (United Kingdom)' is '£'
'       The currency symbol for 'English (Australia)' is '$'
'       The currency symbol for 'English (Canada)' is '$'
'       The currency symbol for 'English (New Zealand)' is '$'
'       The currency symbol for 'English (Ireland)' is '?'
'       The currency symbol for 'English (South Africa)' is 'R'
'       The currency symbol for 'English (Jamaica)' is 'J$'
'       The currency symbol for 'English (Caribbean)' is '$'
'       The currency symbol for 'English (Belize)' is 'BZ$'
'       The currency symbol for 'English (Trinidad and Tobago)' is 'TT$'
'       The currency symbol for 'English (Zimbabwe)' is 'Z$'
'       The currency symbol for 'English (Republic of the Philippines)' is 'Php'
'       The currency symbol for 'English (India)' is 'Rs.'
'       The currency symbol for 'English (Malaysia)' is 'RM'
'       The currency symbol for 'English (Singapore)' is '$'

Commenti

Il NumberFormatInfo classe contiene informazioni specifiche delle impostazioni cultura utilizzate quando si formatta e analizzare i valori numerici.The NumberFormatInfo class contains culture-specific information that is used when you format and parse numeric values. Queste informazioni includono il simbolo di valuta, il separatore decimale, il simbolo di separatore di gruppi e i simboli segni positivi e negativi.This information includes the currency symbol, the decimal symbol, the group separator symbol, and the symbols for positive and negative signs.

Creare un'istanza di un oggetto NumberFormatInfoInstantiating a NumberFormatInfo object

È possibile creare un'istanza di un NumberFormatInfo oggetto che rappresenta le convenzioni di formattazione delle impostazioni cultura correnti, le impostazioni cultura invarianti, impostazioni cultura specifiche o alcune impostazioni cultura.You can instantiate a NumberFormatInfo object that represents the formatting conventions of the current culture, the invariant culture, a specific culture, or a neutral culture.

Creare un'istanza di un oggetto NumberFormatInfo per le impostazioni cultura correntiInstantiating a NumberFormatInfo object for the current culture

È possibile creare un'istanza di un NumberFormatInfo oggetto per impostazioni cultura del thread corrente in uno dei modi seguenti.You can instantiate a NumberFormatInfo object for the current thread culture in any of the following ways. In ogni caso, l'oggetto restituito NumberFormatInfo oggetto è di sola lettura.In each case, the returned NumberFormatInfo object is read-only.

L'esempio seguente usa i tre modi per creare NumberFormatInfo gli oggetti che rappresentano le convenzioni di formattazione delle impostazioni cultura correnti.The following example uses these three ways to create NumberFormatInfo objects that represent the formatting conventions of the current culture. Consente inoltre di recuperare il valore della IsReadOnly proprietà per illustrare che ogni oggetto è di sola lettura.It also retrieves the value of the IsReadOnly property to illustrate that each object is read-only.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      NumberFormatInfo current1 = CultureInfo.CurrentCulture.NumberFormat;
      Console.WriteLine(current1.IsReadOnly);
      
      NumberFormatInfo current2 = NumberFormatInfo.CurrentInfo;
      Console.WriteLine(current2.IsReadOnly);
      
      NumberFormatInfo current3 = NumberFormatInfo.GetInstance(CultureInfo.CurrentCulture);
      Console.WriteLine(current3.IsReadOnly);
   }
}
// The example displays the following output:
//       True
//       True
//       True
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim current1 As NumberFormatInfo = CultureInfo.CurrentCulture.NumberFormat
      Console.WriteLine(current1.IsReadOnly)
      
      Dim current2 As NumberFormatInfo = NumberFormatInfo.CurrentInfo
      Console.WriteLine(current2.IsReadOnly)
      
      Dim current3 As NumberFormatInfo = NumberFormatInfo.GetInstance(CultureInfo.CurrentCulture)
      Console.WriteLine(current3.IsReadOnly)
   End Sub
End Module
' The example displays the following output:
'       True
'       True
'       True

È possibile creare scrivibile NumberFormatInfo oggetto che rappresenta le convenzioni delle impostazioni cultura del thread corrente in uno dei modi seguenti:You can create a writable NumberFormatInfo object that represents the conventions of the current thread culture in any of the following ways:

Nell'esempio seguente illustra queste due modalità di un'istanza di un NumberFormatInfo dell'oggetto e visualizza il valore della relativa IsReadOnly proprietà per illustrare che l'oggetto non è in sola lettura.The following example illustrates these two ways of instantiating a NumberFormatInfo object, and displays the value of its IsReadOnly property to illustrate that the object is not read-only.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      NumberFormatInfo current1 = NumberFormatInfo.CurrentInfo;
      current1 = (NumberFormatInfo) current1.Clone();
      Console.WriteLine(current1.IsReadOnly);

      CultureInfo culture2 = CultureInfo.CreateSpecificCulture(CultureInfo.CurrentCulture.Name);
      NumberFormatInfo current2 = culture2.NumberFormat;
      Console.WriteLine(current2.IsReadOnly);
   }
}
// The example displays the following output:
//       False
//       False
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim current1 As NumberFormatInfo = NumberFormatInfo.CurrentInfo
      current1 = CType(current1.Clone(), NumberFormatInfo)
      Console.WriteLine(current1.IsReadOnly)

      Dim culture2 As CultureInfo = CultureInfo.CreateSpecificCulture(CultureInfo.CurrentCulture.Name)
      Dim current2 As NumberFormatInfo = culture2.NumberFormat
      Console.WriteLine(current2.IsReadOnly)
   End Sub
End Module
' The example displays the following output:
'       False
'       False

Si noti che il sistema operativo Windows consente all'utente di eseguire l'override di alcune delle NumberFormatInfo i valori delle proprietà utilizzati nella formattazione numerica e l'analisi delle operazioni tramite il paese e lingua nel Pannello di controllo.Note that the Windows operating system allows the user to override some of the NumberFormatInfo property values used in numeric formatting and parsing operations through the Region and Language item in Control Panel. Ad esempio, un utente le cui impostazioni cultura è inglese (Stati Uniti) potrebbe scegliere di visualizzare i valori di valuta come USD 1.1 anziché il valore predefinito di $1.1.For example, a user whose culture is English (United States) might choose to display currency values as 1.1 USD instead of the default of $1.1. Il NumberFormatInfo gli oggetti recuperati nei modi descritti in precedenza riflettono questi override dell'utente.The NumberFormatInfo objects retrieved in the ways discussed previously all reflect these user overrides. Se questo è opportuna, è possibile creare un NumberFormatInfo oggetto che non rifletta le sostituzioni di utente (ed è anche di lettura/scrittura anziché di sola lettura) chiamando il CultureInfo.CultureInfo(String, Boolean) costruttore e specificando un valore pari false per il useUserOverride argomento.If this is undesirable, you can create a NumberFormatInfo object that does not reflect user overrides (and that is also read/write rather than read-only) by calling the CultureInfo.CultureInfo(String, Boolean) constructor and supplying a value of false for the useUserOverride argument. Nell'esempio seguente viene illustrato un sistema con impostazioni cultura correnti sono inglese (Stati Uniti) e il cui simbolo di valuta è stato modificato dal valore predefinito pari a $ in USD.The following example provides an illustration for a system whose current culture is English (United States) and whose currency symbol has been changed from the default of $ to USD.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo culture;
      NumberFormatInfo nfi;
      
      culture = CultureInfo.CurrentCulture;
      nfi = culture.NumberFormat;
      Console.WriteLine("Culture Name:    {0}", culture.Name);
      Console.WriteLine("User Overrides:  {0}", culture.UseUserOverride);
      Console.WriteLine("Currency Symbol: {0}\n", culture.NumberFormat.CurrencySymbol);
            
      culture = new CultureInfo(CultureInfo.CurrentCulture.Name, false);
      Console.WriteLine("Culture Name:    {0}", culture.Name);
      Console.WriteLine("User Overrides:  {0}", culture.UseUserOverride);
      Console.WriteLine("Currency Symbol: {0}", culture.NumberFormat.CurrencySymbol);
   }
}
// The example displays the following output:
//       Culture Name:    en-US
//       User Overrides:  True
//       Currency Symbol: USD
//       
//       Culture Name:    en-US
//       User Overrides:  False
//       Currency Symbol: $
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim culture As CultureInfo
      Dim nfi As NumberFormatInfo
      
      culture = CultureInfo.CurrentCulture
      nfi = culture.NumberFormat
      Console.WriteLine("Culture Name:    {0}", culture.Name)
      Console.WriteLine("User Overrides:  {0}", culture.UseUserOverride)
      Console.WriteLine("Currency Symbol: {0}", culture.NumberFormat.CurrencySymbol)
      Console.WriteLine()
            
      culture = New CultureInfo(CultureInfo.CurrentCulture.Name, False)
      Console.WriteLine("Culture Name:    {0}", culture.Name)
      Console.WriteLine("User Overrides:  {0}", culture.UseUserOverride)
      Console.WriteLine("Currency Symbol: {0}", culture.NumberFormat.CurrencySymbol)
   End Sub
End Module
' The example displays the following output:
'       Culture Name:    en-US
'       User Overrides:  True
'       Currency Symbol: USD
'       
'       Culture Name:    en-US
'       User Overrides:  False
'       Currency Symbol: $

Se il CultureInfo.UseUserOverride è impostata su true, la proprietà CultureInfo.DateTimeFormat, CultureInfo.NumberFormat, e CultureInfo.TextInfo vengono anche recuperati dalle impostazioni dell'utente.If the CultureInfo.UseUserOverride property is set to true, the properties CultureInfo.DateTimeFormat, CultureInfo.NumberFormat, and CultureInfo.TextInfo are also retrieved from the user settings. Se le impostazioni utente non sono compatibili con le impostazioni cultura associate le CultureInfo oggetto (ad esempio, se il calendario selezionato non è uno dei calendari elencati in base al OptionalCalendars proprietà), i risultati dei metodi e i valori delle proprietà sono non è definito.If the user settings are incompatible with the culture associated with the CultureInfo object (for example, if the selected calendar is not one of the calendars listed by the OptionalCalendars property), the results of the methods and the values of the properties are undefined.

Creare un'istanza di un oggetto NumberFormatInfo per le impostazioni cultura invariantiInstantiating a NumberFormatInfo object for the invariant culture

La lingua inglese rappresenta impostazioni cultura che è indipendente dalla lingua.The invariant culture represents a culture that is culture-insensitive. È basata sulla lingua inglese, ma non su qualsiasi specifico inglese paese.It is based on the English language but not on any specific English-speaking country/region. Anche se i dati delle impostazioni cultura specifiche possono essere dinamici e possono cambiare in modo da riflettere le preferenze dell'utente o convenzioni culturali nuovo, non modifica i dati delle impostazioni cultura invarianti.Although the data of specific cultures can be dynamic and can change to reflect new cultural conventions or user preferences, the data of the invariant culture does not change. Oggetto NumberFormatInfo oggetto che rappresenta le convenzioni di formattazione della cultura invariabile può essere utilizzato per operazioni di risultati non devono variare le stringhe di formattazione dalle impostazioni cultura.A NumberFormatInfo object that represents the formatting conventions of the invariant culture can be used for formatting operations in which result strings should not vary by culture.

È possibile creare un'istanza di un NumberFormatInfo oggetto che rappresenta le convenzioni di formattazione della cultura invariabile nei modi seguenti:You can instantiate a NumberFormatInfo object that represents the formatting conventions of the invariant culture in the following ways:

L'esempio seguente usa ognuno di questi metodi per creare un'istanza di un NumberFormatInfo oggetto che rappresenta le impostazioni cultura invarianti.The following example uses each of these methods to instantiate a NumberFormatInfo object that represents the invariant culture. E quindi indica se l'oggetto è di sola lettura,It then indicates whether the object is read-only,

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      NumberFormatInfo nfi;
      
      nfi = System.Globalization.NumberFormatInfo.InvariantInfo;
      Console.WriteLine(nfi.IsReadOnly);               
      
      nfi = CultureInfo.InvariantCulture.NumberFormat;
      Console.WriteLine(nfi.IsReadOnly);               
      
      nfi = New NumberFormatInfo();
      Console.WriteLine(nfi.IsReadOnly);               
   }
}
// The example displays the following output:
//       True
//       True
//       False
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim nfi As NumberFormatInfo
      
      nfi = System.Globalization.NumberFormatInfo.InvariantInfo
      Console.WriteLine(nfi.IsReadOnly)               
      
      nfi = CultureInfo.InvariantCulture.NumberFormat
      Console.WriteLine(nfi.IsReadOnly)               
      
      nfi = New NumberFormatInfo()
      Console.WriteLine(nfi.IsReadOnly)               
   End Sub
End Module
' The example displays the following output:
'       True
'       True
'       False

Creare un'istanza di un oggetto NumberFormatInfo per impostazioni cultura specificheInstantiating a NumberFormatInfo object for a specific culture

Impostazioni cultura specifiche rappresenta un linguaggio che è parlato in un determinato paese/area geografica.A specific culture represents a language that is spoken in a particular country/region. Ad esempio, en-US rappresenta impostazioni cultura specifiche che rappresenta la lingua inglese parlata negli Stati Uniti ed en-autorità di certificazione è delle impostazioni cultura specifiche che rappresenta la lingua inglese parlata in Canada.For example, en-US is a specific culture that represents the English language spoken in the United States, and en-CA is a specific culture that represents the English language spoken in Canada. È possibile creare un'istanza di un NumberFormatInfo oggetto che rappresenta le convenzioni di formattazione delle impostazioni cultura specifiche nei modi seguenti:You can instantiate a NumberFormatInfo object that represents the formatting conventions of a specific culture in the following ways:

L'esempio seguente Usa queste quattro modi per creare un NumberFormatInfo che riflette le convenzioni di formattazione delle impostazioni cultura indonesiano (Indonesia).The following example uses these four ways to create a NumberFormatInfo object that reflects the formatting conventions of the Indonesian (Indonesia) culture. Indica anche se ogni oggetto è di sola lettura.It also indicates whether each object is read-only.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo culture;
      NumberFormatInfo nfi;
      
      nfi = CultureInfo.GetCultureInfo("id-ID").NumberFormat;
      Console.WriteLine("Read-only: {0}", nfi.IsReadOnly);
      
      culture = new CultureInfo("id-ID");
      nfi = NumberFormatInfo.GetInstance(culture);
      Console.WriteLine("Read-only: {0}", nfi.IsReadOnly);
      
      culture = CultureInfo.CreateSpecificCulture("id-ID");
      nfi = culture.NumberFormat;
      Console.WriteLine("Read-only: {0}", nfi.IsReadOnly);
      
      culture = new CultureInfo("id-ID");
      nfi = culture.NumberFormat;
      Console.WriteLine("Read-only: {0}", nfi.IsReadOnly);
   }
}
// The example displays the following output:
//       Read-only: True
//       Read-only: False
//       Read-only: False
//       Read-only: False
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim culture As CultureInfo
      Dim nfi As NumberFormatInfo
      
      nfi = CultureInfo.GetCultureInfo("id-ID").NumberFormat
      Console.WriteLine("Read-only: {0}", nfi.IsReadOnly)
      
      culture = New CultureInfo("id-ID")
      nfi = NumberFormatInfo.GetInstance(culture)
      Console.WriteLine("Read-only: {0}", nfi.IsReadOnly)
      
      culture = CultureInfo.CreateSpecificCulture("id-ID")
      nfi = culture.NumberFormat
      Console.WriteLine("Read-only: {0}", nfi.IsReadOnly)
      
      culture = New CultureInfo("id-ID")
      nfi = culture.NumberFormat
      Console.WriteLine("Read-only: {0}", nfi.IsReadOnly)
   End Sub
End Module
' The example displays the following output:
'       Read-only: True
'       Read-only: False
'       Read-only: False
'       Read-only: False

Creare un'istanza di un oggetto NumberFormatInfo per alcune impostazioni culturaInstantiating a NumberFormatInfo object for a neutral culture

Alcune impostazioni cultura rappresenta una lingua indipendente da un paese/area geografica o delle impostazioni cultura.A neutral culture represents a culture or language that is independent of a country/region. In genere è l'elemento padre di una o più impostazioni cultura specifiche.It is typically the parent of one or more specific cultures. Fr è ad esempio, alcune impostazioni cultura per la lingua francese e l'elemento padre delle impostazioni cultura fr-FR.For example, fr is a neutral culture for the French language and the parent of the fr-FR culture. Si crea una NumberFormatInfo oggetto che rappresenta le convenzioni di formattazione delle impostazioni cultura neutra nello stesso modo in cui si crea un NumberFormatInfo oggetto che rappresenta le convenzioni di formattazione delle impostazioni cultura specifiche.You create a NumberFormatInfo object that represents the formatting conventions of a neutral culture in the same way that you create a NumberFormatInfo object that represents the formatting conventions of a specific culture.

Nota

Nel .NET Framework 3.5.NET Framework 3.5 e versioni precedenti, il tentativo di recuperare una NumberFormatInfo genera un'eccezione che riflette le convenzioni di formattazione delle impostazioni cultura neutre un NotSupportedException eccezione.In the .NET Framework 3.5.NET Framework 3.5 and earlier versions, trying to retrieve a NumberFormatInfo object that reflects the formatting conventions of a neutral culture throws a NotSupportedException exception.

Tuttavia, poiché è indipendente da un paese/area geografica specificato, alcune impostazioni cultura non dispone delle informazioni di formattazione specifiche delle impostazioni cultura.However, because it is independent of a specific country/region, a neutral culture lacks culture-specific formatting information. Invece di popolare il NumberFormatInfo dell'oggetto con valori di tipo generici, .NET Framework restituisce un NumberFormatInfo oggetto che riflette le convenzioni di formattazione di uno specifico delle impostazioni cultura che è un figlio di impostazioni cultura di sistema.Rather than populating the NumberFormatInfo object with generic values, the .NET Framework returns a NumberFormatInfo object that reflects the formatting conventions of a specific culture that is a child of the neutral culture. Ad esempio, il NumberFormatInfo dell'oggetto per la lingua neutra en riflette le convenzioni di formattazione delle impostazioni cultura en-US e il NumberFormatInfo dell'oggetto per le impostazioni cultura fr riflettono le convenzioni di formattazione delle impostazioni cultura fr-FR.For example, the NumberFormatInfo object for the neutral en culture reflects the formatting conventions of the en-US culture, and the NumberFormatInfo object for the fr culture reflects the formatting conventions of the fr-FR culture.

È possibile usare codice simile al seguente per determinare le convenzioni di formattazione che specifica impostazione cultura rappresenta ognuna delle impostazioni cultura neutra.You can use code like the following to determine which specific culture's formatting conventions each neutral culture represents.

using System;
using System.Collections;
using System.Collections.Generic;
using System.Globalization;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Get all the neutral cultures
      List<String> names = new List<String>();
      Array.ForEach(CultureInfo.GetCultures(CultureTypes.NeutralCultures),
                    culture => names.Add(culture.Name));
      names.Sort();
      foreach (var name in names) {
         // Ignore the invariant culture.
         if (name == "") continue;
         
         ListSimilarChildCultures(name);        
      }
   }

   private static void ListSimilarChildCultures(string name)
   { 
      // Create the neutral NumberFormatInfo object.
      NumberFormatInfo nfi = CultureInfo.GetCultureInfo(name).NumberFormat;
      // Retrieve all specific cultures of the neutral culture.
      CultureInfo[] cultures = Array.FindAll(CultureInfo.GetCultures(CultureTypes.SpecificCultures), 
                               culture => culture.Name.StartsWith(name + "-", StringComparison.OrdinalIgnoreCase));
      // Create an array of NumberFormatInfo properties
      PropertyInfo[] properties = typeof(NumberFormatInfo).GetProperties(BindingFlags.Instance | BindingFlags.Public);
      bool hasOneMatch = false;

      foreach (var ci in cultures) {
         bool match = true;     
         // Get the NumberFormatInfo for a specific culture.
         NumberFormatInfo specificNfi = ci.NumberFormat;
         // Compare the property values of the two.
         foreach (var prop in properties) {
            // We're not interested in the value of IsReadOnly.     
            if (prop.Name == "IsReadOnly") continue;
            
            // For arrays, iterate the individual elements to see if they are the same.
            if (prop.PropertyType.IsArray) { 
               IList nList = (IList) prop.GetValue(nfi, null);
               IList sList = (IList) prop.GetValue(specificNfi, null);
               if (nList.Count != sList.Count) {
                  match = false;
                  break;
               } 

               for (int ctr = 0; ctr < nList.Count; ctr++) {
                  if (! nList[ctr].Equals(sList[ctr])) {
                     match = false;
                     break;
                  }     
               }
            }   
            else if (! prop.GetValue(specificNfi).Equals(prop.GetValue(nfi))) {
               match = false;
               break;   
            }        
         }
         if (match) {
            Console.WriteLine("NumberFormatInfo object for '{0}' matches '{1}'", 
                                      name, ci.Name);
            hasOneMatch = true;
         }                                       
      }
      if (! hasOneMatch)
         Console.WriteLine("NumberFormatInfo object for '{0}' --> No Match", name);            

      Console.WriteLine();
   }
}
Imports System
Imports System.Collections
Imports System.Collections.Generic
Imports System.Globalization
Imports System.Reflection

Module Example
   Public Sub Main()
      ' Get all the neutral cultures
      Dim names As New List(Of String)
      Array.ForEach(CultureInfo.GetCultures(CultureTypes.NeutralCultures),
                    Sub(culture) names.Add(culture.Name))
      names.Sort()
      For Each name In names
         ' Ignore the invariant culture.
         If name = "" Then Continue For
         
         ListSimilarChildCultures(name)        
      Next
   End Sub

   Private Sub ListSimilarChildCultures(name As String)
      ' Create the neutral NumberFormatInfo object.
      Dim nfi As NumberFormatInfo = CultureInfo.GetCultureInfo(name).NumberFormat
      ' Retrieve all specific cultures of the neutral culture.
      Dim cultures() As CultureInfo = Array.FindAll(CultureInfo.GetCultures(CultureTypes.SpecificCultures), 
                               Function(culture) culture.Name.StartsWith(name + "-", StringComparison.OrdinalIgnoreCase))
      ' Create an array of NumberFormatInfo properties
      Dim properties() As PropertyInfo = GetType(NumberFormatInfo).GetProperties(BindingFlags.Instance Or BindingFlags.Public)
      Dim hasOneMatch As Boolean = False

      For Each ci In cultures
         Dim match As Boolean = True     
         ' Get the NumberFormatInfo for a specific culture.
         Dim specificNfi As NumberFormatInfo = ci.NumberFormat
         ' Compare the property values of the two.
         For Each prop In properties
            ' We're not interested in the value of IsReadOnly.     
            If prop.Name = "IsReadOnly" Then Continue For
            
            ' For arrays, iterate the individual elements to see if they are the same.
            If prop.PropertyType.IsArray Then 
               Dim nList As IList = CType(prop.GetValue(nfi, Nothing), IList)
               Dim sList As IList = CType(prop.GetValue(specificNfi, Nothing), IList)
               If nList.Count <> sList.Count Then
                  match = false
                  Exit For
               End If 

               For ctr As Integer = 0 To nList.Count - 1
                  If Not nList(ctr).Equals(sList(ctr)) 
                     match = false
                     Exit For
                  End If     
               Next
            Else If Not prop.GetValue(specificNfi).Equals(prop.GetValue(nfi))
               match = false
               Exit For   
            End If        
         Next
         If match Then
            Console.WriteLine("NumberFormatInfo object for '{0}' matches '{1}'", 
                                      name, ci.Name)
            hasOneMatch = true
         End If                                       
      Next
      If Not hasOneMatch Then
         Console.WriteLine("NumberFormatInfo object for '{0}' --> No Match", name)            
      End If
      
      Console.WriteLine()
   End Sub
End Module

NumberFormatInfo e dynamic dataNumberFormatInfo and dynamic data

I dati specifici delle impostazioni cultura per la formattazione di valori numerici forniti per il NumberFormatInfo classe è dinamica, esattamente come i dati relative alle impostazioni cultura forniti dal CultureInfo classe.The culture-specific data for formatting numeric values provided by the NumberFormatInfo class is dynamic, just like the cultural data provided by the CultureInfo class. È consigliabile non apportare supposizioni sulla stabilità dei valori per NumberFormatInfo gli oggetti che sono associati con particolare CultureInfo oggetti.You should not make any assumptions about the stability of values for NumberFormatInfo objects that are associated with particular CultureInfo objects. Solo i dati forniti da a essa associati e le impostazioni cultura invarianti NumberFormatInfo oggetto è stabile.Only the data provided by the invariant culture and its associated NumberFormatInfo object is stable. Altri dati possono cambiare tra le sessioni dell'applicazione, o anche all'interno di una singola sessione, per i motivi seguenti:Other data can change between application sessions, or even within a single session, for the following reasons:

  • Aggiornamenti del sistema.System updates. Le preferenze culturali, ad esempio il simbolo di valuta o formati di valuta cambiano nel tempo.Cultural preferences such as the currency symbol or currency formats change over time. In questo caso, Windows Update contiene modifiche al sistema il NumberFormatInfo valore della proprietà per una specifica impostazione cultura.When this happens, Windows Update includes changes to the NumberFormatInfo property value for a particular culture.

  • Impostazioni cultura sostitutive.Replacement cultures. Il CultureAndRegionInfoBuilder classe può essere utilizzata per sostituire i dati di una lingua esistente.The CultureAndRegionInfoBuilder class can be used to replace the data of an existing culture.

  • Le modifiche ai valori delle proprietà di propagazione.Cascading changes to property values. Un numero di proprietà relative alla lingua può cambiare in fase di esecuzione che, a sua volta, fa sì che NumberFormatInfo la modifica dei dati.A number of culture-related properties can change at run time, which, in turn, causes NumberFormatInfo data to change. Le impostazioni cultura correnti, ad esempio, può essere modificata a livello di codice o tramite un'azione utente.For example, the current culture can be changed either programmatically or through user action. In questo caso, il NumberFormatInfo oggetto restituito dal CurrentInfo proprietà viene impostata su un oggetto associato a impostazioni cultura correnti.When this happens, the NumberFormatInfo object returned by the CurrentInfo property changes to an object associated with the current culture.

  • Preferenze dell'utente.User preferences. Gli utenti dell'applicazione potrebbero quindi sostituire alcuni dei valori associati con le impostazioni cultura correnti del sistema tramite le opzioni di paese e lingua nel Pannello di controllo.Users of your application might override some of the values associated with the current system culture through the region and language options in Control Panel. Ad esempio, gli utenti potrebbero scegliere un simbolo di valuta diverso o un simbolo del separatore decimale diverso.For example, users might choose a different currency symbol or a different decimal separator symbol. Se il CultureInfo.UseUserOverride è impostata su true (valore predefinito), le proprietà del NumberFormatInfo oggetto vengono anche recuperati dalle impostazioni dell'utente.If the CultureInfo.UseUserOverride property is set to true (its default value), the properties of the NumberFormatInfo object are also retrieved from the user settings.

A partire da .NET Framework 2.0, tutte le proprietà sottoponibile a override dall'utente di un NumberFormatInfo oggetto vengono inizializzate quando viene creato l'oggetto.Starting with the .NET Framework 2.0, all user-overridable properties of a NumberFormatInfo object are initialized when the object is created. È ancora presente la possibilità di incoerenza, perché nessuna delle due la creazione di oggetti né il processo di sostituzione dell'utente è atomico, e i valori pertinenti vengano modificati durante la creazione di oggetti.There is still a possibility of inconsistency, because neither object creation nor the user override process is atomic, and the relevant values may change during object creation. Tuttavia, queste incoerenze sia estremamente rare.However, these inconsistencies should be extremely rare.

È possibile controllare se l'utente esegue l'override vengono riflesse nelle NumberFormatInfo gli oggetti che rappresentano le stesse impostazioni cultura come impostazioni cultura del thread corrente.You can control whether user overrides are reflected in NumberFormatInfo objects that represent the same culture as the current thread culture. La tabella seguente elenca i modi in cui un NumberFormatInfo oggetto possono essere recuperato e indica se l'oggetto risultante riflette l'override dell'utente.The following table lists the ways in which a NumberFormatInfo object can be retrieved and indicates whether the resulting object reflects user overrides.

Origine dell'oggetto CultureInfo e NumberFormatInfoSource of CultureInfo and NumberFormatInfo object Riflette l'override dell'utenteReflects user overrides
ProprietàCultureInfo.CurrentCulture.NumberFormat CultureInfo.CurrentCulture.NumberFormat property Yes
ProprietàNumberFormatInfo.CurrentInfo NumberFormatInfo.CurrentInfo property Yes
Metodo CultureInfo.CreateSpecificCultureCultureInfo.CreateSpecificCulture method Yes
Metodo CultureInfo.GetCultureInfoCultureInfo.GetCultureInfo method NoNo
Costruttore CultureInfo(String)CultureInfo(String) constructor Yes
Costruttore CultureInfo.CultureInfo(String, Boolean)CultureInfo.CultureInfo(String, Boolean) constructor Dipende dal valore di useUserOverride parametroDepends on value of useUserOverride parameter

A meno che non vi è un valido motivo per agire diversamente, è necessario rispettare le sostituzioni utente quando si usa il NumberFormatInfo oggetto nelle applicazioni client la formattazione e analisi dell'input utente o per visualizzare i dati numerici.Unless there is a compelling reason to do otherwise, you should respect user overrides when you use the NumberFormatInfo object in client applications to format and parse user input or to display numeric data. Per le applicazioni server o automatica, è necessario rispettare non override dell'utente.For server applications or unattended applications, you should not respect user overrides. Tuttavia, se si usa la NumberFormatInfo uno dell'oggetto in modo esplicito o implicito per rendere persistenti i dati numerici in formato stringa, è necessario utilizzare un NumberFormatInfo che riflette le convenzioni di formattazione delle impostazioni cultura invarianti, oppure è necessario specificare un stringa di formato numerico personalizzato che usi indipendentemente dalle impostazioni cultura.However, if you are using the NumberFormatInfo object either explicitly or implicitly to persist numeric data in string form, you should either use a NumberFormatInfo object that reflects the formatting conventions of the invariant culture, or you should specify a custom numeric format string that you use regardless of culture.

IFormatProvider NumberFormatInfo e formattazione numericaIFormatProvider, NumberFormatInfo, and numeric formatting

Oggetto NumberFormatInfo oggetto viene usato in modo implicito o esplicito nel valore numerico di tutte le operazioni di formattazione.A NumberFormatInfo object is used implicitly or explicitly in all numeric formatting operations. Sono incluse le chiamate ai metodi seguenti:These include calls to the following methods:

Apportare tutte le operazioni di formattazione numeriche Usa un IFormatProvider implementazione.All numeric formatting operations make use of an IFormatProvider implementation. Il IFormatProvider interfaccia include un solo metodo, GetFormat(Type).The IFormatProvider interface includes a single method, GetFormat(Type). Si tratta di un metodo di callback che viene passato un Type oggetto che rappresenta il tipo necessario per fornire informazioni di formattazione.This is a callback method that is passed a Type object that represents the type needed to provide formatting information. Il metodo è responsabile della restituzione di un'istanza di quel tipo o null, se non può fornire un'istanza del tipo.The method is responsible for returning either an instance of that type or null, if it cannot provide an instance of the type. .NET Framework offre due IFormatProvider implementazioni per la formattazione dei numeri:The .NET Framework provides two IFormatProvider implementations for formatting numbers:

Se un' IFormatProvider implementazione non viene fornita a un metodo di formattazione in modo esplicito, una CultureInfo oggetto restituito dal CultureInfo.CurrentCulture proprietà che rappresenta le impostazioni cultura del thread corrente viene utilizzata.If an IFormatProvider implementation is not provided to a formatting method explicitly, a CultureInfo object returned by the CultureInfo.CurrentCulture property that represents the current thread culture is used.

Nell'esempio seguente viene illustrata la relazione tra il IFormatProvider interfaccia e il NumberFormatInfo classe nelle operazioni di formattazione con la definizione di un oggetto personalizzato IFormatProvider implementazione.The following example illustrates the relationship between the IFormatProvider interface and the NumberFormatInfo class in formatting operations by defining a custom IFormatProvider implementation. Relativo GetFormat metodo visualizza il nome del tipo dell'oggetto richiesto dall'operazione di formattazione.Its GetFormat method displays the type name of the object requested by the formatting operation. Se sta richiedendo l'interfaccia di un NumberFormatInfo dell'oggetto, questo metodo offre la NumberFormatInfo oggetto per impostazioni cultura del thread corrente.If the interface is requesting a NumberFormatInfo object, this method provides the NumberFormatInfo object for the current thread culture. Come l'output illustrato nell'esempio, il Decimal.ToString(IFormatProvider) le richieste di metodo una NumberFormatInfo oggetto da fornire informazioni di formattazione, mentre le String.Format(IFormatProvider, String, Object[]) le richieste di metodo NumberFormatInfo e DateTimeFormatInfo oggetti, nonché un ICustomFormatter implementazione.As the output from the example shows, the Decimal.ToString(IFormatProvider) method requests a NumberFormatInfo object to provide formatting information, whereas the String.Format(IFormatProvider, String, Object[]) method requests NumberFormatInfo and DateTimeFormatInfo objects as well as an ICustomFormatter implementation.

using System;
using System.Globalization;

public class CurrentCultureFormatProvider : IFormatProvider
{
   public Object GetFormat(Type formatType) 
   {
      Console.WriteLine("Requesting an object of type {0}", 
                        formatType.Name);
      if (formatType == typeof(NumberFormatInfo))
         return NumberFormatInfo.CurrentInfo;
      else if (formatType == typeof(DateTimeFormatInfo))
         return DateTimeFormatInfo.CurrentInfo;
      else
         return null;
   }
}

public class Example
{
   public static void Main()
   {
      Decimal amount = 1203.541m;
      string value = amount.ToString("C2", new CurrentCultureFormatProvider());
      Console.WriteLine(value);
      Console.WriteLine();
      string composite = String.Format(new CurrentCultureFormatProvider(), 
                                       "Date: {0}   Amount: {1}   Description: {2}",
                                       DateTime.Now, 1264.03m, "Service Charge");
      Console.WriteLine(composite);
      Console.WriteLine();
   }
}
// The example displays output like the following:
//    Requesting an object of type NumberFormatInfo
//    $1,203.54
//    
//    Requesting an object of type ICustomFormatter
//    Requesting an object of type DateTimeFormatInfo
//    Requesting an object of type NumberFormatInfo
//    Date: 11/15/2012 2:00:01 PM   Amount: 1264.03   Description: Service Charge
Imports System.Globalization

Public Class CurrentCultureFormatProvider : Implements IFormatProvider
   Public Function GetFormat(formatType As Type) As Object _
                   Implements IFormatProvider.GetFormat
      Console.WriteLine("Requesting an object of type {0}", 
                        formatType.Name)
      If formatType Is GetType(NumberFormatInfo) Then
         Return NumberFormatInfo.CurrentInfo
      Else If formatType Is GetType(DateTimeFormatInfo) Then
         Return DateTimeFormatInfo.CurrentInfo
      Else
         Return Nothing
      End If
   End Function
End Class

Module Example
   Public Sub Main()
      Dim amount As Decimal = 1203.541d
      Dim value As String = amount.ToString("C2", New CurrentCultureFormatProvider())
      Console.WriteLine(value)
      Console.WriteLine()
      Dim composite As String = String.Format(New CurrentCultureFormatProvider, 
                                              "Date: {0}   Amount: {1}   Description: {2}",
                                              Date.Now, 1264.03d, "Service Charge")
      Console.WriteLine(composite)
      Console.WriteLine()
   End Sub
End Module
' The example displays output like the following:
'    Requesting an object of type NumberFormatInfo
'    $1,203.54
'    
'    Requesting an object of type ICustomFormatter
'    Requesting an object of type DateTimeFormatInfo
'    Requesting an object of type NumberFormatInfo
'    Date: 11/15/2012 2:00:01 PM   Amount: 1264.03   Description: Service Charge

Se un' IFormatProvider implementazione non viene fornita in modo esplicito in un chiamata al metodo, le chiamate al metodo di formattazione numerica il CultureInfo.CurrentCulture.GetFormat metodo, che restituisce il NumberFormatInfo oggetto corrispondente alle impostazioni cultura del thread corrente.If an IFormatProvider implementation is not explicitly provided in a numeric formatting method call, the method calls the CultureInfo.CurrentCulture.GetFormat method, which returns the NumberFormatInfo object that corresponds to the current thread culture.

Stringhe di formato e proprietà NumberFormatInfoFormat strings and NumberFormatInfo properties

Ogni operazione di formattazione utilizza standard o una stringa di formato numerico personalizzato per produrre una stringa di risultato da un numero.Every formatting operation uses either a standard or a custom numeric format string to produce a result string from a number. In alcuni casi, l'uso di una stringa di formato per produrre una stringa di risultato è explicit, come nell'esempio seguente.In some cases, the use of a format string to produce a result string is explicit, as in the following example. Questo codice chiama il Decimal.ToString(IFormatProvider) metodo per convertire un Decimal valore a un numero diverso delle rappresentazioni di stringa usando le convenzioni di formattazione delle impostazioni cultura en-US.This code calls the Decimal.ToString(IFormatProvider) method to convert a Decimal value to a number of different string representations by using the formatting conventions of the en-US culture.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] formatStrings = { "C2", "E1", "F", "G3", "N", 
                                 "#,##0.000", "0,000,000,000.0##" };
      CultureInfo culture = CultureInfo.CreateSpecificCulture("en-US");
      Decimal[] values = { 1345.6538m, 1921651.16m };
      
      foreach (var value in values) {
         foreach (var formatString in formatStrings) {
            string resultString = value.ToString(formatString, culture);
            Console.WriteLine("{0,-18} -->  {1}", formatString, resultString);
         }
         Console.WriteLine();      
      }   
   }
}
// The example displays the following output:
//       C2                 -->  $1,345.65
//       E1                 -->  1.3E+003
//       F                  -->  1345.65
//       G3                 -->  1.35E+03
//       N                  -->  1,345.65
//       #,##0.000          -->  1,345.654
//       0,000,000,000.0##  -->  0,000,001,345.654
//       
//       C2                 -->  $1,921,651.16
//       E1                 -->  1.9E+006
//       F                  -->  1921651.16
//       G3                 -->  1.92E+06
//       N                  -->  1,921,651.16
//       #,##0.000          -->  1,921,651.160
//       0,000,000,000.0##  -->  0,001,921,651.16
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim formatStrings() As String = { "C2", "E1", "F", "G3", "N", 
                                        "#,##0.000", "0,000,000,000.0##" }
      Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
      Dim values() As Decimal = { 1345.6538d, 1921651.16d }
      
      For Each value In values
         For Each formatString In formatStrings
            Dim resultString As String = value.ToString(formatString, culture)
            Console.WriteLine("{0,-18} -->  {1}", formatString, resultString)
         Next
         Console.WriteLine()      
      Next   
   End Sub
End Module
' The example displays the following output:
'       C2                 -->  $1,345.65
'       E1                 -->  1.3E+003
'       F                  -->  1345.65
'       G3                 -->  1.35E+03
'       N                  -->  1,345.65
'       #,##0.000          -->  1,345.654
'       0,000,000,000.0##  -->  0,000,001,345.654
'       
'       C2                 -->  $1,921,651.16
'       E1                 -->  1.9E+006
'       F                  -->  1921651.16
'       G3                 -->  1.92E+06
'       N                  -->  1,921,651.16
'       #,##0.000          -->  1,921,651.160
'       0,000,000,000.0##  -->  0,001,921,651.16

In altri casi, l'uso di una stringa di formato è implicita.In other cases, the use of a format string is implicit. Ad esempio, nelle chiamate di metodo seguenti sul valore predefinito o senza parametri Decimal.ToString() metodo, il valore della Decimal istanza viene formattata usando l'identificatore di formato generale ("G") e le convenzioni delle impostazioni cultura correnti, in questo caso il impostazioni cultura en-US.For example, in the following method calls to the default or parameterless Decimal.ToString() method, the value of the Decimal instance is formatted by using the general ("G") format specifier and the conventions of the current culture, which in this case is the en-US culture.

using System;

public class Example
{
   public static void Main()
   {
      Decimal[] values = { 1345.6538m, 1921651.16m };
      
      foreach (var value in values) {
         string resultString = value.ToString();
         Console.WriteLine(resultString);
         Console.WriteLine();      
      }   
   }
}
// The example displays the following output:
//       1345.6538
//       
//       1921651.16
Module Example
   Public Sub Main()
      Dim values() As Decimal = { 1345.6538d, 1921651.16d }
      
      For Each value In values
         Dim resultString As String = value.ToString()
         Console.WriteLine(resultString)
         Console.WriteLine()      
      Next   
   End Sub
End Module
' The example displays the following output:
'       1345.6538
'       
'       1921651.16

Ogni stringa di formato numerico standard utilizza uno o più NumberFormatInfo proprietà per determinare il modello o i simboli usati nella stringa di risultato.Each standard numeric format string uses one or more NumberFormatInfo properties to determine the pattern or the symbols used in the result string. Allo stesso modo, ogni identificatore di formato numerico personalizzata ad eccezione del fatto "0" e "#" inserire i simboli nella stringa di risultato che sono definiti da NumberFormatInfo proprietà.Similarly, each custom numeric format specifier except "0" and "#" insert symbols in the result string that are defined by NumberFormatInfo properties. La tabella seguente elenca lo standard e identificatori di formato numerico personalizzati e i relativi NumberFormatInfo proprietà.The following table lists the standard and custom numeric format specifiers and their associated NumberFormatInfo properties. Per modificare l'aspetto della stringa di risultato per impostazioni cultura specifiche, vedere la proprietà NumberFormatInfo modifica sezione.To change the appearance of the result string for a particular culture, see the Modifying NumberFormatInfo properties section. Per informazioni dettagliate sull'uso di questi identificatori di formato, vedere Standard Numeric Format Strings e Custom Numeric Format Strings.For details about the use of these format specifiers, see Standard Numeric Format Strings and Custom Numeric Format Strings.

Identificatore di formatoFormat specifier Proprietà associateAssociated properties
"C" o "c" (identificatore di formato valuta)"C" or "c" (currency format specifier) CurrencyDecimalDigits, per definire il numero predefinito di cifre frazionarie.CurrencyDecimalDigits, to define the default number of fractional digits.

CurrencyDecimalSeparator, per definire il simbolo di separatore decimale.CurrencyDecimalSeparator, to define the decimal separator symbol.

CurrencyGroupSeparator, per definire il gruppo o migliaia separatore.CurrencyGroupSeparator, to define the group or thousands separator.

CurrencyGroupSizes, per definire le dimensioni dei gruppi integrale.CurrencyGroupSizes, to define the sizes of integral groups.

CurrencyNegativePattern, per definire il modello dei valori di valuta negativi.CurrencyNegativePattern, to define the pattern of negative currency values.

CurrencyPositivePattern, per definire il modello dei valori di valuta positivi.CurrencyPositivePattern, to define the pattern of positive currency values.

CurrencySymbol, per definire il simbolo di valuta.CurrencySymbol, to define the currency symbol.

NegativeSign, per definire il simbolo di segno negativo.NegativeSign, to define the negative sign symbol.
"D" o "d" (identificatore di formato decimale)"D" or "d" (decimal format specifier) NegativeSign, per definire il simbolo di segno negativo.NegativeSign, to define the negative sign symbol.
"E" o "e" (identificatore di formato esponenziale o scientifica)"E" or "e" (exponential or scientific format specifier) NegativeSign, per definire il simbolo di segno negativo nella mantissa ed esponente.NegativeSign, to define the negative sign symbol in the mantissa and exponent.

NumberDecimalSeparator, per definire il simbolo di separatore decimale.NumberDecimalSeparator, to define the decimal separator symbol.

PositiveSign, per definire il simbolo di segno positivo nell'esponente.PositiveSign, to define the positive sign symbol in the exponent.
"F" o "f" (identificatore di formato a virgola fissa)"F" or "f" (fixed-point format specifier) NegativeSign, per definire il simbolo di segno negativo.NegativeSign, to define the negative sign symbol.

NumberDecimalDigits, per definire il numero predefinito di cifre frazionarie.NumberDecimalDigits, to define the default number of fractional digits.

NumberDecimalSeparator, per definire il simbolo di separatore decimale.NumberDecimalSeparator, to define the decimal separator symbol.
"G" o "g" (identificatore di formato generale)"G" or "g" (general format specifier) NegativeSign, per definire il simbolo di segno negativo.NegativeSign, to define the negative sign symbol.

NumberDecimalSeparator, per definire il simbolo di separatore decimale.NumberDecimalSeparator, to define the decimal separator symbol.

PositiveSign, per definire il simbolo di segno positivo per le stringhe di risultato in formato esponenziale.PositiveSign, to define the positive sign symbol for result strings in exponential format.
"N" o "n" (identificatore di formato numerico)"N" or "n" (number format specifier) NegativeSign, per definire il simbolo di segno negativo.NegativeSign, to define the negative sign symbol.

NumberDecimalDigits, per definire il numero predefinito di cifre frazionarie.NumberDecimalDigits, to define the default number of fractional digits.

NumberDecimalSeparator, per definire il simbolo di separatore decimale.NumberDecimalSeparator, to define the decimal separator symbol.

NumberGroupSeparator, per definire il simbolo di separatore (migliaia) di gruppo.NumberGroupSeparator, to define the group separator (thousands) symbol.

NumberGroupSizes, per definire il numero di cifre integrali in un gruppo.NumberGroupSizes, to define the number of integral digits in a group.

NumberNegativePattern, per definire il formato dei valori negativi.NumberNegativePattern, to define the format of negative values.
"P" o "p" (identificatore di formato percentuale)"P" or "p" (percent format specifier) NegativeSign, per definire il simbolo di segno negativo.NegativeSign, to define the negative sign symbol.

PercentDecimalDigits, per definire il numero predefinito di cifre frazionarie.PercentDecimalDigits, to define the default number of fractional digits.

PercentDecimalSeparator, per definire il simbolo di separatore decimale.PercentDecimalSeparator, to define the decimal separator symbol.

PercentGroupSeparator, per definire il simbolo di separatore di gruppo.PercentGroupSeparator, to define the group separator symbol.

PercentGroupSizes, per definire il numero di cifre integrali in un gruppo.PercentGroupSizes, to define the number of integral digits in a group.

PercentNegativePattern, per definire la posizione del simbolo di percentuale e del simbolo negativo per i valori negativi.PercentNegativePattern, to define the placement of the percent symbol and the negative symbol for negative values.

PercentPositivePattern, per definire la posizione del simbolo di percentuale per i valori positivi.PercentPositivePattern, to define the placement of the percent symbol for positive values.

PercentSymbol, per definire il simbolo di percentuale.PercentSymbol, to define the percent symbol.
"R" o "r" (identificatore di formato round trip)"R" or "r" (round-trip format specifier) NegativeSign, per definire il simbolo di segno negativo.NegativeSign, to define the negative sign symbol.

NumberDecimalSeparator, per definire il simbolo di separatore decimale.NumberDecimalSeparator, to define the decimal separator symbol.

PositiveSign, per definire il simbolo di segno positivo in un esponente.PositiveSign, to define the positive sign symbol in an exponent.
"X" o "x" (identificatore di formato esadecimale)"X" or "x" (hexadecimal format specifier) Nessuno.None.
"." (identificatore di formato personalizzato separatore decimale)"." (decimal point custom format specifier) NumberDecimalSeparator, per definire il simbolo di separatore decimale.NumberDecimalSeparator, to define the decimal separator symbol.
"," (identificatore di formato personalizzato separatore di gruppo)"," (group separator custom format specifier) NumberGroupSeparator, per definire il simbolo di separatore di gruppo (migliaia).NumberGroupSeparator, to define the group (thousands) separator symbol.
"%" (identificatore di formato personalizzato segnaposto percentuale)"%" (percentage placeholder custom format specifier) PercentSymbol, per definire il simbolo di percentuale.PercentSymbol, to define the percent symbol.
"‰" (per ogni identificatore di formato personalizzato segnaposto mille)"‰" (per mille placeholder custom format specifier) PerMilleSymbol, per definire il simbolo di per mille.PerMilleSymbol, to define the per mille symbol.
"E" (identificatore di formato personalizzato notazione esponenziale)"E" (exponential notation custom format specifier) NegativeSign, per definire il simbolo di segno negativo nella mantissa ed esponente.NegativeSign, to define the negative sign symbol in the mantissa and exponent.

PositiveSign, per definire il simbolo di segno positivo nell'esponente.PositiveSign, to define the positive sign symbol in the exponent.

Si noti che il NumberFormatInfo classe include una NativeDigits proprietà che specifica la base 10 cifre utilizzate dalle impostazioni cultura specifica.Note that the NumberFormatInfo class includes a NativeDigits property that specifies the base 10 digits used by a specific culture. Tuttavia, la proprietà non viene utilizzata nelle operazioni; di formattazione solo le cifre latine di base da 0 (u+0030) a 9 (u+0039) vengono utilizzati nella stringa di risultato.However, the property is not used in formatting operations; only the Basic Latin digits 0 (U+0030) through 9 (U+0039) are used in the result string. Inoltre, per Single e Double i valori di NaN, PositiveInfinity, e NegativeInfinity, la stringa di risultato è costituito esclusivamente da simboli definiti dal NaNSymbol, PositiveInfinitySymbol, e NegativeInfinitySymbol proprietà , rispettivamente.In addition, for Single and Double values of NaN, PositiveInfinity, and NegativeInfinity, the result string consists exclusively of the symbols defined by the NaNSymbol, PositiveInfinitySymbol, and NegativeInfinitySymbol properties, respectively.

Modifica delle proprietà di NumberFormatInfoModifying NumberFormatInfo properties

È possibile modificare le proprietà di un NumberFormatInfo oggetto per personalizzare la stringa di risultato generati in un'operazione di formattazione numerica.You can modify the properties of a NumberFormatInfo object to customize the result string produced in a numeric formatting operation. Per eseguire questa operazione:To do this:

  1. Creare una copia di lettura/scrittura di un NumberFormatInfo oggetto cui si desidera modificare le convenzioni di formattazione.Create a read/write copy of a NumberFormatInfo object whose formatting conventions you want to modify. Per altre informazioni, vedere la un'istanza di un oggetto NumberFormatInfo sezione.For more information, see the Instantiating a NumberFormatInfo object section.

  2. Modificare le proprietà che vengono utilizzati per produrre la stringa di risultato desiderato.Modify the property or properties that are used to produce the desired result string. Per informazioni sull'uso dei metodi come formattazione NumberFormatInfo delle proprietà per definire le stringhe di risultato, vedere la stringhe di formato e proprietà NumberFormatInfo sezione.For information about how formatting methods use NumberFormatInfo properties to define result strings, see the Format strings and NumberFormatInfo properties section.

  3. Usare l'oggetto personalizzato NumberFormatInfo dell'oggetto come il IFormatProvider argomenti nelle chiamate ai metodi di formattazione.Use the custom NumberFormatInfo object as the IFormatProvider argument in calls to formatting methods.

Nota

Invece di modificare dinamicamente i valori di proprietà di un'impostazione cultura ogni volta che viene avviata un'applicazione, è possibile usare il CultureAndRegionInfoBuilder classe per definire le impostazioni cultura personalizzata (impostazioni cultura che ha un nome univoco e che integra le impostazioni cultura esistente) o sostituzione impostazioni cultura (uno che viene usato invece di impostazioni cultura specifiche).Instead of dynamically modifying a culture's property values each time an application is started, you can use the CultureAndRegionInfoBuilder class to define either a custom culture (a culture that has a unique name and that supplements existing cultures) or a replacement culture (one that is used instead of a specific culture).

Le sezioni seguenti forniscono alcuni esempi.The following sections provide some examples.

Modifica il modello e il simbolo di valutaModifying the currency symbol and pattern

L'esempio seguente modifica un NumberFormatInfo oggetto che rappresenta le convenzioni di formattazione delle impostazioni cultura en-US.The following example modifies a NumberFormatInfo object that represents the formatting conventions of the en-US culture. Assegna il simbolo di valuta ISO 4217 il CurrencySymbol proprietà e definisce un modello per i valori di valuta che è costituito il simbolo di valuta seguito da uno spazio e un valore numerico.It assigns the ISO-4217 currency symbol to the CurrencySymbol property and defines a pattern for currency values that consists of the currency symbol followed by a space and a numeric value.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Retrieve a writable NumberFormatInfo object.
      CultureInfo enUS = CultureInfo.CreateSpecificCulture("en-US");
      NumberFormatInfo nfi = enUS.NumberFormat;

      // Use the ISO currency symbol instead of the native currency symbol.
      nfi.CurrencySymbol =  (new RegionInfo(enUS.Name)).ISOCurrencySymbol;
      // Change the positive currency pattern to <code><space><value>.
      nfi.CurrencyPositivePattern = 2;
      // Change the negative currency pattern to <code><space><sign><value>.     
      nfi.CurrencyNegativePattern = 12;
      
      // Produce the result strings by calling ToString.
      Decimal[] values = { 1065.23m, 19.89m, -.03m, -175902.32m };
      foreach (var value in values)
         Console.WriteLine(value.ToString("C", enUS));

      Console.WriteLine();
      
      // Produce the result strings by calling a composite formatting method.
      foreach (var value in values)
         Console.WriteLine(String.Format(enUS, "{0:C}", value));      
   }
}
// The example displays the following output:
//       USD 1,065.23
//       USD 19.89
//       USD -0.03
//       USD -175,902.32
//       
//       USD 1,065.23
//       USD 19.89
//       USD -0.03
//       USD -175,902.32
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Retrieve a writable NumberFormatInfo object.
      Dim enUS As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
      Dim nfi As NumberFormatInfo = enUS.NumberFormat

      ' Use the ISO currency symbol instead of the native currency symbol.
      nfi.CurrencySymbol =  (New RegionInfo(enUS.Name)).ISOCurrencySymbol
      ' Change the positive currency pattern to <code><space><value>.
      nfi.CurrencyPositivePattern = 2
      ' Change the negative currency pattern to <code><space><sign><value>.     
      nfi.CurrencyNegativePattern = 12
      
      ' Produce the result strings by calling ToString.
      Dim values() As Decimal = { 1065.23d, 19.89d, -.03d, -175902.32d }
      For Each value In values
         Console.WriteLine(value.ToString("C", enUS))
      Next      
      Console.WriteLine()
      
      ' Produce the result strings by calling a composite formatting method.
      For Each value In values
         Console.WriteLine(String.Format(enUS, "{0:C}", value))      
      Next
   End Sub
End Module
' The example displays the following output:
'       USD 1,065.23
'       USD 19.89
'       USD -0.03
'       USD -175,902.32
'       
'       USD 1,065.23
'       USD 19.89
'       USD -0.03
'       USD -175,902.32

Formattare un numero di identificazione nazionaleFormatting a national identification number

Tutti i numeri di identificazione nazionale costituiti esclusivamente da cifre e pertanto possono essere facilmente formattati modificando le proprietà di un NumberFormatInfo oggetto.Many national identification numbers consist exclusively of digits and so can easily be formatted by modifying the properties of a NumberFormatInfo object. Ad esempio, un numero di previdenza sociale negli Stati Uniti è costituita da 9 cifre disposti come segue: XXX-XX-XXXX.For example, a social security number in the United States consists of 9 digits arranged as follows: XXX-XX-XXXX. Nell'esempio seguente si presuppone che vengono archiviati numeri di previdenza sociale come numero intero, i valori e li formatta in modo appropriato.The following example assumes that social security numbers are stored as integer values and formats them appropriately.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      // Instantiate a read-only NumberFormatInfo object.
      CultureInfo enUS = CultureInfo.CreateSpecificCulture("en-US");
      NumberFormatInfo nfi = enUS.NumberFormat;

      // Modify the relevant properties.
      nfi.NumberGroupSeparator = "-";
      nfi.NumberGroupSizes = new int[] { 3, 2, 4};
      nfi.NumberDecimalDigits = 0;
      
      int[] ids = { 111223333, 999776666 };
      
      // Produce the result string by calling ToString.
      foreach (var id in ids)
         Console.WriteLine(id.ToString("N", enUS));

      Console.WriteLine();
      
      // Produce the result string using composite formatting.
      foreach (var id in ids)
         Console.WriteLine(String.Format(enUS, "{0:N}", id));
   }
}
// The example displays the following output:
//       1112-23-333
//       9997-76-666
//       
//       1112-23-333
//       9997-76-666
Imports System.Globalization

Module Example
   Public Sub Main()
      ' Instantiate a read-only NumberFormatInfo object.
      Dim enUS As CultureInfo = CultureInfo.CreateSpecificCulture("en-US")
      Dim nfi As NumberFormatInfo = enUS.NumberFormat

      ' Modify the relevant properties.
      nfi.NumberGroupSeparator = "-"
      nfi.NumberGroupSizes = { 3, 2, 4}
      nfi.NumberDecimalDigits = 0
      
      Dim ids() As Integer = { 111223333, 999776666 }
      
      ' Produce the result string by calling ToString.
      For Each id In ids
         Console.WriteLine(id.ToString("N", enUS))
      Next 
      Console.WriteLine()
      
      ' Produce the result string using composite formatting.
      For Each id In ids
         Console.WriteLine(String.Format(enUS, "{0:N}", id))
      Next
   End Sub
End Module
' The example displays the following output:
'       1112-23-333
'       9997-76-666
'       
'       1112-23-333
'       9997-76-666

Analisi di stringhe numericheParsing numeric strings

L'analisi consente di convertire la rappresentazione di stringa di un numero a un numero.Parsing involves converting the string representation of a number to a number. Ogni tipo numerico in .NET Framework include due metodi di analisi in Overload: Parse e TryParse.Each numeric type in the .NET Framework includes two overloaded parsing methods: Parse and TryParse. Il Parse metodo converte una stringa in un numero e genera un'eccezione se la conversione non riesce.The Parse method converts a string to a number and throws an exception if the conversion fails. Il TryParse metodo converte una stringa in un numero, assegna il numero per un out argomento e restituisce un Boolean valore che indica se la conversione è riuscita.The TryParse method converts a string to a number, assigns the number to an out argument, and returns a Boolean value that indicates whether the conversion succeeded.

Usano i metodi di analisi in modo implicito o esplicito un NumberStyles valore di enumerazione per determinare quali elementi di stile (ad esempio, i separatori di gruppi, un separatore decimale o un simbolo di valuta) possono essere presenti in una stringa se l'operazione di analisi abbia esito positivo.The parsing methods implicitly or explicitly use a NumberStyles enumeration value to determine what style elements (such as group separators, a decimal separator, or a currency symbol) can be present in a string if the parsing operation is to succeed. Se un NumberStyles valore non viene specificato nella chiamata al metodo, il valore predefinito è una NumberStyles valore che includa le Float e AllowThousands flag che specifica che la stringa analizzata può includere i simboli di gruppo, un separatore decimale, un segno negativo, e gli spazi vuoti, o può essere la rappresentazione di stringa di un numero in notazione esponenziale.If a NumberStyles value is not provided in the method call, the default is a NumberStyles value that includes the Float and AllowThousands flags, which specifies that the parsed string can include group symbols, a decimal separator, a negative sign, and white-space characters, or it can be the string representation of a number in exponential notation.

Usano i metodi di analisi anche in modo implicito o esplicito un NumberFormatInfo oggetto che definisce i simboli specifici e pattern che può verificarsi nella stringa da analizzare.The parsing methods also implicitly or explicitly use a NumberFormatInfo object that defines the specific symbols and patterns that can occur in the string to be parsed. Se un NumberFormatInfo oggetto non è specificato, il valore predefinito è il NumberFormatInfo per impostazioni cultura del thread corrente.If a NumberFormatInfo object is not provided, the default is the NumberFormatInfo for the current thread culture. Per ulteriori informazioni sull'analisi, vedere i singoli metodi di analisi, ad esempio Int16.Parse(String), Int32.Parse(String, NumberStyles), Int64.Parse(String, IFormatProvider), Decimal.Parse(String, NumberStyles, IFormatProvider), Double.TryParse(String, Double), e BigInteger.TryParse(String, NumberStyles, IFormatProvider, BigInteger).For more information about parsing, see the individual parsing methods, such as Int16.Parse(String), Int32.Parse(String, NumberStyles), Int64.Parse(String, IFormatProvider), Decimal.Parse(String, NumberStyles, IFormatProvider), Double.TryParse(String, Double), and BigInteger.TryParse(String, NumberStyles, IFormatProvider, BigInteger).

L'esempio seguente illustra la natura di distinzione delle impostazioni cultura dell'analisi di stringhe.The following example illustrates the culture-sensitive nature of parsing strings. Tenta di analizzare una stringa che includono migliaia separatori usando le convenzioni del en-US, fr-FR e impostazioni cultura invarianti.It tries to parse a string that include thousands separators by using the conventions of the en-US, fr-FR, and invariant cultures. Una stringa che include la virgola come separatore di gruppi e il punto come separatore decimale ha esito negativo analizzare le impostazioni cultura fr-FR e una stringa con una virgola come separatore decimale e white space come separatore dei gruppi non può essere analizzata nel en-US e impostazioni cultura invarianti.A string that includes the comma as a group separator and the period as a decimal separator fails to parse in the fr-FR culture, and a string with white space as a group separator and a comma as a decimal separator fails to parse in the en-US and invariant cultures.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      String[] values = { "1,034,562.91", "9 532 978,07" };
      String[] cultureNames = { "en-US", "fr-FR", "" };
      
      foreach (var value in values) {
         foreach (var cultureName in cultureNames) {
            CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName);
            String name = culture.Name == "" ? "Invariant" : culture.Name;
            try {
               Decimal amount = Decimal.Parse(value, culture);
               Console.WriteLine("'{0}' --> {1} ({2})", value, amount, name);
            }
            catch (FormatException) {
               Console.WriteLine("'{0}': FormatException ({1})",
                                 value, name);
            }   
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       '1,034,562.91' --> 1034562.91 (en-US)
//       '1,034,562.91': FormatException (fr-FR)
//       '1,034,562.91' --> 1034562.91 (Invariant)
//       
//       '9 532 978,07': FormatException (en-US)
//       '9 532 978,07' --> 9532978.07 (fr-FR)
//       '9 532 978,07': FormatException (Invariant)
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As String = { "1,034,562.91", "9 532 978,07" }
      Dim cultureNames() As String = { "en-US", "fr-FR", "" }
      
      For Each value In values
         For Each cultureName In cultureNames
            Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture(cultureName)
            Dim name As String = If(culture.Name = "", "Invariant", culture.Name)
            Try
               Dim amount As Decimal = Decimal.Parse(value, culture)
               Console.WriteLine("'{0}' --> {1} ({2})", value, amount, name)
            Catch e As FormatException
               Console.WriteLine("'{0}': FormatException ({1})",
                                 value, name)
            End Try   
         Next
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'       '1,034,562.91' --> 1034562.91 (en-US)
'       '1,034,562.91': FormatException (fr-FR)
'       '1,034,562.91' --> 1034562.91 (Invariant)
'       
'       '9 532 978,07': FormatException (en-US)
'       '9 532 978,07' --> 9532978.07 (fr-FR)
'       '9 532 978,07': FormatException (Invariant)

L'analisi in genere si verifica in due contesti:Parsing generally occurs in two contexts:

  • Come un'operazione che è in grado di convertire l'input dell'utente in un valore numerico.As an operation that is designed to convert user input into a numeric value.

  • Come un'operazione che è stata progettata per eseguire il round trip un valore numerico. vale a dire, per deserializzare un valore numerico che in precedenza è stato serializzato come stringa.As an operation that is designed to round-trip a numeric value; that is, to deserialize a numeric value that was previously serialized as a string.

Le sezioni seguenti illustrano queste due operazioni in modo più dettagliato.The following sections discuss these two operations in greater detail.

Analisi di stringhe utenteParsing user strings

Quando si siano analizzando numerico stringhe immesse dall'utente, è consigliabile creare sempre un NumberFormatInfo che riflette le impostazioni relative alla lingua dell'utente.When you are parsing numeric strings input by the user, you should always instantiate a NumberFormatInfo object that reflects the user's cultural settings. Per informazioni su come creare un'istanza di un NumberFormatInfo oggetto che rifletta le personalizzazioni dell'utente, vedere la NumberFormatInfo e dynamic data sezione.For information about how to instantiate a NumberFormatInfo object that reflects user customizations, see the NumberFormatInfo and dynamic data section.

Nell'esempio seguente viene illustrata la differenza tra un'operazione di analisi che riflette le impostazioni relative alle impostazioni cultura utente e una che non sono presenti.The following example illustrates the difference between a parsing operation that reflects user cultural settings and one that does not. In questo caso, la lingua del sistema predefinito è en-US, ma l'utente ha definito "," come separatore dei decimali e "." come separatore di gruppo nel Pannello di controllo paese e lingua.In this case, the default system culture is en-US, but the user has defined "," as the decimal symbol and "." as the group separator in Control Panel, Region and Language. In genere, questi simboli sono invertiti nelle impostazioni cultura en-US predefinita.Ordinarily, these symbols are reversed in the default en-US culture. Quando l'utente immette una stringa che riflette le impostazioni utente e la stringa viene analizzata da un NumberFormatInfo che riflette le impostazioni dell'utente (sostituzioni), l'operazione di analisi restituisce un risultato corretto.When the user enters a string that reflects user settings, and the string is parsed by a NumberFormatInfo object that also reflects user settings (overrides), the parsing operation returns a correct result. Tuttavia, quando la stringa viene analizzata da un NumberFormatInfo che riflette le impostazioni cultura en-US standard, è il simbolo di virgole per un separatore di gruppi di errori e restituisce un risultato errato.However, when the string is parsed by a NumberFormatInfo object that reflects standard en-US cultural settings, it mistakes the comma symbol for a group separator and returns an incorrect result.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo stdCulture = CultureInfo.GetCultureInfo("en-US");
      CultureInfo custCulture = CultureInfo.CreateSpecificCulture("en-US"); 
            
      String value = "310,16";
      try {
         Console.WriteLine("{0} culture reflects user overrides: {1}", 
                           stdCulture.Name, stdCulture.UseUserOverride);
         Decimal amount = Decimal.Parse(value, stdCulture);
         Console.WriteLine("'{0}' --> {1}", value, amount.ToString(CultureInfo.InvariantCulture));                                                                                        
      }
      catch (FormatException) {
         Console.WriteLine("Unable to parse '{0}'", value);
      }    
      Console.WriteLine();
                                            
      try {
         Console.WriteLine("{0} culture reflects user overrides: {1}", 
                           custCulture.Name, custCulture.UseUserOverride);
         Decimal amount = Decimal.Parse(value, custCulture);
         Console.WriteLine("'{0}' --> {1}", value, amount.ToString(CultureInfo.InvariantCulture));                                                                                        
      }
      catch (FormatException) {
         Console.WriteLine("Unable to parse '{0}'", value);
      }   
   }
}
// The example displays the following output:
//       en-US culture reflects user overrides: False
//       '310,16' --> 31016
//       
//       en-US culture reflects user overrides: True
//       '310,16' --> 310.16
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim stdCulture As CultureInfo = CultureInfo.GetCultureInfo("en-US")
      Dim custCulture As CultureInfo = CultureInfo.CreateSpecificCulture("en-US") 
            
      Dim value As String = "310,16"
      Try
         Console.WriteLine("{0} culture reflects user overrides: {1}", 
                           stdCulture.Name, stdCulture.UseUserOverride)
         Dim amount As Decimal = Decimal.Parse(value, stdCulture)
         Console.WriteLine("'{0}' --> {1}", value, amount.ToString(CultureInfo.InvariantCulture))                                                                                        
      Catch e As FormatException
         Console.WriteLine("Unable to parse '{0}'", value)
      End Try   
      Console.WriteLine()
                                            
      Try
         Console.WriteLine("{0} culture reflects user overrides: {1}", 
                           custCulture.Name, custCulture.UseUserOverride)
         Dim amount As Decimal = Decimal.Parse(value, custCulture)
         Console.WriteLine("'{0}' --> {1}", value, amount.ToString(CultureInfo.InvariantCulture))                                                                                        
      Catch e As FormatException
         Console.WriteLine("Unable to parse '{0}'", value)
      End Try   
   End Sub
End Module
' The example displays the following output:
'       en-US culture reflects user overrides: False
'       '310,16' --> 31016
'       
'       en-US culture reflects user overrides: True
'       '310,16' --> 310.16

La serializzazione e deserializzazione di dati numericiSerializing and deserializing numeric data

Quando i dati numerici viene serializzati in formato stringa in un secondo momento deserializzati e analizzati, le stringhe devono essere generate e analizzate usando le convenzioni delle impostazioni cultura invarianti.When numeric data is serialized in string format and later deserialized and parsed, the strings should be generated and parsed by using the conventions of the invariant culture. Le operazioni di formattazione e analisi non dovrebbero mai riflettono le convenzioni delle impostazioni cultura specifiche.The formatting and parsing operations should never reflect the conventions of a specific culture. Se si usano le impostazioni cultura, la portabilità dei dati è rigorosamente limitata; può essere deserializzato solo su un thread le cui impostazioni cultura sono identiche a quelle del thread in cui è stato serializzato.If culture-specific settings are used, the portability of the data is strictly limited; it can be successfully deserialized only on a thread whose culture-specific settings are identical to those of the thread on which it was serialized. In alcuni casi, ciò significa che i dati non possono anche essere deserializzati correttamente nello stesso sistema in cui è stato serializzato.In some cases, this means that the data cannot even be successfully deserialized on the same system on which it was serialized.

Nell'esempio seguente viene illustrato cosa può accadere quando questo principio viene violato.The following example illustrates what can happen when this principle is violated. Valori a virgola mobile in una matrice vengono convertiti in stringhe se il thread corrente Usa le impostazioni cultura delle impostazioni cultura en-US.Floating-point values in an array are converted to strings when the current thread uses the culture-specific settings of the en-US culture. I dati viene quindi analizzati da un thread che usa le impostazioni cultura delle impostazioni cultura en-GB.The data is then parsed by a thread that uses the culture-specific settings of the en-GB culture. In questo caso, benché ogni operazione di analisi ha esito positivo, i dati di non eseguire il round trip correttamente e si verifica un danneggiamento dei dati.In this case, although each parsing operation succeeds, the data does not round-trip successfully and data corruption occurs. In altri casi, un'operazione di analisi potrebbe non riuscire e un FormatException potrebbero essere generate eccezioni.In other cases, a parsing operation could fail and a FormatException exception could be thrown.

using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
using System.Threading;

public class Example
{
   public static void Main()
   {
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-US");
      PersistData();
      
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-GB");
      RestoreData();
   }

   private static void PersistData()
   {
      // Define an array of floating-point values.
      Double[] values = { 160325.972, 8631.16, 1.304e5, 98017554.385, 
                          8.5938287084321676e94 };
      Console.WriteLine("Original values: ");
      foreach (var value in values) 
         Console.WriteLine(value.ToString("R", CultureInfo.InvariantCulture));
         
      // Serialize an array of doubles to a file 
      StreamWriter sw = new StreamWriter(@".\NumericData.bin");
      for (int ctr = 0; ctr < values.Length; ctr++) {
         sw.Write(values[ctr].ToString("R"));
         if (ctr < values.Length - 1) sw.Write("|");
      }
      sw.Close();
      Console.WriteLine();
   }
   
   private static void RestoreData()
   {   
      // Deserialize the data
      StreamReader sr = new StreamReader(@".\NumericData.bin");
      String data = sr.ReadToEnd();
      sr.Close();
      
      String[] stringValues = data.Split('|');
      List<Double> newValueList = new List<Double>();
      
      foreach (var stringValue in stringValues) {
         try {
            newValueList.Add(Double.Parse(stringValue));
         }
         catch (FormatException) {
            newValueList.Add(Double.NaN);
         }   
      }                                   

      Console.WriteLine("Restored values:");
      foreach (var newValue in newValueList) 
         Console.WriteLine(newValue.ToString("R", NumberFormatInfo.InvariantInfo));
   }
}
// The example displays the following output:
//       Original values:
//       160325.972
//       8631.16
//       130400
//       98017554.385
//       8.5938287084321671E+94
//       
//       Restored values:
//       160325972
//       863116
//       130400
//       98017554385
//       8.5938287084321666E+110
Imports System.Collections.Generic
Imports System.Globalization
Imports System.IO
Imports System.Threading

Module Example
   Public Sub Main()
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-US")
      PersistData()
      
      Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("en-GB")
      RestoreData()
   End Sub
   
   Private Sub PersistData()
      ' Define an array of floating-point values.
      Dim values() As Double = { 160325.972, 8631.16, 1.304e5, 98017554.385, 
                                 8.5938287084321676e94 }
      Console.WriteLine("Original values: ")
      For Each value In values
         Console.WriteLine(value.ToString("R", CultureInfo.InvariantCulture))
      Next
         
      ' Serialize an array of doubles to a file 
      Dim sw As New StreamWriter(".\NumericData.bin")
      For ctr As Integer = 0 To values.Length - 1
         sw.Write(values(ctr).ToString("R"))
         If ctr < values.Length - 1 Then sw.Write("|")
      Next
      sw.Close()
      Console.WriteLine()
   End Sub
   
   Private Sub RestoreData()   
      ' Deserialize the data
      Dim sr AS New StreamReader(".\NumericData.bin")
      Dim data As String = sr.ReadToEnd()
      sr.Close()
      
      Dim stringValues() As String = data.Split("|"c)
      Dim newValueList As New List(Of Double)
      
      For Each stringValue In stringValues
         Try
            newValueList.Add(Double.Parse(stringValue))
         Catch e As FormatException
            newValueList.Add(Double.NaN)
         End Try   
      Next                                   

      Console.WriteLine("Restored values:")
      For Each newValue In newValueList
         Console.WriteLine(newValue.ToString("R", NumberFormatInfo.InvariantInfo))
      Next
   End Sub
End Module
' The example displays the following output:
'       Original values:
'       160325.972
'       8631.16
'       130400
'       98017554.385
'       8.5938287084321671E+94
'       
'       Restored values:
'       160325972
'       863116
'       130400
'       98017554385
'       8.5938287084321666E+110

Costruttori

NumberFormatInfo() NumberFormatInfo() NumberFormatInfo() NumberFormatInfo()

Inizializza una nuova istanza scrivibile della classe NumberFormatInfo che è indipendente dalle impostazioni cultura (invariante).Initializes a new writable instance of the NumberFormatInfo class that is culture-independent (invariant).

Proprietà

CurrencyDecimalDigits CurrencyDecimalDigits CurrencyDecimalDigits CurrencyDecimalDigits

Ottiene o imposta il numero di posizioni decimali da usare nei valori di valuta.Gets or sets the number of decimal places to use in currency values.

CurrencyDecimalSeparator CurrencyDecimalSeparator CurrencyDecimalSeparator CurrencyDecimalSeparator

Ottiene o imposta la stringa da usare come separatore decimale nei valori di valuta.Gets or sets the string to use as the decimal separator in currency values.

CurrencyGroupSeparator CurrencyGroupSeparator CurrencyGroupSeparator CurrencyGroupSeparator

Ottiene o imposta la stringa di separazione dei gruppi di cifre che si trovano a sinistra del separatore decimale nei valori di valuta.Gets or sets the string that separates groups of digits to the left of the decimal in currency values.

CurrencyGroupSizes CurrencyGroupSizes CurrencyGroupSizes CurrencyGroupSizes

Ottiene o imposta il numero di cifre in ciascun gruppo che si trova a sinistra del separatore decimale nei valori di valuta.Gets or sets the number of digits in each group to the left of the decimal in currency values.

CurrencyNegativePattern CurrencyNegativePattern CurrencyNegativePattern CurrencyNegativePattern

Ottiene o imposta il modello di formato per i valori di valuta negativi.Gets or sets the format pattern for negative currency values.

CurrencyPositivePattern CurrencyPositivePattern CurrencyPositivePattern CurrencyPositivePattern

Ottiene o imposta il modello di formato per i valori di valuta positivi.Gets or sets the format pattern for positive currency values.

CurrencySymbol CurrencySymbol CurrencySymbol CurrencySymbol

Ottiene o imposta la stringa da usare come simbolo di valuta.Gets or sets the string to use as the currency symbol.

CurrentInfo CurrentInfo CurrentInfo CurrentInfo

Ottiene un oggetto NumberFormatInfo di sola lettura che formatta i valori in base alle impostazioni cultura correnti.Gets a read-only NumberFormatInfo that formats values based on the current culture.

DigitSubstitution DigitSubstitution DigitSubstitution DigitSubstitution

Ottiene o imposta un valore che specifica come viene visualizzata la forma di una cifra dall'interfaccia utente grafica.Gets or sets a value that specifies how the graphical user interface displays the shape of a digit.

InvariantInfo InvariantInfo InvariantInfo InvariantInfo

Ottiene un oggetto NumberFormatInfo di sola lettura indipendente dalle impostazioni cultura (invariante).Gets a read-only NumberFormatInfo object that is culture-independent (invariant).

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Ottiene un valore che indica se l'oggetto NumberFormatInfo è di sola lettura.Gets a value that indicates whether this NumberFormatInfo object is read-only.

NaNSymbol NaNSymbol NaNSymbol NaNSymbol

Ottiene o imposta la stringa che rappresenta il valore IEEE NaN (Not a Number).Gets or sets the string that represents the IEEE NaN (not a number) value.

NativeDigits NativeDigits NativeDigits NativeDigits

Ottiene o imposta una matrice di stringhe di cifre native equivalenti ai numeri europei da 0 a 9.Gets or sets a string array of native digits equivalent to the Western digits 0 through 9.

NegativeInfinitySymbol NegativeInfinitySymbol NegativeInfinitySymbol NegativeInfinitySymbol

Ottiene o imposta la stringa che rappresenta il valore di infinito negativo.Gets or sets the string that represents negative infinity.

NegativeSign NegativeSign NegativeSign NegativeSign

Ottiene o imposta la stringa che indica che il numero associato è negativo.Gets or sets the string that denotes that the associated number is negative.

NumberDecimalDigits NumberDecimalDigits NumberDecimalDigits NumberDecimalDigits

Ottiene o imposta il numero di posizioni decimali da usare nei valori numerici.Gets or sets the number of decimal places to use in numeric values.

NumberDecimalSeparator NumberDecimalSeparator NumberDecimalSeparator NumberDecimalSeparator

Ottiene o imposta la stringa da usare come separatore decimale nei valori numerici.Gets or sets the string to use as the decimal separator in numeric values.

NumberGroupSeparator NumberGroupSeparator NumberGroupSeparator NumberGroupSeparator

Ottiene o imposta la stringa di separazione dei gruppi di cifre che si trovano a sinistra del separatore decimale nei valori numerici.Gets or sets the string that separates groups of digits to the left of the decimal in numeric values.

NumberGroupSizes NumberGroupSizes NumberGroupSizes NumberGroupSizes

Ottiene o imposta il numero di cifre in ciascun gruppo che si trova a sinistra del separatore decimale nei valori numerici.Gets or sets the number of digits in each group to the left of the decimal in numeric values.

NumberNegativePattern NumberNegativePattern NumberNegativePattern NumberNegativePattern

Ottiene o imposta il modello di formato per i valori numerici negativi.Gets or sets the format pattern for negative numeric values.

PercentDecimalDigits PercentDecimalDigits PercentDecimalDigits PercentDecimalDigits

Ottiene o imposta il numero di posizioni decimali da usare nei valori percentuali.Gets or sets the number of decimal places to use in percent values.

PercentDecimalSeparator PercentDecimalSeparator PercentDecimalSeparator PercentDecimalSeparator

Ottiene o imposta la stringa da usare come separatore decimale nei valori percentuali.Gets or sets the string to use as the decimal separator in percent values.

PercentGroupSeparator PercentGroupSeparator PercentGroupSeparator PercentGroupSeparator

Ottiene o imposta la stringa di separazione dei gruppi di cifre che si trovano a sinistra del separatore decimale nei valori percentuali.Gets or sets the string that separates groups of digits to the left of the decimal in percent values.

PercentGroupSizes PercentGroupSizes PercentGroupSizes PercentGroupSizes

Ottiene o imposta il numero di cifre in ciascun gruppo che si trova a sinistra del separatore decimale nei valori percentuali.Gets or sets the number of digits in each group to the left of the decimal in percent values.

PercentNegativePattern PercentNegativePattern PercentNegativePattern PercentNegativePattern

Ottiene o imposta il modello di formato per i valori percentuali negativi.Gets or sets the format pattern for negative percent values.

PercentPositivePattern PercentPositivePattern PercentPositivePattern PercentPositivePattern

Ottiene o imposta il modello di formato per i valori percentuali positivi.Gets or sets the format pattern for positive percent values.

PercentSymbol PercentSymbol PercentSymbol PercentSymbol

Ottiene o imposta la stringa da usare come simbolo di percentuale.Gets or sets the string to use as the percent symbol.

PerMilleSymbol PerMilleSymbol PerMilleSymbol PerMilleSymbol

Ottiene o imposta la stringa da usare come simbolo di per mille.Gets or sets the string to use as the per mille symbol.

PositiveInfinitySymbol PositiveInfinitySymbol PositiveInfinitySymbol PositiveInfinitySymbol

Ottiene o imposta la stringa che rappresenta il valore di infinito positivo.Gets or sets the string that represents positive infinity.

PositiveSign PositiveSign PositiveSign PositiveSign

Ottiene o imposta la stringa che indica che il numero associato è positivo.Gets or sets the string that denotes that the associated number is positive.

Metodi

Clone() Clone() Clone() Clone()

Crea una copia superficiale dell'oggetto NumberFormatInfo.Creates a shallow copy of the NumberFormatInfo object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetFormat(Type) GetFormat(Type) GetFormat(Type) GetFormat(Type)

Ottiene un oggetto del tipo specificato che fornisce un servizio di formattazione dei numeri.Gets an object of the specified type that provides a number formatting service.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetInstance(IFormatProvider) GetInstance(IFormatProvider) GetInstance(IFormatProvider) GetInstance(IFormatProvider)

Ottiene l'oggetto NumberFormatInfo associato all'oggetto IFormatProvider specificato.Gets the NumberFormatInfo associated with the specified IFormatProvider.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ReadOnly(NumberFormatInfo) ReadOnly(NumberFormatInfo) ReadOnly(NumberFormatInfo) ReadOnly(NumberFormatInfo)

Restituisce un wrapper NumberFormatInfo di sola lettura.Returns a read-only NumberFormatInfo wrapper.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche