CultureInfo Classe
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.
Fornece informações sobre uma cultura específica (chamada de localidade para desenvolvimento de código não gerenciado). As informações incluem os nomes para a cultura, o sistema de gravação, o calendário usado, a ordem de classificação de cadeias de caracteres e a formatação para datas e números.
public ref class CultureInfo : IFormatProvider
public ref class CultureInfo : ICloneable, IFormatProvider
public class CultureInfo : IFormatProvider
public class CultureInfo : ICloneable, IFormatProvider
[System.Serializable]
public class CultureInfo : ICloneable, IFormatProvider
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class CultureInfo : ICloneable, IFormatProvider
type CultureInfo = class
interface IFormatProvider
type CultureInfo = class
interface ICloneable
interface IFormatProvider
[<System.Serializable>]
type CultureInfo = class
interface ICloneable
interface IFormatProvider
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CultureInfo = class
interface ICloneable
interface IFormatProvider
Public Class CultureInfo
Implements IFormatProvider
Public Class CultureInfo
Implements ICloneable, IFormatProvider
- Herança
-
CultureInfo
- Atributos
- Implementações
Comentários
Para obter mais informações sobre essa API, consulte comentários da API Complementar para CultureInfo.
Exemplo
O exemplo a seguir mostra como criar um CultureInfo objeto para espanhol (Espanha) com a classificação internacional e outro CultureInfo objeto com a classificação tradicional.
using System;
using System.Globalization;
public class SamplesCultureInfo
{
public static void Main()
{
// Creates and initializes the CultureInfo which uses the international sort.
CultureInfo myCIintl = new CultureInfo("es-ES", false);
// Creates and initializes the CultureInfo which uses the traditional sort.
CultureInfo myCItrad = new CultureInfo(0x040A, false);
// Displays the properties of each culture.
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL");
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl.CompareInfo, myCItrad.CompareInfo);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl.DisplayName, myCItrad.DisplayName);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl.EnglishName, myCItrad.EnglishName);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl.IsNeutralCulture, myCItrad.IsNeutralCulture);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl.IsReadOnly, myCItrad.IsReadOnly);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "LCID", myCIintl.LCID, myCItrad.LCID);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Name", myCIintl.Name, myCItrad.Name);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl.NativeName, myCItrad.NativeName);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Parent", myCIintl.Parent, myCItrad.Parent);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl.TextInfo, myCItrad.TextInfo);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl.ThreeLetterISOLanguageName, myCItrad.ThreeLetterISOLanguageName);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl.ThreeLetterWindowsLanguageName, myCItrad.ThreeLetterWindowsLanguageName);
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl.TwoLetterISOLanguageName, myCItrad.TwoLetterISOLanguageName);
Console.WriteLine();
// Compare two strings using myCIintl.
Console.WriteLine("Comparing \"llegar\" and \"lugar\"");
Console.WriteLine(" With myCIintl.CompareInfo.Compare: {0}", myCIintl.CompareInfo.Compare("llegar", "lugar"));
Console.WriteLine(" With myCItrad.CompareInfo.Compare: {0}", myCItrad.CompareInfo.Compare("llegar", "lugar"));
}
}
/*
This code produces the following output.
PROPERTY INTERNATIONAL TRADITIONAL
CompareInfo CompareInfo - es-ES CompareInfo - es-ES_tradnl
DisplayName Spanish (Spain) Spanish (Spain)
EnglishName Spanish (Spain, International Sort) Spanish (Spain, Traditional Sort)
IsNeutralCulture False False
IsReadOnly False False
LCID 3082 1034
Name es-ES es-ES
NativeName Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
Parent es es
TextInfo TextInfo - es-ES TextInfo - es-ES_tradnl
ThreeLetterISOLanguageName spa spa
ThreeLetterWindowsLanguageName ESN ESP
TwoLetterISOLanguageName es es
Comparing "llegar" and "lugar"
With myCIintl.CompareInfo.Compare: -1
With myCItrad.CompareInfo.Compare: 1
*/
Imports System.Collections
Imports System.Globalization
Module Module1
Public Sub Main()
' Creates and initializes the CultureInfo which uses the international sort.
Dim myCIintl As New CultureInfo("es-ES", False)
' Creates and initializes the CultureInfo which uses the traditional sort.
Dim myCItrad As New CultureInfo(&H40A, False)
' Displays the properties of each culture.
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "PROPERTY", "INTERNATIONAL", "TRADITIONAL")
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "CompareInfo", myCIintl.CompareInfo, myCItrad.CompareInfo)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "DisplayName", myCIintl.DisplayName, myCItrad.DisplayName)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "EnglishName", myCIintl.EnglishName, myCItrad.EnglishName)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsNeutralCulture", myCIintl.IsNeutralCulture, myCItrad.IsNeutralCulture)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "IsReadOnly", myCIintl.IsReadOnly, myCItrad.IsReadOnly)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "LCID", myCIintl.LCID, myCItrad.LCID)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Name", myCIintl.Name, myCItrad.Name)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "NativeName", myCIintl.NativeName, myCItrad.NativeName)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "Parent", myCIintl.Parent, myCItrad.Parent)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TextInfo", myCIintl.TextInfo, myCItrad.TextInfo)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterISOLanguageName", myCIintl.ThreeLetterISOLanguageName, myCItrad.ThreeLetterISOLanguageName)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "ThreeLetterWindowsLanguageName", myCIintl.ThreeLetterWindowsLanguageName, myCItrad.ThreeLetterWindowsLanguageName)
Console.WriteLine("{0,-31}{1,-47}{2,-25}", "TwoLetterISOLanguageName", myCIintl.TwoLetterISOLanguageName, myCItrad.TwoLetterISOLanguageName)
Console.WriteLine()
' Compare two strings using myCIintl.
Console.WriteLine("Comparing ""llegar"" and ""lugar""")
Console.WriteLine(" With myCIintl.CompareInfo.Compare: {0}", myCIintl.CompareInfo.Compare("llegar", "lugar"))
Console.WriteLine(" With myCItrad.CompareInfo.Compare: {0}", myCItrad.CompareInfo.Compare("llegar", "lugar"))
End Sub
'This code produces the following output.
'
'PROPERTY INTERNATIONAL TRADITIONAL
'CompareInfo CompareInfo - es-ES CompareInfo - es-ES_tradnl
'DisplayName Spanish (Spain) Spanish (Spain)
'EnglishName Spanish (Spain, International Sort) Spanish (Spain, Traditional Sort)
'IsNeutralCulture False False
'IsReadOnly False False
'LCID 3082 1034
'Name es-ES es-ES
'NativeName Español (España, alfabetización internacional) Español (España, alfabetización tradicional)
'Parent es es
'TextInfo TextInfo - es-ES TextInfo - es-ES_tradnl
'ThreeLetterISOLanguageName spa spa
'ThreeLetterWindowsLanguageName ESN ESP
'TwoLetterISOLanguageName es es
'
'Comparing "llegar" and "lugar"
' With myCIintl.CompareInfo.Compare: -1
' With myCItrad.CompareInfo.Compare: 1
End Module
Construtores
| Nome | Description |
|---|---|
| CultureInfo(Int32, Boolean) |
Inicializa uma nova instância da CultureInfo classe com base na cultura especificada pelo identificador de cultura e em um valor que especifica se as configurações de cultura selecionadas pelo usuário do Windows devem ser usadas. |
| CultureInfo(Int32) |
Inicializa uma nova instância da CultureInfo classe com base na cultura especificada pelo identificador de cultura. |
| CultureInfo(String, Boolean) |
Inicializa uma nova instância da CultureInfo classe com base na cultura especificada pelo nome e em um valor que especifica se as configurações de cultura selecionadas pelo usuário do Windows devem ser usadas. |
| CultureInfo(String) |
Inicializa uma nova instância da CultureInfo classe com base na cultura especificada pelo nome. |
Propriedades
| Nome | Description |
|---|---|
| Calendar |
Obtém o calendário padrão usado pela cultura. |
| CompareInfo |
Obtém o CompareInfo que define como comparar cadeias de caracteres para a cultura. |
| CultureTypes |
Obtém os tipos de cultura que pertencem ao objeto atual CultureInfo . |
| CurrentCulture |
Obtém ou define o CultureInfo objeto que representa a cultura usada pelo thread atual e operações assíncronas baseadas em tarefas. |
| CurrentUICulture |
Obtém ou define o objeto CultureInfo que representa a cultura de interface do usuário atual usada pelo Resource Manager para pesquisar recursos específicos da cultura em tempo de execução. |
| DateTimeFormat |
Obtém ou define um DateTimeFormatInfo que define o formato culturalmente apropriado da exibição de datas e horas. |
| DefaultThreadCurrentCulture |
Obtém ou define a cultura padrão para threads no domínio do aplicativo atual. |
| DefaultThreadCurrentUICulture |
Obtém ou define a cultura de interface do usuário padrão para threads no domínio do aplicativo atual. |
| DisplayName |
Obtém o nome completo da cultura localizada. |
| EnglishName |
Obtém o nome da cultura no formato languagefull [country/regionfull] em inglês. |
| IetfLanguageTag |
Preterido. Obtém a identificação padrão RFC 4646 para um idioma. |
| InstalledUICulture |
Obtém o CultureInfo que representa a cultura instalada com o sistema operacional. |
| InvariantCulture |
Obtém o CultureInfo objeto que é independente de cultura (invariável). |
| IsNeutralCulture |
Obtém um valor que indica se a corrente CultureInfo representa uma cultura neutra. |
| IsReadOnly |
Obtém um valor que indica se a corrente CultureInfo é somente leitura. |
| KeyboardLayoutId |
Obtém o identificador de localidade de entrada ativo. |
| LCID |
Obtém o identificador de cultura para o atual CultureInfo. |
| Name |
Obtém o nome da cultura no formato languagecode2-country/regioncode2. |
| NativeName |
Obtém o nome da cultura, que consiste no idioma, no país/região e no script opcional, que a cultura está definida para ser exibida. |
| NumberFormat |
Obtém ou define um NumberFormatInfo que define o formato culturalmente apropriado de exibir números, moeda e porcentagem. |
| OptionalCalendars |
Obtém a lista de calendários que podem ser usados pela cultura. |
| Parent |
Obtém o CultureInfo que representa a cultura pai do atual CultureInfo. |
| TextInfo |
Obtém o TextInfo que define o sistema de gravação associado à cultura. |
| ThreeLetterISOLanguageName |
Obtém o código de três letras ISO 639-2 para o idioma do atual CultureInfo. |
| ThreeLetterWindowsLanguageName |
Obtém o código de três letras para o idioma conforme definido na API de Windows. |
| TwoLetterISOLanguageName |
Obtém o código de três letras ISO 639-1 ou ISO 639-3 para o idioma atual CultureInfo. |
| UseUserOverride |
Obtém um valor que indica se o objeto atual CultureInfo usa as configurações de cultura selecionadas pelo usuário. |
Métodos
| Nome | Description |
|---|---|
| ClearCachedData() |
Atualiza informações relacionadas à cultura armazenadas em cache. |
| Clone() |
Cria uma cópia do CultureInfoatual. |
| CreateSpecificCulture(String) |
Cria um CultureInfo que representa a cultura específica associada ao nome especificado. |
| Equals(Object) |
Determina se o objeto especificado é a mesma cultura que a atual CultureInfo. |
| GetConsoleFallbackUICulture() |
Obtém uma cultura de interface do usuário alternativa adequada para aplicativos de console quando a cultura padrão da interface do usuário gráfica é inadequada. |
| GetCultureInfo(Int32) |
Recupera uma instância armazenada em cache e somente leitura de uma cultura usando o identificador de cultura especificado. |
| 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 inicializada com os objetos e TextInfo objetos CompareInfo especificados por outra cultura. |
| GetCultureInfo(String) |
Recupera uma instância armazenada em cache e somente leitura de uma cultura usando o nome de cultura especificado. |
| GetCultureInfoByIetfLanguageTag(String) |
Preterido. Recupera um objeto somente CultureInfo leitura com características linguísticas que são identificadas pela marca de idioma RFC 4646 especificada. |
| GetCultures(CultureTypes) |
Obtém a lista de culturas com suporte filtradas pelo parâmetro especificado CultureTypes . |
| GetFormat(Type) |
Obtém um objeto que define como formatar o tipo especificado. |
| GetHashCode() |
Serve como uma função de hash para a atual CultureInfo, adequada para algoritmos de hash e estruturas de dados, como uma tabela de hash. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ReadOnly(CultureInfo) |
Retorna um wrapper somente leitura ao redor do objeto especificado CultureInfo . |
| ToString() |
Retorna uma cadeia de caracteres que contém o nome do atual CultureInfo no formato languagecode2-country/regioncode2. |