CultureInfo CultureInfo CultureInfo CultureInfo Constructors

Definição

Sobrecargas

CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32)

Inicializa uma nova instância da classe CultureInfo com base na cultura especificada pelo identificador de cultura.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.

CultureInfo(String) CultureInfo(String) CultureInfo(String) CultureInfo(String)

Inicializa uma nova instância da classe CultureInfo com base na cultura especificada por nome.Initializes a new instance of the CultureInfo class based on the culture specified by name.

CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean)

Inicializa uma nova instância da classe CultureInfo com base na cultura especificada pelo identificador de cultura e no booliano que especifica se é necessário usar as configurações de cultura do selecionadas pelo usuário do sistema.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier and on the Boolean that specifies whether to use the user-selected culture settings from the system.

CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(String, Boolean)

Inicializa uma nova instância da classe CultureInfo com base na cultura especificada pelo nome e no booliano que especifica se é necessário usar as configurações de cultura do selecionadas pelo usuário do sistema.Initializes a new instance of the CultureInfo class based on the culture specified by name and on the Boolean that specifies whether to use the user-selected culture settings from the system.

CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32) CultureInfo(Int32)

Inicializa uma nova instância da classe CultureInfo com base na cultura especificada pelo identificador de cultura.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier.

public:
 CultureInfo(int culture);
public CultureInfo (int culture);
new System.Globalization.CultureInfo : int -> System.Globalization.CultureInfo
Public Sub New (culture As Integer)

Parâmetros

culture
Int32 Int32 Int32 Int32

Um identificador CultureInfo predefinido, a propriedade LCID de um objeto CultureInfo existente ou identificador de cultura somente do Windows.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

Exceções

culture não é um identificador de cultura válido.culture is not a valid culture identifier. Para obter mais informações, consulte a seção Observações para chamadores.See the Notes to Callers section for more information.

Comentários

Os identificadores de cultura predefinidos para culturas disponíveis no sistema Windows são listados na coluna marca de idioma na lista de idiomas/nomes de região com suporte do Windows.Predefined culture identifiers for cultures available on Windows system are listed in the Language tag column in the list of language/region names supported by Windows. Os nomes de cultura seguem o padrão definido pelo BCP 47.Culture names follow the standard defined by BCP 47.

Na maioria dos casos, culture o parâmetro é mapeado para o identificador de localidade NLS (suporte ao idioma nacional) correspondente.In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. O valor do culture parâmetro torna-se o valor LCID da Propriedade do novo CultureInfo.The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

Recomendamos que você chame o construtor CultureInfo.CultureInfode nome de localidade, pois os nomes de localidade são preferidos para LCIDs.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Para localidades personalizadas, é necessário um nome de localidade.For custom locales, a locale name is required.

O usuário pode optar por substituir alguns dos valores associados à cultura atual do Windows por meio da parte de opções regionais e de idioma do painel de controle.The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. Por exemplo, o usuário pode optar por exibir a data em um formato diferente ou usar uma moeda diferente do padrão para a cultura.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture. Se o identificador de cultura especificado corresponder ao identificador de cultura da cultura do Windows atual, esse construtor CultureInfo criará um que usa essas substituições, incluindo as configurações do DateTimeFormatInfo usuário para as propriedades da instância retornada pelo e as propriedades NumberFormatInfo da instância retornada pela NumberFormat propriedade. DateTimeFormatIf the specified culture identifier matches the culture identifier of the current Windows culture, this constructor creates a CultureInfo that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. Se as configurações do usuário forem incompatíveis com a cultura associada CultureInfo ao (por exemplo, se o calendário selecionado não for um OptionalCalendarsdos), os resultados dos métodos e os valores das propriedades serão indefinidos.If the user settings are incompatible with the culture associated with the CultureInfo (for example, if the selected calendar is not one of the OptionalCalendars) the results of the methods and the values of the properties are undefined.

Se o identificador de cultura especificado não corresponder ao identificador da cultura atual do Windows, esse construtor criará CultureInfo um que usa os valores padrão para a cultura especificada.If the specified culture identifier does not match the identifier of the current Windows culture, this constructor creates a CultureInfo that uses the default values for the specified culture.

A UseUserOverride propriedade é sempre definida como true.The UseUserOverride property is always set to true.

Por exemplo, suponha que o árabe (Arábia Saudita) seja a cultura atual do Windows e que o usuário tenha alterado o calendário de Hijri para gregoriano.For example, suppose that Arabic (Saudi Arabia) is the current Windows culture and the user has changed the calendar from Hijri to Gregorian.

Para culturas que usam o euro, o .NET Framework e o Windows XP definem a moeda padrão como euro.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. No entanto, as versões mais antigas do Windows não.However, older versions of Windows do not. Portanto, se o usuário de uma versão mais antiga do Windows não tiver alterado a configuração de moeda por meio da parte de opções regionais e de idiomas do painel de controle, a moeda poderá estar incorreta.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. Para usar a configuração padrão de .NET Framework para a moeda, o aplicativo deve usar CultureInfo uma sobrecarga de construtor que useUserOverride aceite um parâmetro e defina false-o como.To use the .NET Framework default setting for the currency, the application should use a CultureInfo constructor overload that accepts a useUserOverride parameter and set it to false.

Observação

Para compatibilidade com versões anteriores, uma cultura construída usando um culture parâmetro de 0x0004 ou 0x7C04 terá uma Name propriedade de zh-CHS ou zh-CHT, respectivamente.For backwards compatibility, a culture constructed using a culture parameter of 0x0004 or 0x7c04 will have a Name property of zh-CHS or zh-CHT, respectively. Em vez disso, você deve preferir construir a cultura usando os nomes de cultura padrão atuais de zh-Hans ou zh-Hant, a menos que você tenha um motivo para usar os nomes mais antigos.You should instead prefer to construct the culture using the current standard culture names of zh-Hans or zh-Hant, unless you have a reason for using the older names.

Notas aos Chamadores

O .NET Framework 3,5.NET Framework 3.5 e versões anteriores geram ArgumentException um culture If que não é um identificador de cultura válido.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. A partir do .NET Framework 4.NET Framework 4, esse construtor gera um CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. A partir de aplicativos que são executados .NET Framework 4.NET Framework 4 no ou posterior no Windows 7 ou posterior, o método tenta recuperar um CultureInfo objeto cujo identificador é culture do sistema operacional; se o sistema operacional não oferecer suporte a essa cultura, o o método gera CultureNotFoundException uma exceção.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is culture from the operating system; if the operating system does not support that culture, the method throws a CultureNotFoundException exception.

Veja também

CultureInfo(String) CultureInfo(String) CultureInfo(String) CultureInfo(String)

Inicializa uma nova instância da classe CultureInfo com base na cultura especificada por nome.Initializes a new instance of the CultureInfo class based on the culture specified by name.

public:
 CultureInfo(System::String ^ name);
public CultureInfo (string name);
new System.Globalization.CultureInfo : string -> System.Globalization.CultureInfo
Public Sub New (name As String)

Parâmetros

name
String String String String

Um nome de CultureInfo predefinido, Name de um CultureInfo existente, ou o nome da cultura somente do Windows.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. name não diferencia maiúsculas de minúsculas.name is not case-sensitive.

Exceções

name não é um nome de cultura válido.name is not a valid culture name. Para obter mais informações, consulte a seção Observações para Chamadores.For more information, see the Notes to Callers section.

Exemplos

O exemplo a seguir recupera a cultura atual.The following example retrieves the current culture. Se for algo diferente da cultura francesa (França), ele chamará o CultureInfo(String) Construtor para criar uma instância de um CultureInfo objeto que representa a cultura francesa (França) e o tornará a cultura do thread atual.If it is anything other than the French (France) culture, it calls the CultureInfo(String) constructor to instantiate a CultureInfo object that represents the French (France) culture and makes it the current thread culture. Caso contrário, ele instancia um CultureInfo objeto que representa a cultura francesa (Luxemburgo) e o torna a cultura atual.Otherwise, it instantiates a CultureInfo object that represents the French (Luxembourg) culture and makes it the current culture.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      CultureInfo current = CultureInfo.CurrentCulture;
      Console.WriteLine("The current culture is {0}", current.Name);
      CultureInfo newCulture;
      if (current.Name.Equals("fr-FR"))
         newCulture = new CultureInfo("fr-LU");
      else   
         newCulture = new CultureInfo("fr-FR");
      
      CultureInfo.CurrentCulture = newCulture;
      Console.WriteLine("The current culture is now {0}", 
                        CultureInfo.CurrentCulture.Name);   
   }
}
// The example displays output like the following:
//     The current culture is en-US
//     The current culture is now fr-FR
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim current As CultureInfo = CultureInfo.CurrentCulture
      Console.WriteLine("The current culture is {0}", current.Name)
      Dim newCulture As CultureInfo
      If current.Name.Equals("fr-FR") Then
         newCulture = New CultureInfo("fr-LU")
      Else   
         newCulture = new CultureInfo("fr-FR")
      End If
      
      CultureInfo.CurrentCulture = newCulture
      Console.WriteLine("The current culture is now {0}", 
                        CultureInfo.CurrentCulture.Name)   
   End Sub
End Module
' The example displays output like the following:
'     The current culture is en-US
'     The current culture is now fr-FR

Comentários

Para obter uma lista de nomes de cultura predefinidos em sistemas Windows, consulte a coluna marca de idioma na lista de idiomas/nomes de região com suporte no Windows.For a list of predefined culture names on Windows systems, see the Language tag column in the list of language/region names supported by Windows. Os nomes de cultura seguem o padrão definido pelo BCP 47.Culture names follow the standard defined by BCP 47. Além disso, a partir do Windows 10 name , pode ser qualquer marca de linguagem bcp-47 válida.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Se name InvariantCulture for String.Empty, o Construtor criará uma instância da cultura invariável; isso é equivalente a recuperar o valor da propriedade.If name is String.Empty, the constructor creates an instance of the invariant culture; this is equivalent to retrieving the value of the InvariantCulture property.

O usuário pode optar por substituir alguns dos valores associados à cultura atual do Windows por meio da parte de opções regionais e de idioma do painel de controle.The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. Por exemplo, o usuário pode optar por exibir a data em um formato diferente ou usar uma moeda diferente do padrão para a cultura.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture. Se o identificador de cultura associado name a corresponder ao identificador de cultura da cultura atual do Windows, esse construtor CultureInfo criará um objeto que usa essas substituições, incluindo as configurações do usuário para as propriedades do DateTimeFormatInfoinstância retornada pela DateTimeFormat Propriedade e as NumberFormatInfo Propriedades da instância retornada pela NumberFormat propriedade.If the culture identifier associated with name matches the culture identifier of the current Windows culture, this constructor creates a CultureInfo object that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. Se as configurações do usuário forem incompatíveis com a cultura associada CultureInfoao, por exemplo, se o calendário selecionado não for um OptionalCalendarsdos, os resultados dos métodos e dos valores das propriedades serão indefinidos.If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

Se o identificador de cultura associado name a não corresponder ao identificador de cultura da cultura atual do Windows, esse construtor criará um CultureInfo objeto que usa os valores padrão para a cultura especificada.If the culture identifier associated with name does not match the culture identifier of the current Windows culture, this constructor creates a CultureInfo object that uses the default values for the specified culture.

A UseUserOverride propriedade é sempre definida como true.The UseUserOverride property is always set to true.

Por exemplo, suponha que o árabe (Arábia Saudita) seja a cultura atual do Windows e o usuário tenha alterado o calendário de Hijri para gregoriano.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

A LCID propriedade da nova CultureInfo é definida como o identificador de cultura associado ao nome especificado.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Para culturas que usam o euro, o .NET Framework e o Windows XP definem a moeda padrão como euro.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. No entanto, as versões mais antigas do Windows não fazem isso.However, older versions of Windows do not do this. Portanto, se o usuário de uma versão mais antiga do Windows não tiver alterado a configuração de moeda por meio da parte de opções regionais e de idiomas do painel de controle, a moeda poderá estar incorreta.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. Para usar a configuração padrão de .NET Framework para a moeda, o aplicativo deve usar CultureInfo uma sobrecarga de construtor que useUserOverride aceite um parâmetro e defina false-o como.To use the .NET Framework default setting for the currency, the application should use a CultureInfo constructor overload that accepts a useUserOverride parameter and set it to false.

Notas aos Chamadores

O .NET Framework 3,5.NET Framework 3.5 e versões anteriores lançam ArgumentException um name If que não é um nome de cultura válido.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. A partir do .NET Framework 4.NET Framework 4, esse construtor gera um CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. A partir de aplicativos que são executados .NET Framework 4.NET Framework 4 no ou posterior no Windows 7 ou posterior, o método tenta recuperar um CultureInfo objeto cujo identificador é name do sistema operacional; se o sistema operacional não oferecer suporte a essa cultura e se Não é o nome de uma cultura suplementar ou de substituição, o método gera CultureNotFoundException uma exceção. nameStarting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception.

Veja também

CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean) CultureInfo(Int32, Boolean)

Inicializa uma nova instância da classe CultureInfo com base na cultura especificada pelo identificador de cultura e no booliano que especifica se é necessário usar as configurações de cultura do selecionadas pelo usuário do sistema.Initializes a new instance of the CultureInfo class based on the culture specified by the culture identifier and on the Boolean that specifies whether to use the user-selected culture settings from the system.

public:
 CultureInfo(int culture, bool useUserOverride);
public CultureInfo (int culture, bool useUserOverride);
new System.Globalization.CultureInfo : int * bool -> System.Globalization.CultureInfo
Public Sub New (culture As Integer, useUserOverride As Boolean)

Parâmetros

culture
Int32 Int32 Int32 Int32

Um identificador CultureInfo predefinido, a propriedade LCID de um objeto CultureInfo existente ou identificador de cultura somente do Windows.A predefined CultureInfo identifier, LCID property of an existing CultureInfo object, or Windows-only culture identifier.

useUserOverride
Boolean Boolean Boolean Boolean

Um valor booliano que indica se é necessário usar as configurações de cultura selecionadas pelo usuário (true) ou as configurações de cultura padrão (false).A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

Exceções

culture não é um identificador de cultura válido.culture is not a valid culture identifier. Para obter mais informações, consulte a seção Observações para chamadores.See the Notes to Callers section for more information.

Comentários

Os identificadores de cultura predefinidos disponíveis em sistemas Windows são listados na coluna marca de idioma na lista de nomes de idiomas/regiões com suporte do Windows.Predefined culture identifiers available on Windows systems are listed in the Language tag column in the list of language/region names supported by Windows. Os nomes de cultura seguem o padrão definido pelo BCP 47.Culture names follow the standard defined by BCP 47.

Na maioria dos casos, culture o parâmetro é mapeado para o identificador de localidade NLS (suporte ao idioma nacional) correspondente.In most cases, the culture parameter is mapped to the corresponding National Language Support (NLS) locale identifier. O valor do culture parâmetro torna-se o valor LCID da Propriedade do novo CultureInfo.The value of the culture parameter becomes the value of the LCID property of the new CultureInfo.

Recomendamos que você chame o construtor CultureInfo.CultureInfode nome de localidade, pois os nomes de localidade são preferidos para LCIDs.We recommend that you call the locale name constructor CultureInfo.CultureInfo, because locale names are preferable to LCIDs. Para localidades personalizadas, é necessário um nome de localidade.For custom locales, a locale name is required.

O usuário pode optar por substituir alguns dos valores associados à cultura atual do Windows por meio da parte de opções regionais e de idioma do painel de controle.The user might choose to override some of the values associated with the current culture of Windows through the regional and language options portion of Control Panel. Por exemplo, o usuário pode optar por exibir a data em um formato diferente ou usar uma moeda diferente do padrão para a cultura.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture.

Os aplicativos normalmente não devem impedir substituições do usuário.Applications should typically not disallow user overrides. Observe que a despermissão de substituições não garante a estabilidade dos dados; consulte os dados de cultura de entrada de blog não devem ser considerados estáveis (exceto para invariável).Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

Se a UseUserOverride propriedade for definida como true e o identificador de cultura especificado corresponder ao identificador da cultura atual do Windows, esse construtor criará um CultureInfo que usa essas substituições, incluindo as configurações do usuário para as propriedades da instância retornada DateTimeFormat pela propriedade NumberFormatInfo e as propriedades da instância retornada pela NumberFormat propriedade. DateTimeFormatInfoIf the UseUserOverride property is set to true and the specified culture identifier matches the identifier of the current Windows culture, this constructor creates a CultureInfo that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. Se as configurações do usuário forem incompatíveis com a cultura associada CultureInfoao, por exemplo, se o calendário selecionado não for um OptionalCalendarsdos, os resultados dos métodos e dos valores das propriedades serão indefinidos.If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

Caso contrário, esse construtor cria CultureInfo um que usa os valores padrão para a cultura especificada.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

O valor do useUserOverride parâmetro torna-se o valor UseUserOverride da propriedade.The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

Por exemplo, suponha que o árabe (Arábia Saudita) seja a cultura atual do Windows e que o usuário tenha alterado o calendário de Hijri para gregoriano.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user has changed the calendar from Hijri to Gregorian.

Para culturas que usam o euro, o .NET Framework e o Windows XP definem a moeda padrão como euro.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. No entanto, as versões mais antigas do Windows não.However, older versions of Windows do not. Portanto, se o usuário de uma versão mais antiga do Windows não tiver alterado a configuração de moeda por meio da parte de opções regionais e de idiomas do painel de controle, a moeda poderá estar incorreta.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. Para usar a .NET Framework configuração padrão para a moeda, o aplicativo deve definir o useUserOverride parâmetro como false.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Observação

Para compatibilidade com versões anteriores, uma cultura construída usando um culture parâmetro de 0x0004 ou 0x7C04 terá uma Name propriedade de zh-CHS ou zh-CHT, respectivamente.For backwards compatibility, a culture constructed using a culture parameter of 0x0004 or 0x7c04 will have a Name property of zh-CHS or zh-CHT, respectively. Em vez disso, você deve preferir construir a cultura usando os nomes de cultura padrão atuais de zh-Hans ou zh-Hant, a menos que você tenha um motivo para usar os nomes mais antigos.You should instead prefer to construct the culture using the current standard culture names of zh-Hans or zh-Hant, unless you have a reason for using the older names.

Notas aos Chamadores

O .NET Framework 3,5.NET Framework 3.5 e versões anteriores geram ArgumentException um culture If que não é um identificador de cultura válido.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if culture is not a valid culture identifier. A partir do .NET Framework 4.NET Framework 4, esse construtor gera um CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. A partir de aplicativos que são executados .NET Framework 4.NET Framework 4 no ou posterior no Windows 7 ou posterior, o método tenta recuperar um CultureInfo objeto cujo identificador é culture do sistema operacional; se o sistema operacional não oferecer suporte a essa cultura, o o método gera CultureNotFoundException uma exceção.Starting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is culture from the operating system; if the operating system does not support that culture, the method throws a CultureNotFoundException exception.

Veja também

CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(String, Boolean) CultureInfo(String, Boolean)

Inicializa uma nova instância da classe CultureInfo com base na cultura especificada pelo nome e no booliano que especifica se é necessário usar as configurações de cultura do selecionadas pelo usuário do sistema.Initializes a new instance of the CultureInfo class based on the culture specified by name and on the Boolean that specifies whether to use the user-selected culture settings from the system.

public:
 CultureInfo(System::String ^ name, bool useUserOverride);
public CultureInfo (string name, bool useUserOverride);
new System.Globalization.CultureInfo : string * bool -> System.Globalization.CultureInfo
Public Sub New (name As String, useUserOverride As Boolean)

Parâmetros

name
String String String String

Um nome de CultureInfo predefinido, Name de um CultureInfo existente, ou o nome da cultura somente do Windows.A predefined CultureInfo name, Name of an existing CultureInfo, or Windows-only culture name. name não diferencia maiúsculas de minúsculas.name is not case-sensitive.

useUserOverride
Boolean Boolean Boolean Boolean

Um valor booliano que indica se é necessário usar as configurações de cultura selecionadas pelo usuário (true) ou as configurações de cultura padrão (false).A Boolean that denotes whether to use the user-selected culture settings (true) or the default culture settings (false).

Exceções

name não é um nome de cultura válido.name is not a valid culture name. Para obter mais informações, consulte a seção Observações para chamadores.See the Notes to Callers section for more information.

Comentários

Para obter uma lista de nomes de cultura predefinidos, consulte a coluna marca de idioma na lista de idiomas/nomes de região com suporte no Windows.For a list of predefined culture names, see the Language tag column in the list of language/region names supported by Windows. Os nomes de cultura seguem o padrão definido pelo BCP 47.Culture names follow the standard defined by BCP 47. Além disso, a partir do Windows 10 name , pode ser qualquer marca de linguagem bcp-47 válida.In addition, starting with Windows 10, name can be any valid BCP-47 language tag.

Se name InvariantCulture for String.Empty, o Construtor criará uma instância da cultura invariável; isso é equivalente a recuperar o valor da propriedade.If name is String.Empty, the constructor creates an instance of the invariant culture; this is equivalent to retrieving the value of the InvariantCulture property.

O usuário pode optar por substituir alguns dos valores associados à cultura do Windows atual por meio da parte de opções regionais e de idioma do painel de controle.The user might choose to override some of the values associated with the current Windows culture through the regional and language options portion of Control Panel. Por exemplo, o usuário pode optar por exibir a data em um formato diferente ou usar uma moeda diferente do padrão para a cultura.For example, the user might choose to display the date in a different format or to use a currency other than the default for the culture.

Os aplicativos normalmente não devem impedir substituições do usuário.Applications should typically not disallow user overrides. Observe que a despermissão de substituições não garante a estabilidade dos dados; consulte os dados de cultura de entrada de blog não devem ser considerados estáveis (exceto para invariável).Note that disallowing overrides does not itself guarantee data stability; see the blog entry Culture data shouldn't be considered stable (except for Invariant).

Se a UseUserOverride propriedade for definida como true e o identificador de cultura associado ao nome de cultura especificado corresponder ao identificador de cultura da cultura atual do Windows, esse construtor CultureInfo criará um que usa essas substituições, incluindo configurações de usuário para as propriedades da DateTimeFormatInfo instância retornada DateTimeFormat pela propriedade NumberFormatInfo e as propriedades da instância retornada pela NumberFormat propriedade.If the UseUserOverride property is set to true and the culture identifier associated with the specified culture name matches the culture identifier of the current Windows culture, this constructor creates a CultureInfo that uses those overrides, including user settings for the properties of the DateTimeFormatInfo instance returned by the DateTimeFormat property, and the properties of the NumberFormatInfo instance returned by the NumberFormat property. Se as configurações do usuário forem incompatíveis com a cultura associada CultureInfoao, por exemplo, se o calendário selecionado não for um OptionalCalendarsdos, os resultados dos métodos e dos valores das propriedades serão indefinidos.If the user settings are incompatible with the culture associated with the CultureInfo, for example, if the selected calendar is not one of the OptionalCalendars, the results of the methods and the values of the properties are undefined.

Caso contrário, esse construtor cria CultureInfo um que usa os valores padrão para a cultura especificada.Otherwise, this constructor creates a CultureInfo that uses the default values for the specified culture.

O valor do useUserOverride parâmetro torna-se o valor UseUserOverride da propriedade.The value of the useUserOverride parameter becomes the value of the UseUserOverride property.

Por exemplo, suponha que o árabe (Arábia Saudita) seja a cultura atual do Windows e o usuário tenha alterado o calendário de Hijri para gregoriano.For example, suppose that Arabic (Saudi Arabia) is the current culture of Windows and the user changed the calendar from Hijri to Gregorian.

A LCID propriedade da nova CultureInfo é definida como o identificador de cultura associado ao nome especificado.The LCID property of the new CultureInfo is set to the culture identifier associated with the specified name.

Para culturas que usam o euro, o .NET Framework e o Windows XP definem a moeda padrão como euro.For cultures that use the euro, the .NET Framework and Windows XP set the default currency as euro. No entanto, as versões mais antigas do Windows não fazem isso.However, older versions of Windows do not do this. Portanto, se o usuário de uma versão mais antiga do Windows não tiver alterado a configuração de moeda por meio da parte de opções regionais e de idiomas do painel de controle, a moeda poderá estar incorreta.Therefore, if the user of an older version of Windows has not changed the currency setting through the regional and language options portion of Control Panel, the currency might be incorrect. Para usar a .NET Framework configuração padrão para a moeda, o aplicativo deve definir o useUserOverride parâmetro como false.To use the .NET Framework default setting for the currency, the application should set the useUserOverride parameter to false.

Notas aos Chamadores

O .NET Framework 3,5.NET Framework 3.5 e versões anteriores lançam ArgumentException um name If que não é um nome de cultura válido.The .NET Framework 3,5.NET Framework 3.5 and earlier versions throw an ArgumentException if name is not a valid culture name. A partir do .NET Framework 4.NET Framework 4, esse construtor gera um CultureNotFoundException.Starting with the .NET Framework 4.NET Framework 4, this constructor throws a CultureNotFoundException. A partir de aplicativos que são executados .NET Framework 4.NET Framework 4 no ou posterior no Windows 7 ou posterior, o método tenta recuperar um CultureInfo objeto cujo identificador é name do sistema operacional; se o sistema operacional não oferecer suporte a essa cultura e se Não é o nome de uma cultura suplementar ou de substituição, o método gera CultureNotFoundException uma exceção. nameStarting with apps that run under the .NET Framework 4.NET Framework 4 or later on Windows 7 or later, the method attempts to retrieve a CultureInfo object whose identifier is name from the operating system; if the operating system does not support that culture, and if name is not the name of a supplementary or replacement culture, the method throws a CultureNotFoundException exception.

Veja também

Aplica-se a