CultureInfo.GetCultureInfo Método

Definição

Recupera uma instância em cache, somente leitura de uma cultura.Retrieves a cached, read-only instance of a culture.

Sobrecargas

GetCultureInfo(String, Boolean)

Recupera uma instância em cache, somente leitura de uma cultura.Retrieves a cached, read-only instance of a culture.

GetCultureInfo(String, String)

Recupera uma instância em cache, somente leitura de uma cultura.Retrieves a cached, read-only instance of a culture. Os parâmetros especificam uma cultura que é inicializada com os objetos TextInfo e CompareInfo especificados por outra cultura.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

GetCultureInfo(Int32)

Recupera uma instância somente leitura armazenada em cache de uma cultura usando o identificador de cultura especificado.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

GetCultureInfo(String)

Recupera uma instância armazenada em cache somente leitura de uma cultura usando o nome da cultura especificada.Retrieves a cached, read-only instance of a culture using the specified culture name.

GetCultureInfo(String, Boolean)

Recupera uma instância em cache, somente leitura de uma cultura.Retrieves a cached, read-only instance of a culture.

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.The name of a culture. Não diferencia maiúsculas de minúsculas.It is not case-sensitive.

predefinedOnly
Boolean

true se estiver solicitando a criação de uma instância de uma cultura conhecida pela plataforma.true if requesting to create an instance of a culture that is known by the platform. false se for possível recuperar uma cultura criada, mesmo que a plataforma não transporte dados para ela.false if it is ok to retreive a made-up culture even if the platform does not carry data for it.

Retornos

CultureInfo

Uma instância somente leitura de uma cultura.A read-only instance of a culture.

Comentários

Por padrão, ao tentar criar qualquer cultura e a plataforma subjacente (NLS ou ICU do Windows) não carrega dados específicos para essa cultura, a plataforma tentará construir uma cultura com dados de outras culturas ou alguns valores constantes.By default, when trying to create any culture and the underlying platform (Windows NLS or ICU) does not carry specific data for this culture, the platform will try constructing a culture with data from other cultures or some constant values.

predefinedOnlyA configuração para true garantirá que uma cultura será criada somente se a plataforma tiver dados reais para essa cultura.Setting predefinedOnly to true will ensure a culture is created only if the platform has real data for that culture.

GetCultureInfo(String, String)

Recupera uma instância em cache, somente leitura de uma cultura.Retrieves a cached, read-only instance of a culture. Os parâmetros especificam uma cultura que é inicializada com os objetos TextInfo e CompareInfo especificados por outra cultura.Parameters specify a culture that is initialized with the TextInfo and CompareInfo objects specified by another culture.

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.The name of a culture. name não diferencia maiúsculas de minúsculas.name is not case-sensitive.

altName
String

O nome de uma cultura que fornece os objetos TextInfo e CompareInfo usados para inicializar name.The name of a culture that supplies the TextInfo and CompareInfo objects used to initialize name. altName não diferencia maiúsculas de minúsculas.altName is not case-sensitive.

Retornos

CultureInfo

Um objeto somente leitura de CultureInfo .A read-only CultureInfo object.

Exceções

name ou altName é nulo.name or altName is null.

name ou altName especifica uma cultura que não tem suporte.name or altName specifies a culture that is not supported. 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 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.

O GetCultureInfo método obtém um objeto armazenado em cache e somente leitura CultureInfo .The GetCultureInfo method obtains a cached, read-only CultureInfo object. Ele oferece um desempenho melhor do que uma chamada correspondente a um CultureInfo Construtor.It offers better performance than a corresponding call to a CultureInfo constructor. O método é usado para criar uma cultura semelhante àquela especificada pelo name parâmetro, mas com diferentes regras de classificação e maiúsculas e minúsculas.The method is used to create a culture similar to that specified by the name parameter, but with different sorting and casing rules.

Se name ou altName for o nome da cultura atual, os objetos retornados não refletirão as substituições do usuário.If name or altName is the name of the current culture, the returned objects do not reflect any user overrides. Se name for String.Empty , o método retornará a cultura invariável.If name is String.Empty, the method returns the invariant culture. Isso é equivalente a recuperar o valor da InvariantCulture propriedade.This is equivalent to retrieving the value of the InvariantCulture property. Se altName for String.Empty , o método usará o sistema de escrita e as regras de comparação especificadas pela cultura invariável.If altName is String.Empty, the method uses the writing system and comparison rules specified by the invariant culture.

Notas aos Chamadores

O .NET Framework 3.5.NET Framework 3.5 e versões anteriores lançam um ArgumentException If name ou altName 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 or altName is not a valid culture name. A partir do .NET Framework 4.NET Framework 4 , esse método gera um CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. A partir de aplicativos que são executados no .NET Framework 4.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 oferecer suporte a essa cultura, e se name não for o nome de uma cultura suplementar ou de substituição, o método lançará uma CultureNotFoundException 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 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. A partir de aplicativos que são executados no .NET Framework 4.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 oferecer suporte a essa cultura, e se name não for o nome de uma cultura suplementar ou de substituição, o método lançará uma CultureNotFoundException 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 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.

Confira também

GetCultureInfo(Int32)

Recupera uma instância somente leitura armazenada em cache de uma cultura usando o identificador de cultura especificado.Retrieves a cached, read-only instance of a culture by using the specified culture identifier.

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).A locale identifier (LCID).

Retornos

CultureInfo

Um objeto somente leitura de CultureInfo .A read-only CultureInfo object.

Exceções

culture é menor que zero.culture is less than zero.

culture especifica uma cultura que não tem suporte.culture specifies a culture that is not supported. Para obter mais informações, consulte a seção Observações para chamadores.See the Notes to Caller section for more information.

Comentários

Recomendamos que você use a sobrecarga de cadeia de caracteres desse método ( GetCultureInfo(String) ), porque os nomes de localidade devem ser usados em vez de LCIDs.We recommend that you use the string overload of this method (GetCultureInfo(String)), because locale names should be used instead of LCIDs. Para localidades personalizadas, o nome da localidade é necessário.For custom locales, the locale name is required.

Se culture for o identificador de localidade da cultura atual, o objeto retornado não CultureInfo refletirá nenhuma substituição de usuário.If culture is the locale identifier of the current culture, the returned CultureInfo object does not reflect any user overrides.

Notas aos Chamadores

O .NET Framework 3.5.NET Framework 3.5 e versões anteriores geram um ArgumentException If que culture 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 método gera um CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. A partir de aplicativos que são executados no .NET Framework 4.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 oferecer suporte a essa cultura, o método lançará um CultureNotFoundException .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.

Confira também

GetCultureInfo(String)

Recupera uma instância armazenada em cache somente leitura de uma cultura usando o nome da cultura especificada.Retrieves a cached, read-only instance of a culture using the specified culture name.

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.The name of a culture. name não diferencia maiúsculas de minúsculas.name is not case-sensitive.

Retornos

CultureInfo

Um objeto somente leitura de CultureInfo .A read-only CultureInfo object.

Exceções

name é nulo.name is null.

name especifica uma cultura que não tem suporte.name specifies a culture that is not supported. 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 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.

O GetCultureInfo método recupera um objeto armazenado em cache e somente leitura CultureInfo .The GetCultureInfo method retrieves a cached, read-only CultureInfo object. Ele oferece um desempenho melhor do que uma chamada correspondente ao CultureInfo.CultureInfo(String) Construtor.It offers better performance than a corresponding call to the CultureInfo.CultureInfo(String) constructor.

Se name for o nome da cultura atual, o objeto retornado CultureInfo não refletirá nenhuma substituição do usuário.If name is the name of the current culture, the returned CultureInfo object does not reflect any user overrides. 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.This makes the method suitable for server applications or tools that do not have a real user account on the system and that need to load multiple cultures efficiently.

Se name for String.Empty , o método retornará a cultura invariável.If name is String.Empty, the method returns the invariant culture. Isso é equivalente a recuperar o valor da InvariantCulture propriedade.This is equivalent to retrieving the value of the InvariantCulture property.

Notas aos Chamadores

O .NET Framework 3.5.NET Framework 3.5 e versões anteriores lançam um ArgumentException If que name 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 método gera um CultureNotFoundException .Starting with the .NET Framework 4.NET Framework 4, this method throws a CultureNotFoundException. A partir de aplicativos que são executados no .NET Framework 4.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 oferecer suporte a essa cultura, e se name não for o nome de uma cultura suplementar ou de substituição, o método lançará um CultureNotFoundException .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 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.

Confira também

Aplica-se a