CultureInfo.GetCultureInfo Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recupera uma instância em cache, somente leitura de uma cultura.
Sobrecargas
GetCultureInfo(String, Boolean) |
Recupera uma instância em cache, somente leitura de uma cultura. |
GetCultureInfo(String, String) |
Recupera uma instância em cache, somente leitura de uma cultura. Os parâmetros especificam uma cultura que é inicializada com os objetos TextInfo e CompareInfo especificados por outra cultura. |
GetCultureInfo(Int32) |
Recupera uma instância somente leitura armazenada em cache de uma cultura usando o identificador de cultura especificado. |
GetCultureInfo(String) |
Recupera uma instância armazenada em cache somente leitura de uma cultura usando o nome da cultura especificada. |
GetCultureInfo(String, Boolean)
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
Recupera uma instância em cache, somente leitura de uma cultura.
public:
static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, bool predefinedOnly);
public static System.Globalization.CultureInfo GetCultureInfo (string name, bool predefinedOnly);
static member GetCultureInfo : string * bool -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfo
Parâmetros
- name
- String
O nome de uma cultura. Não diferencia maiúsculas de minúsculas.
- predefinedOnly
- Boolean
true
se estiver solicitando a criação de uma instância de uma cultura conhecida pela plataforma. false
se for possível recuperar uma cultura criada, mesmo que a plataforma não transporte dados para ela.
Retornos
Uma instância somente leitura de uma cultura.
Comentários
Por padrão, ao tentar criar qualquer cultura e a plataforma subjacente (Windows NLS ou ICU) não tiver dados específicos para essa cultura, a plataforma tentará construir uma cultura com dados de outras culturas ou alguns valores constantes.
A configuração predefinedOnly
para true
garantirá que uma cultura seja criada somente se a plataforma tiver dados reais para essa cultura.
Aplica-se a
GetCultureInfo(String, String)
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
Recupera uma instância em cache, somente leitura de uma cultura. Os parâmetros especificam uma cultura que é inicializada com os objetos TextInfo e CompareInfo especificados por outra cultura.
public:
static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name, System::String ^ altName);
public static System.Globalization.CultureInfo GetCultureInfo (string name, string altName);
static member GetCultureInfo : string * string -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String, altName As String) As CultureInfo
Parâmetros
- name
- String
O nome de uma cultura. name
não diferencia maiúsculas de minúsculas.
- altName
- String
O nome de uma cultura que fornece os objetos TextInfo e CompareInfo usados para inicializar name
. altName
não diferencia maiúsculas de minúsculas.
Retornos
Um objeto somente leitura de CultureInfo .
Exceções
name
ou altName
é nulo.
name
ou altName
especifica uma cultura que não tem suporte. Para obter mais informações, consulte a seção Observações para chamadores.
Comentários
Para obter uma lista de nomes de cultura predefinidos em sistemas Windows, consulte a coluna Marca de idioma na lista de nomes de idioma/região compatíveis com o Windows. Os nomes de cultura seguem o padrão definido pelo BCP 47. Além disso, começando com Windows 10, name
pode ser qualquer marca de idioma BCP-47 válida.
O GetCultureInfo método obtém um objeto armazenado em cache, somente CultureInfo leitura. Ele oferece melhor desempenho do que uma chamada correspondente a um CultureInfo construtor. O método é usado para criar uma cultura semelhante à especificada pelo name
parâmetro , mas com regras de classificação e uso de maiúsculas e minúsculas diferentes.
Se name
ou altName
for o nome da cultura atual, os objetos retornados não refletirão nenhuma substituição de usuário. Se name
for String.Empty, o método retornará a cultura invariável. Isso equivale a recuperar o valor da InvariantCulture propriedade . Se altName
for String.Empty, o método usará o sistema de gravação e as regras de comparação especificadas pela cultura invariável.
Notas aos Chamadores
.NET Framework 3.5 e versões anteriores lançam um ArgumentException se name
ou altName
não é um nome de cultura válido. Começando com .NET Framework 4, esse método lança um CultureNotFoundException. Começando com aplicativos executados em .NET Framework 4 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 der suporte a essa cultura e se name
não for o nome de uma cultura complementar ou de substituição, o método gerará uma CultureNotFoundException exceção.
No .NET 6 e versões posteriores, um CultureNotFoundException será gerado se o aplicativo estiver em execução em um ambiente em que o modo invariável de globalização está habilitado, por exemplo, alguns contêineres do Docker e uma cultura diferente da cultura invariável é especificada.
Confira também
Aplica-se a
GetCultureInfo(Int32)
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
Recupera uma instância somente leitura armazenada em cache de uma cultura usando o identificador de cultura especificado.
public:
static System::Globalization::CultureInfo ^ GetCultureInfo(int culture);
public static System.Globalization.CultureInfo GetCultureInfo (int culture);
static member GetCultureInfo : int -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (culture As Integer) As CultureInfo
Parâmetros
- culture
- Int32
Um LCID (ID de localidade).
Retornos
Um objeto somente leitura de CultureInfo .
Exceções
culture
é menor que zero.
culture
especifica uma cultura que não tem suporte. Para obter mais informações, consulte a seção Observações para chamadores.
Comentários
Recomendamos que você use a sobrecarga de cadeia de caracteres desse método (GetCultureInfo(String)), pois os nomes de localidade devem ser usados em vez de LCIDs. Para localidades personalizadas, o nome da localidade é necessário.
Se culture
for o identificador de localidade da cultura atual, o objeto retornado CultureInfo não refletirá nenhuma substituição de usuário.
Notas aos Chamadores
.NET Framework 3.5 e versões anteriores lançam um ArgumentException se culture
não for um identificador de cultura válido. Começando com .NET Framework 4, esse método lança um CultureNotFoundException. Começando com aplicativos executados em .NET Framework 4 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 der suporte a essa cultura, o método lançará um CultureNotFoundException.
No .NET 6 e versões posteriores, um CultureNotFoundException será gerado se o aplicativo estiver em execução em um ambiente em que o modo invariável de globalização está habilitado, por exemplo, alguns contêineres do Docker e uma cultura diferente da cultura invariável é especificada.
Confira também
Aplica-se a
GetCultureInfo(String)
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
Recupera uma instância armazenada em cache somente leitura de uma cultura usando o nome da cultura especificada.
public:
static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name);
public static System.Globalization.CultureInfo GetCultureInfo (string name);
static member GetCultureInfo : string -> System.Globalization.CultureInfo
Public Shared Function GetCultureInfo (name As String) As CultureInfo
Parâmetros
- name
- String
O nome de uma cultura. name
não diferencia maiúsculas de minúsculas.
Retornos
Um objeto somente leitura de CultureInfo .
Exceções
name
é nulo.
name
especifica uma cultura que não tem suporte. Para obter mais informações, consulte a seção Observações para chamadores.
Comentários
Para obter uma lista de nomes de cultura predefinidos em sistemas Windows, consulte a coluna Marca de idioma na lista de nomes de idioma/região compatíveis com o Windows. Os nomes de cultura seguem o padrão definido pelo BCP 47. Além disso, começando com Windows 10, name
pode ser qualquer marca de idioma BCP-47 válida.
O GetCultureInfo método recupera um objeto armazenado em cache, somente CultureInfo leitura. Ele oferece melhor desempenho do que uma chamada correspondente para o CultureInfo.CultureInfo(String) construtor.
Se name
for o nome da cultura atual, o objeto retornado CultureInfo não refletirá nenhuma substituição de usuário. Isso torna o método adequado para aplicativos de servidor ou ferramentas que não têm uma conta de usuário real no sistema e que precisam carregar várias culturas com eficiência.
Se name
for String.Empty, o método retornará a cultura invariável. Isso equivale a recuperar o valor da InvariantCulture propriedade .
Notas aos Chamadores
.NET Framework 3.5 e versões anteriores lançam um ArgumentException se name
não for um nome de cultura válido. Começando com .NET Framework 4, esse método lança um CultureNotFoundException. Começando com aplicativos executados em .NET Framework 4 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 der suporte a essa cultura e se name
não for o nome de uma cultura complementar ou de substituição, o método lançará um CultureNotFoundException.
No .NET 6 e versões posteriores, um CultureNotFoundException será gerado se o aplicativo estiver em execução em um ambiente em que o modo invariável de globalização está habilitado, por exemplo, alguns contêineres do Docker e uma cultura diferente da cultura invariável é especificada.
Confira também
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de