CultureInfo.GetCultureInfo Método

Definição

Namespace:

System.Globalization

Assembly:

System.Runtime.dll

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

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

CultureInfo

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.

GetCultureInfo(String, String)

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

CultureInfo

Um objeto somente leitura de CultureInfo .

Exceções

ArgumentNullException

name ou altName é nulo.

CultureNotFoundException

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

• Name
• ClearCachedData()

GetCultureInfo(Int32)

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

CultureInfo

Um objeto somente leitura de CultureInfo .

Exceções

ArgumentOutOfRangeException

culture é menor que zero.

CultureNotFoundException

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

• LCID
• ClearCachedData()

GetCultureInfo(String)

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

CultureInfo

Um objeto somente leitura de CultureInfo .

Exceções

ArgumentNullException

name é nulo.

CultureNotFoundException

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

• Name