CultureInfo.GetCultureInfo Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recupera uma instância em cache e apenas leitura de uma cultura.
Sobrecargas
| Name | Descrição |
|---|---|
| GetCultureInfo(String, Boolean) |
Recupera uma instância em cache e apenas leitura de uma cultura. |
| GetCultureInfo(String, String) |
Recupera uma instância em cache e apenas leitura de uma cultura. Os parâmetros especificam uma cultura que é inicializada com os TextInfo objetos e CompareInfo especificados por outra cultura. |
| GetCultureInfo(Int32) |
Recupera uma instância em cache e apenas leitura de uma cultura usando o identificador de cultura especificado. |
| GetCultureInfo(String) |
Recupera uma instância em cache e apenas leitura de uma cultura usando o nome de cultura especificado. |
GetCultureInfo(String, Boolean)
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
Recupera uma instância em cache e apenas 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.CultureInfoPublic Shared Function GetCultureInfo (name As String, predefinedOnly As Boolean) As CultureInfoParâmetros
- name
- String
O nome de uma cultura. Não é sensível a maiúsculas minúsculas.
- predefinedOnly
- Boolean
true se pedir para criar uma instância de uma cultura conhecida pela plataforma.
false Se é aceitável recuperar uma cultura inventada mesmo que a plataforma não transporte dados para ela.
Devoluções
Uma instância apenas de leitura de uma cultura.
Observações
Por defeito, ao tentar criar qualquer cultura e a plataforma subjacente (Windows, NLS ou ICU) não transporta dados específicos para essa cultura, a plataforma tentará construir uma cultura com dados de outras culturas ou valores constantes.
Definir predefinedOnly para true garantir que uma cultura só é criada se a plataforma tiver dados reais dessa cultura.
Aplica-se a
GetCultureInfo(String, String)
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
Recupera uma instância em cache e apenas leitura de uma cultura. Os parâmetros especificam uma cultura que é inicializada com os TextInfo objetos 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.CultureInfoPublic Shared Function GetCultureInfo (name As String, altName As String) As CultureInfoParâ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 TextInfo objetos e CompareInfo usados para inicializar name.
altName não diferencia maiúsculas de minúsculas.
Devoluções
Um objeto só CultureInfo de leitura.
Exceções
name ou altName é null.
name ou altName especifica uma cultura que não é suportada. Consulte a secção Notas para Chamadores para mais informações.
Observações
Para uma lista de nomes de cultura pré-definidos em sistemas Windows, veja a coluna Language tag na lista lista de nomes de línguas/regiões suportados por Windows. Os nomes das culturas seguem o padrão definido pelo BCP 47. Além disso, a partir de Windows 10, name pode ser qualquer etiqueta válida da língua BCP-47.
O GetCultureInfo método obtém um objeto em cache, apenas CultureInfo de leitura. 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 ordenação e carcaça diferentes.
Se name for ou altName for o nome da cultura atual, os objetos devolvidos não refletem quaisquer sobreposições do utilizador. Se name for String.Empty, o método devolve a cultura invariante. Isto é equivalente a recuperar o valor da InvariantCulture propriedade. Se altName for String.Empty, o método utiliza o sistema de escrita e as regras de comparação especificadas pela cultura invariante.
Notas para Chamadores
.NET Framework 3.5 e versões anteriores apresentam um ArgumentException se name ou altName não for um nome de cultura válido. Começando com .NET Framework 4, este método gera um CultureNotFoundException. Começando com aplicações que correm sob .NET Framework 4 ou posteriores Windows 7 ou posteriores, o método tenta recuperar um objeto CultureInfo cujo identificador é name do sistema operativo; se o sistema operativo não suportar essa cultura, e se name não for o nome de uma cultura suplementar ou substituta, O método lança uma exceção CultureNotFoundException.
Em versões .NET 6 e posteriores, é lançado um CultureNotFoundException se a aplicação estiver a correr num ambiente onde o modo invariante à globalização está ativado, por exemplo, alguns contentores Docker, e uma cultura diferente da cultura invariante é especificada.
Ver também
Aplica-se a
GetCultureInfo(Int32)
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
Recupera uma instância em cache e apenas leitura 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.CultureInfoPublic Shared Function GetCultureInfo (culture As Integer) As CultureInfoParâmetros
- culture
- Int32
Um identificador de localidade (LCID).
Devoluções
Um objeto só CultureInfo de leitura.
Exceções
culture é inferior a zero.
culture especifica uma cultura que não é suportada. Consulte a secção Notas para o Chamador para mais informações.
Observações
Recomendamos que utilize a sobrecarga de cadeias deste método (GetCultureInfo(String)), porque os nomes locais devem ser usados em vez de LCIDs. Para locais personalizados, é necessário o nome do local.
Se culture for o identificador local da cultura atual, o objeto devolvido CultureInfo não reflete quaisquer sobrescrições do utilizador.
Note
Os LCIDs estão a ser obsoletos, e os implementadores são fortemente encorajados a usar versões mais recentes de APIs que suportem nomes locais BCP 47. Cada LCID pode ser representado por um nome local BCP 47, mas o contrário não é verdade. O intervalo do LCID é restrito e não consegue identificar de forma única todas as combinações possíveis de língua e região.
Notas para 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, este método gera um CultureNotFoundException. Começando com aplicações que correm sob .NET Framework 4 ou posteriores em Windows 7 ou posteriores, o método tenta recuperar um objeto CultureInfo cujo identificador é culture do sistema operativo; se o sistema operativo não suportar essa cultura, o método gera um CultureNotFoundException.
Em versões .NET 6 e posteriores, é lançado um CultureNotFoundException se a aplicação estiver a correr num ambiente onde o modo invariante à globalização está ativado, por exemplo, alguns contentores Docker, e uma cultura diferente da cultura invariante é especificada.
Ver também
Aplica-se a
GetCultureInfo(String)
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
- Origem:
- CultureInfo.cs
Recupera uma instância em cache e apenas leitura de uma cultura usando o nome de cultura especificado.
public:
static System::Globalization::CultureInfo ^ GetCultureInfo(System::String ^ name);public static System.Globalization.CultureInfo GetCultureInfo(string name);static member GetCultureInfo : string -> System.Globalization.CultureInfoPublic Shared Function GetCultureInfo (name As String) As CultureInfoParâmetros
- name
- String
O nome de uma cultura.
name não diferencia maiúsculas de minúsculas.
Devoluções
Um objeto só CultureInfo de leitura.
Exceções
name é null.
name especifica uma cultura que não é suportada. Consulte a secção Notas para Chamadores para mais informações.
Observações
Para uma lista de nomes de cultura pré-definidos em sistemas Windows, veja a coluna Language tag na lista lista de nomes de línguas/regiões suportados por Windows. Os nomes das culturas seguem o padrão definido pelo BCP 47. Além disso, a partir de Windows 10, name pode ser qualquer etiqueta válida da língua BCP-47.
O GetCultureInfo método recupera um objeto em cache, apenas CultureInfo de leitura. Oferece melhor desempenho do que uma chamada correspondente ao CultureInfo.CultureInfo(String) construtor.
Se name for o nome da cultura atual, o objeto devolvido CultureInfo não reflete quaisquer sobrescrições do utilizador. Isto torna o método adequado para aplicações ou ferramentas servidor que não têm uma conta de utilizador real no sistema e que precisam de carregar múltiplas culturas de forma eficiente.
Se name for String.Empty, o método devolve a cultura invariante. Isto é equivalente a recuperar o valor da InvariantCulture propriedade.
Notas para 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, este método gera um CultureNotFoundException. Começando com aplicações que correm sob .NET Framework 4 ou posteriores Windows 7 ou posteriores, o método tenta recuperar um objeto CultureInfo cujo identificador é name do sistema operativo; se o sistema operativo não suportar essa cultura, e se name não for o nome de uma cultura suplementar ou substituta, O método lança um .
Em versões .NET 6 e posteriores, é lançado um CultureNotFoundException se a aplicação estiver a correr num ambiente onde o modo invariante à globalização está ativado, por exemplo, alguns contentores Docker, e uma cultura diferente da cultura invariante é especificada.
