CultureInfo.GetCultureInfo Método

Origem:

CultureInfo.cs

Origem:

CultureInfo.cs

Origem:

CultureInfo.cs

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

Retornos

Uma instância somente leitura de uma cultura.

Comentários

Por padrão, ao tentar criar qualquer cultura e a plataforma subjacente (NLS ou ICU do Windows) não transportar dados específicos para essa cultura, a plataforma tentará construir uma cultura com dados de outras culturas ou alguns valores constantes.

Definir predefinedOnly como true garantirá que uma cultura seja criada somente se a plataforma tiver dados reais para essa cultura.

Origem:

CultureInfo.cs

Origem:

CultureInfo.cs

Origem:

CultureInfo.cs

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

Retornos

Um objeto somente leitura de CultureInfo .

Exceções

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, a partir do Windows 10, name pode ser qualquer marca de idioma BCP-47 válida.

O GetCultureInfo método obtém um objeto armazenado em cache e somente leitura CultureInfo . Ele oferece um desempenho melhor do que uma chamada correspondente para um CultureInfo construtor. O método é usado para criar uma cultura semelhante à especificada pelo name parâmetro , mas com regras de classificação e 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 do usuário. Se name for String.Empty, o método retornará a cultura invariável. Isso é equivalente 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

O .NET Framework 3.5 e versões anteriores lançam um ArgumentException se name ou altName não é um nome de cultura válido. A partir do .NET Framework 4, esse método lança um CultureNotFoundException. Começando com aplicativos executados no .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()

Origem:

CultureInfo.cs

Origem:

CultureInfo.cs

Origem:

CultureInfo.cs

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

Retornos

Um objeto somente leitura de CultureInfo .

Exceções

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 do usuário.

Notas aos Chamadores

O .NET Framework 3.5 e versões anteriores lançam um ArgumentException se culture não for um identificador de cultura válido. A partir do .NET Framework 4, esse método lança um CultureNotFoundException. Começando com aplicativos executados no .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 gerará 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()

Origem:

CultureInfo.cs

Origem:

CultureInfo.cs

Origem:

CultureInfo.cs

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

Retornos

Um objeto somente leitura de CultureInfo .

Exceções

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, a partir do Windows 10, name pode ser qualquer marca de idioma BCP-47 válida.

O GetCultureInfo método recupera um objeto armazenado em cache, somente leitura CultureInfo . Ele oferece um desempenho melhor 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 do 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 é equivalente a recuperar o valor da InvariantCulture propriedade .

Notas aos Chamadores

O .NET Framework 3.5 e versões anteriores lançam um ArgumentException se name não for um nome de cultura válido. A partir do .NET Framework 4, esse método lança um CultureNotFoundException. Começando com aplicativos executados no .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á 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