NumberFormatInfo NumberFormatInfo NumberFormatInfo NumberFormatInfo Class

Definicja

Zawiera informacje specyficzne dla kultury do formatowania i analizowania wartości numerycznych.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
Dziedziczenie
NumberFormatInfoNumberFormatInfoNumberFormatInfoNumberFormatInfo
Atrybuty
Implementuje

Przykłady

Poniższy przykład pokazuje, jak pobrać NumberFormatInfo obiekt dla odpowiadającego CultureInfo obiektu i użyć pobranego obiektu do wykonywania zapytań dotyczących formatowania liczb dla danej kultury.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 '$'

Uwagi

NumberFormatInfo Klasa zawiera informacje specyficzne dla kultury, które są używane podczas formatowania i analizowania wartości numerycznych.The NumberFormatInfo class contains culture-specific information that is used when you format and parse numeric values. Te informacje obejmują symbol waluty, symbol dziesiętny, symbol separatora grupy oraz symbole dla znaków dodatnich i ujemnych.This information includes the currency symbol, the decimal symbol, the group separator symbol, and the symbols for positive and negative signs.

Utworzenie wystąpienia obiektu NumberFormatInfoInstantiating a NumberFormatInfo object

Można utworzyć wystąpienie NumberFormatInfo obiektu, który reprezentuje konwencje formatowania bieżącej kultury, niezmienną kulturę, określoną kulturę lub neutralną kulturę.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.

Utworzenie wystąpienia obiektu NumberFormatInfo dla bieżącej kulturyInstantiating a NumberFormatInfo object for the current culture

Można utworzyć wystąpienie NumberFormatInfo obiektu dla bieżącej kultury wątku w dowolny z następujących sposobów.You can instantiate a NumberFormatInfo object for the current thread culture in any of the following ways. W każdym przypadku zwracany NumberFormatInfo obiekt jest tylko do odczytu.In each case, the returned NumberFormatInfo object is read-only.

W poniższym przykładzie są używane trzy sposoby tworzenia NumberFormatInfo obiektów, które reprezentują konwencje formatowania bieżącej kultury.The following example uses these three ways to create NumberFormatInfo objects that represent the formatting conventions of the current culture. Pobiera również wartość IsReadOnly właściwości, aby zilustrować, że każdy obiekt jest tylko do odczytu.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

Można utworzyć zapisywalny NumberFormatInfo obiekt, który reprezentuje konwencje bieżącej kultury wątku w dowolny z następujących sposobów:You can create a writable NumberFormatInfo object that represents the conventions of the current thread culture in any of the following ways:

Poniższy przykład ilustruje te dwa sposoby tworzenia wystąpienia NumberFormatInfo obiektu i wyświetla wartość jego IsReadOnly właściwości, aby zilustrować, że obiekt nie jest tylko do odczytu.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

Należy pamiętać, że system operacyjny Windows zezwala użytkownikowi na przesłonięcie niektórych NumberFormatInfo wartości właściwości używanych w operacjach formatowania liczbowego i analizowania w obszarze region i element języka w panelu sterowania.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. Na przykład użytkownik, którego kultura jest w języku angielskim (Stany Zjednoczone), może wyświetlić wartości walutowe jako 1,1 USD zamiast domyślnie $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. NumberFormatInfo Obiekty pobrane w opisanych wcześniej metodach odzwierciedlają te zastąpienia użytkownika.The NumberFormatInfo objects retrieved in the ways discussed previously all reflect these user overrides. Jeśli jest to niepożądane, można NumberFormatInfo utworzyć obiekt, który nie odzwierciedla zastąpień użytkownika (i ma również odczyt/zapis, a nie tylko do odczytu) przez CultureInfo.CultureInfo(String, Boolean) wywołanie konstruktora i false dostarczenie wartości dla useUserOverride argument.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. Poniższy przykład przedstawia ilustrację dla systemu, którego bieżącą kulturą jest angielski (Stany Zjednoczone) i dla którego symbol waluty został zmieniony z wartości domyślnej $ na 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: $

true CultureInfo.DateTimeFormat CultureInfo.NumberFormatJeśli właściwość jest ustawiona na, właściwości, i CultureInfo.TextInfo są również pobierane z ustawień użytkownika. CultureInfo.UseUserOverrideIf the CultureInfo.UseUserOverride property is set to true, the properties CultureInfo.DateTimeFormat, CultureInfo.NumberFormat, and CultureInfo.TextInfo are also retrieved from the user settings. Jeśli ustawienia użytkownika są niezgodne z kulturą skojarzoną z CultureInfo obiektem (na przykład jeśli wybrany kalendarz nie jest jednym z kalendarzy wymienionych OptionalCalendars przez właściwość), wyniki metod i wartości właściwości są definicji.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.

Utworzenie wystąpienia obiektu NumberFormatInfo dla niezmiennej kulturyInstantiating a NumberFormatInfo object for the invariant culture

Niezmienna kultura reprezentuje kulturę, w której nie uwzględnia się ustawień kulturowych.The invariant culture represents a culture that is culture-insensitive. Jest on oparty na języku angielskim, ale nie w żadnym konkretnym kraju/regionie mówiącym w języku angielskim.It is based on the English language but not on any specific English-speaking country/region. Chociaż dane określonych kultur mogą być dynamiczne i mogą ulec zmianie, aby odzwierciedlały nowe konwencje kulturalne lub Preferencje użytkownika, dane niezmiennej kultury nie zmieniają się.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. NumberFormatInfo Obiekt, który reprezentuje konwencje formatowania kultury niezmiennej, może służyć do formatowania operacji, w których ciągi wynikowe nie powinny się różnić w zależności od kultury.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.

Można utworzyć wystąpienie NumberFormatInfo obiektu, który reprezentuje konwencje formatowania niezmiennej kultury w następujący sposób:You can instantiate a NumberFormatInfo object that represents the formatting conventions of the invariant culture in the following ways:

Poniższy przykład używa każdej z tych metod, aby utworzyć wystąpienie NumberFormatInfo obiektu, który reprezentuje niezmienną kulturę.The following example uses each of these methods to instantiate a NumberFormatInfo object that represents the invariant culture. Następnie wskazuje, czy obiekt jest tylko do odczytu,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

Utworzenie wystąpienia obiektu NumberFormatInfo dla określonej kulturyInstantiating a NumberFormatInfo object for a specific culture

Określona kultura reprezentuje język, który jest mówiony w określonym kraju/regionie.A specific culture represents a language that is spoken in a particular country/region. Na przykład, en-US to określona kultura, która reprezentuje język angielski, który jest mówiony w Stany Zjednoczone, a en-CA to określona kultura, która reprezentuje język angielski w Kanadzie.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. Można utworzyć wystąpienie NumberFormatInfo obiektu, który reprezentuje konwencje formatowania określonej kultury w następujący sposób:You can instantiate a NumberFormatInfo object that represents the formatting conventions of a specific culture in the following ways:

W poniższym przykładzie są używane te cztery sposoby, aby NumberFormatInfo utworzyć obiekt, który odzwierciedla konwencje formatowania kultury indonezyjskiej (Indonezja).The following example uses these four ways to create a NumberFormatInfo object that reflects the formatting conventions of the Indonesian (Indonesia) culture. Wskazuje również, czy każdy obiekt jest tylko do odczytu.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

Utworzenie wystąpienia obiektu NumberFormatInfo dla kultury neutralnejInstantiating a NumberFormatInfo object for a neutral culture

Neutralna kultura reprezentuje kulturę lub język, który jest niezależny od kraju/regionu.A neutral culture represents a culture or language that is independent of a country/region. Zwykle jest elementem nadrzędnym jednej lub kilku określonych kultur.It is typically the parent of one or more specific cultures. Na przykład fr jest neutralną kulturą dla języka francuskiego i elementem nadrzędnym kultury fr-FR.For example, fr is a neutral culture for the French language and the parent of the fr-FR culture. Tworzysz obiekt, który reprezentuje konwencje formatowania kultury neutralnej w taki sam sposób, jak NumberFormatInfo utworzysz obiekt, który reprezentuje konwencje formatowania określonej kultury. NumberFormatInfoYou 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.

Uwaga

W programie NumberFormatInfo NotSupportedException i starszych wersjach próba pobrania obiektu, który odzwierciedla konwencje formatowania kultury neutralnej zgłasza wyjątek. Program .NET Framework 3,5.NET Framework 3.5In the Program .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.

Jednak ponieważ jest ona niezależna od określonego kraju/regionu, kultura neutralna nie ma informacji o formatowaniu specyficznych dla kultury.However, because it is independent of a specific country/region, a neutral culture lacks culture-specific formatting information. Zamiast wypełniania NumberFormatInfo obiektu za pomocą wartości ogólnych, .NET Framework NumberFormatInfo zwraca obiekt, który odzwierciedla konwencje formatowania określonej kultury, która jest elementem podrzędnym kultury neutralnej.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. Na przykład NumberFormatInfo obiekt neutralnej kultury jest odzwierciedla konwencje formatowania kultury en-us, NumberFormatInfo a obiekt kultury fr odzwierciedla konwencje formatowania kultury 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.

Można użyć kodu takiego jak następujące, aby określić, które konwencje formatowania określonych kultur reprezentują każdą neutralną kulturę.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.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 i dane dynamiczneNumberFormatInfo and dynamic data

Dane specyficzne dla kultury do formatowania wartości liczbowych dostarczonych przez NumberFormatInfo klasę są dynamiczne, podobnie jak dane kulturowe dostarczone CultureInfo przez klasę.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. Nie należy wprowadzać żadnych założeń dotyczących trwałości wartości dla NumberFormatInfo obiektów, które są skojarzone z konkretnymi CultureInfo obiektami.You should not make any assumptions about the stability of values for NumberFormatInfo objects that are associated with particular CultureInfo objects. Tylko dane dostarczone przez niezmienną kulturę i jej skojarzony NumberFormatInfo obiekt są stabilne.Only the data provided by the invariant culture and its associated NumberFormatInfo object is stable. Inne dane mogą ulec zmianie między sesjami aplikacji, a nawet w ramach jednej sesji, z następujących powodów:Other data can change between application sessions, or even within a single session, for the following reasons:

  • Aktualizacje systemu.System updates. Preferencje kulturowe, takie jak symbol waluty lub formaty walut, zmieniają się w miarę upływu czasu.Cultural preferences such as the currency symbol or currency formats change over time. W takim przypadku Windows Update obejmuje zmiany NumberFormatInfo wartości właściwości dla określonej kultury.When this happens, Windows Update includes changes to the NumberFormatInfo property value for a particular culture.

  • Kultury zamienne.Replacement cultures. CultureAndRegionInfoBuilder Klasa może służyć do zastępowania danych istniejącej kultury.The CultureAndRegionInfoBuilder class can be used to replace the data of an existing culture.

  • Kaskadowe zmiany wartości właściwości.Cascading changes to property values. Wiele właściwości związanych z kulturą może ulec zmianie w czasie wykonywania, co z kolei powoduje NumberFormatInfo zmianę danych.A number of culture-related properties can change at run time, which, in turn, causes NumberFormatInfo data to change. Na przykład bieżącą kulturę można zmienić programowo lub za pomocą akcji użytkownika.For example, the current culture can be changed either programmatically or through user action. W takim NumberFormatInfo przypadku obiekt zwrócony CurrentInfo przez właściwość zmieni się na obiekt skojarzony z bieżącą kulturą.When this happens, the NumberFormatInfo object returned by the CurrentInfo property changes to an object associated with the current culture.

  • Preferencje użytkownika.User preferences. Użytkownicy Twojej aplikacji mogą zastąpić niektóre wartości skojarzone z bieżącą kulturą systemu za pomocą opcji region i język w panelu sterowania.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. Na przykład użytkownicy mogą wybrać inny symbol waluty lub inny symbol separatora dziesiętnego.For example, users might choose a different currency symbol or a different decimal separator symbol. Jeśli właściwość jest ustawiona na true (wartość domyślna) NumberFormatInfo , właściwości obiektu są również pobierane z ustawień użytkownika. CultureInfo.UseUserOverrideIf the CultureInfo.UseUserOverride property is set to true (its default value), the properties of the NumberFormatInfo object are also retrieved from the user settings.

Począwszy od .NET Framework 2,0, wszystkie właściwości, które NumberFormatInfo można wypróbować obiektu są inicjowane podczas tworzenia obiektu.Starting with the .NET Framework 2.0, all user-overridable properties of a NumberFormatInfo object are initialized when the object is created. Nadal istnieje możliwość niespójności, ponieważ nie można utworzyć obiektu ani proces przesłaniania użytkownika jest niepodzielny, a odpowiednie wartości mogą ulec zmianie podczas tworzenia obiektu.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. Niespójności te powinny jednak być wyjątkowo rzadkie.However, these inconsistencies should be extremely rare.

Można kontrolować, czy zastąpienia użytkowników są odzwierciedlone NumberFormatInfo w obiektach, które reprezentują tę samą kulturę co bieżąca kultura wątku.You can control whether user overrides are reflected in NumberFormatInfo objects that represent the same culture as the current thread culture. Poniższa tabela zawiera listę sposobów, w których NumberFormatInfo można pobrać obiekt i wskazuje, czy obiekt wyniku odzwierciedla zastąpień użytkownika.The following table lists the ways in which a NumberFormatInfo object can be retrieved and indicates whether the resulting object reflects user overrides.

Źródło obiektu CultureInfo i NumberFormatInfoSource of CultureInfo and NumberFormatInfo object Odzwierciedla zastąpienia użytkownikaReflects user overrides
CultureInfo.CurrentCulture.NumberFormatwartośćCultureInfo.CurrentCulture.NumberFormat property TakYes
NumberFormatInfo.CurrentInfowartośćNumberFormatInfo.CurrentInfo property TakYes
CultureInfo.CreateSpecificCultureMethodCultureInfo.CreateSpecificCulture method TakYes
CultureInfo.GetCultureInfoMethodCultureInfo.GetCultureInfo method NieNo
CultureInfo(String)konstruktoraCultureInfo(String) constructor TakYes
CultureInfo.CultureInfo(String, Boolean)konstruktoraCultureInfo.CultureInfo(String, Boolean) constructor Zależy od wartości useUserOverride parametruDepends on value of useUserOverride parameter

O ile nie istnieje istotny powód, aby to zrobić, należy przestrzegać zastąpień użytkownika podczas korzystania NumberFormatInfo z obiektu w aplikacjach klienckich do formatowania i analizowania danych wejściowych użytkownika lub wyświetlania liczb.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. W przypadku aplikacji serwerowych lub aplikacji nienadzorowanych nie należy uwzględniać zastąpień użytkownika.For server applications or unattended applications, you should not respect user overrides. Jeśli jednak używasz NumberFormatInfo obiektu jawnie lub niejawnie do utrwalania danych liczbowych w postaci ciągów, należy NumberFormatInfo użyć obiektu, który odzwierciedla konwencje formatowania kultury niezmiennej, lub należy określić niestandardowy ciąg formatu liczbowego, który będzie używany bez względu na kulturę.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 i formatowanie liczboweIFormatProvider, NumberFormatInfo, and numeric formatting

NumberFormatInfo Obiekt jest używany niejawnie lub jawnie we wszystkich operacjach formatowania liczbowego.A NumberFormatInfo object is used implicitly or explicitly in all numeric formatting operations. Obejmują one wywołania następujących metod:These include calls to the following methods:

Wszystkie operacje formatowania liczbowego wykorzystują IFormatProvider implementację.All numeric formatting operations make use of an IFormatProvider implementation. Interfejs zawiera jedną metodę, GetFormat(Type). IFormatProviderThe IFormatProvider interface includes a single method, GetFormat(Type). Jest to metoda wywołania zwrotnego, która Type przekazuje obiekt, który reprezentuje typ wymagany do zapewnienia informacji o formatowaniu.This is a callback method that is passed a Type object that represents the type needed to provide formatting information. Metoda jest odpowiedzialna za zwracanie wystąpienia tego typu lub null, jeśli nie może dostarczyć wystąpienia typu.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 udostępnia dwie IFormatProvider implementacje dla numerów formatowania:The .NET Framework provides two IFormatProvider implementations for formatting numbers:

Jeśli implementacja nie zostanie przekazana do metody formatowania jawnie CultureInfo , używany jest obiekt zwracany przez CultureInfo.CurrentCulture właściwość, która reprezentuje bieżącą kulturę wątku. IFormatProviderIf 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.

Poniższy przykład ilustruje relację między IFormatProvider interfejsem NumberFormatInfo i klasą w operacjach formatowania, definiując implementację IFormatProvider niestandardową.The following example illustrates the relationship between the IFormatProvider interface and the NumberFormatInfo class in formatting operations by defining a custom IFormatProvider implementation. Jego GetFormat Metoda Wyświetla nazwę typu obiektu żądanego przez operację formatowania.Its GetFormat method displays the type name of the object requested by the formatting operation. Jeśli interfejs żąda NumberFormatInfo obiektu, ta metoda NumberFormatInfo zapewnia obiekt dla bieżącej kultury wątku.If the interface is requesting a NumberFormatInfo object, this method provides the NumberFormatInfo object for the current thread culture. Decimal.ToString(IFormatProvider) Jak wynika z przykładu, Metoda NumberFormatInfo żąda obiektu, aby dostarczyć informacji o String.Format(IFormatProvider, String, Object[]) formatowaniu, podczas gdy ICustomFormatter Metoda żąda NumberFormatInfo i obiektów DateTimeFormatInfo , a także realizacji.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

Jeśli implementacja nie jest jawnie podana w wywołaniu metody formatowania liczbowego, Metoda CultureInfo.CurrentCulture.GetFormat wywołuje NumberFormatInfo metodę, która zwraca obiekt, który odpowiada bieżącej kulturze wątku. IFormatProviderIf 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.

Ciągi formatów i właściwości NumberFormatInfoFormat strings and NumberFormatInfo properties

Każda operacja formatowania używa standardowego lub niestandardowego ciągu formatu liczbowego do utworzenia ciągu wynikowego z liczby.Every formatting operation uses either a standard or a custom numeric format string to produce a result string from a number. W niektórych przypadkach użycie ciągu formatu do utworzenia ciągu wynikowego jest jawne, jak w poniższym przykładzie.In some cases, the use of a format string to produce a result string is explicit, as in the following example. Ten kod wywołuje Decimal.ToString(IFormatProvider) metodę w celu Decimal przekonwertowania wartości na liczbę różnych reprezentacji ciągu przy użyciu Konwencji formatowania kultury 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

W innych przypadkach użycie ciągu formatu jest niejawne.In other cases, the use of a format string is implicit. Na przykład w następującej metodzie wywołania Decimal.ToString() metody domyślnej lub bezparametrowej wartość Decimal wystąpienia jest formatowana przy użyciu specyfikatora formatu ogólnego ("G") i Konwencji bieżącej kultury, która w tym przypadku jest Kultura 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

Każdy ciąg standardowego formatu liczbowego używa co najmniej NumberFormatInfo jednej właściwości do określenia wzorca lub symboli używanych w ciągu wynikowym.Each standard numeric format string uses one or more NumberFormatInfo properties to determine the pattern or the symbols used in the result string. Podobnie, każdy niestandardowy specyfikator formatu liczbowego z wyjątkiem "0" i "#" Wstawianie symboli w ciągu wynikowym zdefiniowanym przez NumberFormatInfo właściwości.Similarly, each custom numeric format specifier except "0" and "#" insert symbols in the result string that are defined by NumberFormatInfo properties. Poniższa tabela zawiera listę standardowych i niestandardowych specyfikatorów formatu liczbowego i skojarzonych NumberFormatInfo z nimi właściwości.The following table lists the standard and custom numeric format specifiers and their associated NumberFormatInfo properties. Aby zmienić wygląd ciągu wynikowego dla określonej kultury, zobacz sekcję Modyfikowanie właściwości NumberFormatInfo .To change the appearance of the result string for a particular culture, see the Modifying NumberFormatInfo properties section. Aby uzyskać szczegółowe informacje o używaniu tych specyfikatorów formatu, zobacz Standardowe ciągi formatujące i ciągi formatów liczb niestandardowych.For details about the use of these format specifiers, see Standard Numeric Format Strings and Custom Numeric Format Strings.

Specyfikator formatuFormat specifier Skojarzone właściwościAssociated properties
"C" lub "c" (specyfikator formatu waluty)"C" or "c" (currency format specifier) CurrencyDecimalDigits, aby zdefiniować domyślną liczbę cyfr ułamkowych.CurrencyDecimalDigits, to define the default number of fractional digits.

CurrencyDecimalSeparator, aby zdefiniować symbol separatora dziesiętnego.CurrencyDecimalSeparator, to define the decimal separator symbol.

CurrencyGroupSeparator, aby zdefiniować separator grup lub tysięcy.CurrencyGroupSeparator, to define the group or thousands separator.

CurrencyGroupSizes, aby zdefiniować rozmiary grup całkowitych.CurrencyGroupSizes, to define the sizes of integral groups.

CurrencyNegativePattern, aby zdefiniować wzorzec ujemnych wartości walutowych.CurrencyNegativePattern, to define the pattern of negative currency values.

CurrencyPositivePattern, aby zdefiniować wzorzec wartości dodatnich walut.CurrencyPositivePattern, to define the pattern of positive currency values.

CurrencySymbol, aby zdefiniować symbol waluty.CurrencySymbol, to define the currency symbol.

NegativeSign, aby zdefiniować symbol znaku minus.NegativeSign, to define the negative sign symbol.
"D" lub "d" (specyfikator formatu dziesiętnego)"D" or "d" (decimal format specifier) NegativeSign, aby zdefiniować symbol znaku minus.NegativeSign, to define the negative sign symbol.
"E" lub "e" (specyfikator formatu wykładniczego lub naukowego)"E" or "e" (exponential or scientific format specifier) NegativeSign, aby zdefiniować symbol znaku minus w mantysy i wykładnik.NegativeSign, to define the negative sign symbol in the mantissa and exponent.

NumberDecimalSeparator, aby zdefiniować symbol separatora dziesiętnego.NumberDecimalSeparator, to define the decimal separator symbol.

PositiveSign, aby zdefiniować symbol znaku pozytywnego w wykładniku.PositiveSign, to define the positive sign symbol in the exponent.
"F" lub "f" (specyfikator formatu stałego)"F" or "f" (fixed-point format specifier) NegativeSign, aby zdefiniować symbol znaku minus.NegativeSign, to define the negative sign symbol.

NumberDecimalDigits, aby zdefiniować domyślną liczbę cyfr ułamkowych.NumberDecimalDigits, to define the default number of fractional digits.

NumberDecimalSeparator, aby zdefiniować symbol separatora dziesiętnego.NumberDecimalSeparator, to define the decimal separator symbol.
"G" lub "g" (specyfikator formatu ogólnego)"G" or "g" (general format specifier) NegativeSign, aby zdefiniować symbol znaku minus.NegativeSign, to define the negative sign symbol.

NumberDecimalSeparator, aby zdefiniować symbol separatora dziesiętnego.NumberDecimalSeparator, to define the decimal separator symbol.

PositiveSign, aby zdefiniować symbol znaku pozytywnego dla ciągów wynikowych w formacie wykładniczym.PositiveSign, to define the positive sign symbol for result strings in exponential format.
"N" lub "n" (specyfikator formatu liczb)"N" or "n" (number format specifier) NegativeSign, aby zdefiniować symbol znaku minus.NegativeSign, to define the negative sign symbol.

NumberDecimalDigits, aby zdefiniować domyślną liczbę cyfr ułamkowych.NumberDecimalDigits, to define the default number of fractional digits.

NumberDecimalSeparator, aby zdefiniować symbol separatora dziesiętnego.NumberDecimalSeparator, to define the decimal separator symbol.

NumberGroupSeparator, aby zdefiniować symbol separatora grupy (tysiące).NumberGroupSeparator, to define the group separator (thousands) symbol.

NumberGroupSizes, aby zdefiniować liczbę cyfr całkowitych w grupie.NumberGroupSizes, to define the number of integral digits in a group.

NumberNegativePattern, aby zdefiniować format wartości ujemnych.NumberNegativePattern, to define the format of negative values.
"P" lub "p" (specyfikator formatu procentowego)"P" or "p" (percent format specifier) NegativeSign, aby zdefiniować symbol znaku minus.NegativeSign, to define the negative sign symbol.

PercentDecimalDigits, aby zdefiniować domyślną liczbę cyfr ułamkowych.PercentDecimalDigits, to define the default number of fractional digits.

PercentDecimalSeparator, aby zdefiniować symbol separatora dziesiętnego.PercentDecimalSeparator, to define the decimal separator symbol.

PercentGroupSeparator, aby zdefiniować symbol separatora grupy.PercentGroupSeparator, to define the group separator symbol.

PercentGroupSizes, aby zdefiniować liczbę cyfr całkowitych w grupie.PercentGroupSizes, to define the number of integral digits in a group.

PercentNegativePattern, aby zdefiniować położenie symbolu procentu i znaku minus dla wartości ujemnych.PercentNegativePattern, to define the placement of the percent symbol and the negative symbol for negative values.

PercentPositivePattern, aby zdefiniować położenie symbolu procentu dla wartości dodatnich.PercentPositivePattern, to define the placement of the percent symbol for positive values.

PercentSymbol, aby zdefiniować symbol procentu.PercentSymbol, to define the percent symbol.
"R" lub "r" (specyfikator formatu Round-rejs)"R" or "r" (round-trip format specifier) NegativeSign, aby zdefiniować symbol znaku minus.NegativeSign, to define the negative sign symbol.

NumberDecimalSeparator, aby zdefiniować symbol separatora dziesiętnego.NumberDecimalSeparator, to define the decimal separator symbol.

PositiveSign, aby zdefiniować symbol znaku pozytywnego w wykładniku.PositiveSign, to define the positive sign symbol in an exponent.
"X" lub "x" (specyfikator formatu szesnastkowego)"X" or "x" (hexadecimal format specifier) Brak.None.
"." (specyfikator formatu niestandardowego dziesiętnego)"." (decimal point custom format specifier) NumberDecimalSeparator, aby zdefiniować symbol separatora dziesiętnego.NumberDecimalSeparator, to define the decimal separator symbol.
"," (specyfikator formatu niestandardowego separatora grup)"," (group separator custom format specifier) NumberGroupSeparator, aby zdefiniować symbol separatora grupy (tysiące).NumberGroupSeparator, to define the group (thousands) separator symbol.
"%" (procentowy specyfikator formatu niestandardowego)"%" (percentage placeholder custom format specifier) PercentSymbol, aby zdefiniować symbol procentu.PercentSymbol, to define the percent symbol.
"‰" (na Mille symbol zastępczy niestandardowego specyfikatora formatu)"‰" (per mille placeholder custom format specifier) PerMilleSymbol, aby zdefiniować symbol na Mille.PerMilleSymbol, to define the per mille symbol.
"E" (specyfikator formatu niestandardowego notacji wykładniczej)"E" (exponential notation custom format specifier) NegativeSign, aby zdefiniować symbol znaku minus w mantysy i wykładnik.NegativeSign, to define the negative sign symbol in the mantissa and exponent.

PositiveSign, aby zdefiniować symbol znaku pozytywnego w wykładniku.PositiveSign, to define the positive sign symbol in the exponent.

Należy zauważyć, NumberFormatInfo że Klasa NativeDigits zawiera właściwość, która określa podstawowe 10 cyfr używanych przez określoną kulturę.Note that the NumberFormatInfo class includes a NativeDigits property that specifies the base 10 digits used by a specific culture. Jednak właściwość nie jest używana w operacjach formatowania; w ciągu wynikowym są używane tylko podstawowe cyfry łacińskie 0 (U + 0030) do 9 (U + 0039).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. Dodatkowo Single , dla i Double wartości NaN NaNSymbol PositiveInfinitySymbol NegativeInfinitySymbol , PositiveInfinityi ,ciągwynikowyskładasięwyłączniezsymboliNegativeInfinityzdefiniowanych przez, i właściwości piwo.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.

Modyfikowanie właściwości NumberFormatInfoModifying NumberFormatInfo properties

Właściwości NumberFormatInfo obiektu można modyfikować, aby dostosować ciąg wynikowy w operacji formatowania liczbowego.You can modify the properties of a NumberFormatInfo object to customize the result string produced in a numeric formatting operation. W tym celu:To do this:

  1. Utwórz kopię NumberFormatInfo obiektu do odczytu/zapisu, którego konwencje formatowania chcesz zmodyfikować.Create a read/write copy of a NumberFormatInfo object whose formatting conventions you want to modify. Aby uzyskać więcej informacji, zobacz sekcję Tworzenie wystąpienia obiektu NumberFormatInfo .For more information, see the Instantiating a NumberFormatInfo object section.

  2. Zmodyfikuj właściwość lub właściwości, które są używane do generowania żądanego ciągu wynikowego.Modify the property or properties that are used to produce the desired result string. Aby uzyskać informacje na temat sposobu, NumberFormatInfo w jaki metody formatowania używają właściwości do definiowania ciągów wynikowych, zobacz sekcję Format Strings i właściwości NumberFormatInfo .For information about how formatting methods use NumberFormatInfo properties to define result strings, see the Format strings and NumberFormatInfo properties section.

  3. Użyj obiektu niestandardowego NumberFormatInfo IFormatProvider jako argumentu w wywołaniach metod formatowania.Use the custom NumberFormatInfo object as the IFormatProvider argument in calls to formatting methods.

Uwaga

Zamiast dynamicznie modyfikować wartości właściwości kultury za każdym razem, gdy aplikacja jest uruchomiona, można użyć CultureAndRegionInfoBuilder klasy, aby zdefiniować niestandardową kulturę (kulturę, która ma unikatową nazwę i która uzupełnia istniejące kultury) lub zastąpić kultura (używana zamiast określonej kultury).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).

W poniższych sekcjach przedstawiono kilka przykładów.The following sections provide some examples.

Modyfikowanie symbolu waluty i wzoruModifying the currency symbol and pattern

Poniższy przykład modyfikuje NumberFormatInfo obiekt, który reprezentuje konwencje formatowania kultury en-us.The following example modifies a NumberFormatInfo object that represents the formatting conventions of the en-US culture. Przypisuje symbol waluty ISO-4217 do CurrencySymbol właściwości i definiuje wzorzec dla wartości walutowych, która składa się z symbolu waluty, po którym następuje spacja i wartość liczbowa.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

Formatowanie krajowego numeru identyfikacyjnegoFormatting a national identification number

Wiele krajowych numerów identyfikacyjnych składa się wyłącznie z cyfr i dlatego można je łatwo sformatować, modyfikując NumberFormatInfo właściwości obiektu.Many national identification numbers consist exclusively of digits and so can easily be formatted by modifying the properties of a NumberFormatInfo object. Na przykład numer ubezpieczenia społecznego w Stany Zjednoczone składa się z 9 cyfr uporządkowanych w następujący sposób XXX-XX-XXXX:.For example, a social security number in the United States consists of 9 digits arranged as follows: XXX-XX-XXXX. W poniższym przykładzie przyjęto założenie, że numery ubezpieczenia społecznego są przechowywane jako wartości całkowite i odpowiednio sformatowane.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

Analizowanie ciągów numerycznychParsing numeric strings

Analizowanie obejmuje przekonwertowanie ciągu reprezentującego liczbę na liczbę.Parsing involves converting the string representation of a number to a number. Każdy typ liczbowy w .NET Framework obejmuje dwie przeciążone metody analizy: Parse i TryParse.Each numeric type in the .NET Framework includes two overloaded parsing methods: Parse and TryParse. Parse Metoda konwertuje ciąg na liczbę i zgłasza wyjątek, jeśli konwersja nie powiedzie się.The Parse method converts a string to a number and throws an exception if the conversion fails. Metoda konwertuje ciąg na liczbę, przypisuje liczbę out do Boolean argumentu i zwraca wartość wskazującą, czy konwersja powiodła się. TryParseThe 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.

Metody analizy niejawnie lub jawnie wykorzystują NumberStyles wartość wyliczenia, aby określić, jakie elementy stylu (takie jak separatory grup, separator dziesiętny lub symbol waluty) mogą być obecne w ciągu, jeśli operacja analizowania ma się powieść.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. Jeśli wartość nie jest podana w wywołaniu metody, wartością domyślną NumberStyles jest wartość, która zawiera Float flagi i AllowThousands , które określa, że przeanalizowany ciąg może zawierać symbole grup, separator dziesiętny, znak ujemny, NumberStyles i znaki odstępu, lub może to być ciąg reprezentujący liczby w notacji wykładniczej.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.

Metody analizy również niejawnie lub jawnie używają NumberFormatInfo obiektu, który definiuje określone symbole i wzorce, które mogą wystąpić w ciągu do przeanalizowania.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. Jeśli obiekt nie jest podany, wartością domyślną NumberFormatInfo jest dla bieżącej kultury wątku. NumberFormatInfoIf a NumberFormatInfo object is not provided, the default is the NumberFormatInfo for the current thread culture. Aby uzyskać więcej informacji na temat analizy, zobacz poszczególne metody analizy, takie Int16.Parse(String)jak Int32.Parse(String, NumberStyles) Int64.Parse(String, IFormatProvider), Decimal.Parse(String, NumberStyles, IFormatProvider) Double.TryParse(String, Double),,, i 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).

Poniższy przykład ilustruje kulturową naturę ciągów analizy.The following example illustrates the culture-sensitive nature of parsing strings. Próbuje przeanalizować ciąg, który zawiera separatory tysięcy przy użyciu konwencji en-US, fr-FR i niezmiennej kultur.It tries to parse a string that include thousands separators by using the conventions of the en-US, fr-FR, and invariant cultures. Ciąg, który zawiera przecinek jako separator grupy i kropka jako separator dziesiętny, nie może zostać przeanalizowany w kulturze fr-FR, a ciąg z białym znakiem jako separator grupy i przecinek jako separator dziesiętny nie może zostać przeanalizowany w kulturach en-US i niezmienna.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)

Analizowanie zazwyczaj odbywa się w dwóch kontekstach:Parsing generally occurs in two contexts:

  • Jako operacja zaprojektowana w celu przekonwertowania danych wejściowych użytkownika na wartość liczbową.As an operation that is designed to convert user input into a numeric value.

  • Jako operacja, która jest przeznaczona do przeprowadzenia rundy wartości liczbowej; oznacza to, że w celu deserializacji wartości liczbowej, która została wcześniej zserializowana jako ciąg.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.

W poniższych sekcjach szczegółowo omówiono te dwie operacje.The following sections discuss these two operations in greater detail.

Analiza ciągów użytkownikaParsing user strings

Podczas analizowania ciągów liczbowych wprowadzonych przez użytkownika należy zawsze utworzyć wystąpienie NumberFormatInfo obiektu, który odzwierciedla ustawienia kulturowe użytkownika.When you are parsing numeric strings input by the user, you should always instantiate a NumberFormatInfo object that reflects the user's cultural settings. Informacje o sposobie tworzenia wystąpienia NumberFormatInfo obiektu, który odzwierciedla dostosowania użytkowników, można znaleźć w sekcji NumberFormatInfo i dane dynamiczne .For information about how to instantiate a NumberFormatInfo object that reflects user customizations, see the NumberFormatInfo and dynamic data section.

Poniższy przykład ilustruje różnicę między operacją analizowania, która odzwierciedla ustawienia kulturowe użytkownika i takie, które nie.The following example illustrates the difference between a parsing operation that reflects user cultural settings and one that does not. W tym przypadku domyślna kultura systemowa to en-US, ale użytkownik zdefiniował "," jako symbol dziesiętny i "." jako separator grupy w panelu sterowania, regionie i języku.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. Zwykle te symbole są odwrócone w domyślnej kulturze en-US.Ordinarily, these symbols are reversed in the default en-US culture. Gdy użytkownik wprowadza ciąg, który odzwierciedla ustawienia użytkownika, a ciąg jest analizowany przez NumberFormatInfo obiekt, który również odzwierciedla ustawienia użytkownika (przesłonięcia), operacja analizowania zwraca prawidłowy wynik.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. Jeśli jednak ciąg jest analizowany przez NumberFormatInfo obiekt, który odzwierciedla standardowe ustawienia kulturowe en-us, błędnie symbol przecinka dla separatora grupy i zwraca nieprawidłowy wynik.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

Serializacja i deserializacja danych liczbowychSerializing and deserializing numeric data

Gdy dane liczbowe są serializowane w formacie ciągu i później deserializowane i przeanalizowane, ciągi powinny być generowane i analizowane przy użyciu konwencji niezmiennej kultury.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. Operacje formatowania i analizowania nigdy nie powinny odzwierciedlać Konwencji określonej kultury.The formatting and parsing operations should never reflect the conventions of a specific culture. Jeśli są używane ustawienia specyficzne dla kultury, przenośność danych jest ściśle ograniczona; można go pomyślnie deserializować tylko w wątku, którego ustawienia specyficzne dla kultury są takie same jak w wątku, w którym został on Zserializowany.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. W niektórych przypadkach oznacza to, że nie można nawet pomyślnie przeprowadzić deserializacji danych w tym samym systemie, w którym został on Zserializowany.In some cases, this means that the data cannot even be successfully deserialized on the same system on which it was serialized.

Poniższy przykład ilustruje, co może się zdarzyć, gdy ta zasada zostanie naruszona.The following example illustrates what can happen when this principle is violated. Wartości zmiennoprzecinkowe w tablicy są konwertowane na ciągi, gdy bieżący wątek używa ustawień kultury 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. Dane są następnie analizowane przez wątek, który używa ustawień specyficznych dla kultury o kulturze en-GB.The data is then parsed by a thread that uses the culture-specific settings of the en-GB culture. W takim przypadku, mimo że każda operacja analizy powiedzie się, dane nie przejdzie pomyślnie i uszkodzenie danych.In this case, although each parsing operation succeeds, the data does not round-trip successfully and data corruption occurs. W innych przypadkach operacja analizowania może zakończyć się niepowodzeniem i FormatException może zostać zgłoszony wyjątek.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

Konstruktory

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

Inicjuje nowe, zapisywalne wystąpienie NumberFormatInfo klasy, która jest niezależna od kultury (niezmienna).Initializes a new writable instance of the NumberFormatInfo class that is culture-independent (invariant).

Właściwości

CurrencyDecimalDigits CurrencyDecimalDigits CurrencyDecimalDigits CurrencyDecimalDigits

Pobiera lub ustawia liczbę miejsc dziesiętnych, które mają być używane w wartościach walutowych.Gets or sets the number of decimal places to use in currency values.

CurrencyDecimalSeparator CurrencyDecimalSeparator CurrencyDecimalSeparator CurrencyDecimalSeparator

Pobiera lub ustawia ciąg, który ma być używany jako separator dziesiętny w wartościach walutowych.Gets or sets the string to use as the decimal separator in currency values.

CurrencyGroupSeparator CurrencyGroupSeparator CurrencyGroupSeparator CurrencyGroupSeparator

Pobiera lub ustawia ciąg oddzielający grupy cyfr z lewej strony dziesiętnej wartości w walutach.Gets or sets the string that separates groups of digits to the left of the decimal in currency values.

CurrencyGroupSizes CurrencyGroupSizes CurrencyGroupSizes CurrencyGroupSizes

Pobiera lub ustawia liczbę cyfr w każdej grupie na lewo od liczby dziesiętnej w wartościach walutowych.Gets or sets the number of digits in each group to the left of the decimal in currency values.

CurrencyNegativePattern CurrencyNegativePattern CurrencyNegativePattern CurrencyNegativePattern

Pobiera lub ustawia wzorzec formatu dla ujemnych wartości walutowych.Gets or sets the format pattern for negative currency values.

CurrencyPositivePattern CurrencyPositivePattern CurrencyPositivePattern CurrencyPositivePattern

Pobiera lub ustawia wzorzec formatu dla dodatnich wartości walutowych.Gets or sets the format pattern for positive currency values.

CurrencySymbol CurrencySymbol CurrencySymbol CurrencySymbol

Pobiera lub ustawia ciąg, który ma być używany jako symbol waluty.Gets or sets the string to use as the currency symbol.

CurrentInfo CurrentInfo CurrentInfo CurrentInfo

Pobiera wartość tylko NumberFormatInfo do odczytu, która formatuje wartości w oparciu o bieżącą kulturę.Gets a read-only NumberFormatInfo that formats values based on the current culture.

DigitSubstitution DigitSubstitution DigitSubstitution DigitSubstitution

Pobiera lub ustawia wartość określającą sposób wyświetlania kształtu cyfry w graficznym interfejsie użytkownika.Gets or sets a value that specifies how the graphical user interface displays the shape of a digit.

InvariantInfo InvariantInfo InvariantInfo InvariantInfo

Pobiera obiekt tylko NumberFormatInfo do odczytu, który jest niezależny od kultury (niezmienna).Gets a read-only NumberFormatInfo object that is culture-independent (invariant).

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Pobiera wartość wskazującą, czy ten NumberFormatInfo obiekt jest tylko do odczytu.Gets a value that indicates whether this NumberFormatInfo object is read-only.

NaNSymbol NaNSymbol NaNSymbol NaNSymbol

Pobiera lub ustawia ciąg, który reprezentuje wartość IEEE NaN (nie jest liczbą).Gets or sets the string that represents the IEEE NaN (not a number) value.

NativeDigits NativeDigits NativeDigits NativeDigits

Pobiera lub ustawia tablicę ciągów cyfr natywnych odpowiadających cyfrom zachodnim od 0 do 9.Gets or sets a string array of native digits equivalent to the Western digits 0 through 9.

NegativeInfinitySymbol NegativeInfinitySymbol NegativeInfinitySymbol NegativeInfinitySymbol

Pobiera lub ustawia ciąg, który reprezentuje nieskończoność ujemną.Gets or sets the string that represents negative infinity.

NegativeSign NegativeSign NegativeSign NegativeSign

Pobiera lub ustawia ciąg, który oznacza, że skojarzona liczba jest ujemna.Gets or sets the string that denotes that the associated number is negative.

NumberDecimalDigits NumberDecimalDigits NumberDecimalDigits NumberDecimalDigits

Pobiera lub ustawia liczbę miejsc dziesiętnych, które mają być używane w wartościach liczbowych.Gets or sets the number of decimal places to use in numeric values.

NumberDecimalSeparator NumberDecimalSeparator NumberDecimalSeparator NumberDecimalSeparator

Pobiera lub ustawia ciąg, który ma być używany jako separator dziesiętny w wartościach liczbowych.Gets or sets the string to use as the decimal separator in numeric values.

NumberGroupSeparator NumberGroupSeparator NumberGroupSeparator NumberGroupSeparator

Pobiera lub ustawia ciąg oddzielający grupy cyfr po lewej stronie dziesiętnej wartości liczbowych.Gets or sets the string that separates groups of digits to the left of the decimal in numeric values.

NumberGroupSizes NumberGroupSizes NumberGroupSizes NumberGroupSizes

Pobiera lub ustawia liczbę cyfr w każdej grupie na lewo od dziesiętnej wartości liczbowej.Gets or sets the number of digits in each group to the left of the decimal in numeric values.

NumberNegativePattern NumberNegativePattern NumberNegativePattern NumberNegativePattern

Pobiera lub ustawia wzorzec formatu dla ujemnych wartości liczbowych.Gets or sets the format pattern for negative numeric values.

PercentDecimalDigits PercentDecimalDigits PercentDecimalDigits PercentDecimalDigits

Pobiera lub ustawia liczbę miejsc dziesiętnych, które mają być używane w wartościach procentowych.Gets or sets the number of decimal places to use in percent values.

PercentDecimalSeparator PercentDecimalSeparator PercentDecimalSeparator PercentDecimalSeparator

Pobiera lub ustawia ciąg, który ma być używany jako separator dziesiętny w wartościach procentowych.Gets or sets the string to use as the decimal separator in percent values.

PercentGroupSeparator PercentGroupSeparator PercentGroupSeparator PercentGroupSeparator

Pobiera lub ustawia ciąg oddzielający grupy cyfr z lewej strony dziesiętnej wartości procentowej.Gets or sets the string that separates groups of digits to the left of the decimal in percent values.

PercentGroupSizes PercentGroupSizes PercentGroupSizes PercentGroupSizes

Pobiera lub ustawia liczbę cyfr w każdej grupie z lewej strony dziesiętnej wartości procentowej.Gets or sets the number of digits in each group to the left of the decimal in percent values.

PercentNegativePattern PercentNegativePattern PercentNegativePattern PercentNegativePattern

Pobiera lub ustawia wzorzec formatu dla ujemnych wartości procentowych.Gets or sets the format pattern for negative percent values.

PercentPositivePattern PercentPositivePattern PercentPositivePattern PercentPositivePattern

Pobiera lub ustawia wzorzec formatu dla dodatnich wartości procentowych.Gets or sets the format pattern for positive percent values.

PercentSymbol PercentSymbol PercentSymbol PercentSymbol

Pobiera lub ustawia ciąg, który ma być używany jako symbol procentu.Gets or sets the string to use as the percent symbol.

PerMilleSymbol PerMilleSymbol PerMilleSymbol PerMilleSymbol

Pobiera lub ustawia ciąg, który ma być używany jako symbol Mille.Gets or sets the string to use as the per mille symbol.

PositiveInfinitySymbol PositiveInfinitySymbol PositiveInfinitySymbol PositiveInfinitySymbol

Pobiera lub ustawia ciąg, który reprezentuje nieskończoność dodatnią.Gets or sets the string that represents positive infinity.

PositiveSign PositiveSign PositiveSign PositiveSign

Pobiera lub ustawia ciąg, który oznacza, że skojarzona liczba jest dodatnia.Gets or sets the string that denotes that the associated number is positive.

Metody

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

Tworzy skróconą kopię NumberFormatInfo obiektu.Creates a shallow copy of the NumberFormatInfo object.

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

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

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

Pobiera obiekt określonego typu, który udostępnia usługę formatowania liczb.Gets an object of the specified type that provides a number formatting service.

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

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

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

Pobiera skojarzenie skojarzone z określonym IFormatProvider. NumberFormatInfoGets the NumberFormatInfo associated with the specified IFormatProvider.

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

Type Pobiera bieżące wystąpienie.Gets the Type of the current instance.

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

Tworzy skróconą kopię bieżącego Objectelementu.Creates a shallow copy of the current Object.

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

Zwraca otokę tylko NumberFormatInfo do odczytu.Returns a read-only NumberFormatInfo wrapper.

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

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Inherited from Object)

Dotyczy

Zobacz też