CultureInfo Classe
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.
Fornece informação sobre uma cultura específica (chamada local para desenvolvimento de código não gerido). A informação inclui os nomes da cultura, o sistema de escrita, o calendário utilizado, a ordem de ordenação das cadeias e a formatação das 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
Observações
Para mais informações sobre esta API, consulte Observações Suplementares da API para o CultureInfo.
Example
O exemplo seguinte mostra como criar um CultureInfo objeto para espanhol (Espanha) com a ordenação internacional e outro CultureInfo objeto com a ordenaçã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
| Name | Description |
|---|---|
| CultureInfo(Int32, Boolean) |
Inicializa uma nova instância da classe CultureInfo com base na cultura especificada pelo identificador de cultura e num valor que especifica se deve usar as definições de cultura selecionadas pelo utilizador a partir de Windows. |
| 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 classe CultureInfo com base na cultura especificada pelo nome e num valor que especifica se deve usar as definições de cultura selecionadas pelo utilizador a partir de Windows. |
| CultureInfo(String) |
Inicializa uma nova instância da CultureInfo classe com base na cultura especificada pelo nome. |
Propriedades
| Name | Description |
|---|---|
| Calendar |
Obtém o calendário padrão usado pela cultura. |
| CompareInfo |
Obtém-se que CompareInfo define como comparar cordas para a cultura. |
| CultureTypes |
Obtém os tipos de cultura que dizem respeito ao objeto atual CultureInfo . |
| CurrentCulture |
Obtém ou define o CultureInfo objeto que representa a cultura usada pelo thread atual e pelas operações assíncronas baseadas em tarefas. |
| CurrentUICulture |
Obtém ou define o objeto CultureInfo que representa a cultura atual da interface de utilizador usada pelo Resource Manager para consultar recursos específicos da cultura em tempo de execução. |
| DateTimeFormat |
Recebe ou define um DateTimeFormatInfo que define o formato culturalmente apropriado para mostrar datas e horas. |
| DefaultThreadCurrentCulture |
Obtém ou define a cultura padrão para threads no domínio de aplicação atual. |
| DefaultThreadCurrentUICulture |
Obtém ou define a cultura de interface padrão para threads no domínio de aplicação atual. |
| DisplayName |
Recebe o nome completo da cultura localizada. |
| EnglishName |
Recebe o nome da cultura no formato languagefull [país/regiãofull] em inglês. |
| IetfLanguageTag |
Deprecated. Obtém a identificação padrão RFC 4646 para uma língua. |
| InstalledUICulture |
Obtém-se que CultureInfo representa a cultura instalada com o sistema operativo. |
| InvariantCulture |
Obtém o CultureInfo objeto que é independente da cultura (invariante). |
| IsNeutralCulture |
Obtém um valor que indica se a corrente CultureInfo representa uma cultura neutra. |
| IsReadOnly |
Recebe um valor que indica se a corrente CultureInfo é apenas de leitura. |
| KeyboardLayoutId |
Obtém o identificador ativo de local de entrada. |
| LCID |
Obtém o identificador de cultura para o atual CultureInfo. |
| Name |
Recebe o nome da cultura no formato languagecode2-country/regioncode2. |
| NativeName |
Recebe o nome da cultura, que consiste na língua, o país/região e a escrita opcional que a cultura deve mostrar. |
| NumberFormat |
Obtém ou define um NumberFormatInfo que define o formato culturalmente apropriado para mostrar números, moeda e percentagem. |
| OptionalCalendars |
Obtém a lista de calendários que podem ser usados pela cultura. |
| Parent |
Obtém-se que CultureInfo representa a cultura-mãe do atual CultureInfo. |
| TextInfo |
Obtém-se o TextInfo que define o sistema de escrita associado à cultura. |
| ThreeLetterISOLanguageName |
Obtém o código de três letras ISO 639-2 para a linguagem atual CultureInfo. |
| ThreeLetterWindowsLanguageName |
Recebe o código de três letras da linguagem conforme definido na API do Windows. |
| TwoLetterISOLanguageName |
Recebe o código ISO 639-1 de duas letras ou ISO 639-3 de três letras para a linguagem atual CultureInfo. |
| UseUserOverride |
Recebe um valor que indica se o objeto atual CultureInfo utiliza as definições de cultura selecionadas pelo utilizador. |
Métodos
| Name | Description |
|---|---|
| ClearCachedData() |
Atualiza informação em cache relacionada com a cultura. |
| Clone() |
Cria uma cópia do atual CultureInfo. |
| CreateSpecificCulture(String) |
Cria um CultureInfo que representa a cultura específica associada ao nome especificado. |
| Equals(Object) |
Determina se o objeto especificado pertence à mesma cultura que o atual CultureInfo. |
| GetConsoleFallbackUICulture() |
Obtém uma cultura alternativa de interface de utilizador adequada para aplicações de consola quando a cultura gráfica padrão da interface não é adequada. |
| GetCultureInfo(Int32) |
Recupera uma instância em cache e apenas leitura de uma cultura usando o identificador de cultura especificado. |
| 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(String) |
Recupera uma instância em cache e apenas leitura de uma cultura usando o nome de cultura especificado. |
| GetCultureInfoByIetfLanguageTag(String) |
Deprecated. Recupera um objeto somente CultureInfo de leitura com características linguísticas identificadas pela etiqueta linguística RFC 4646 especificada. |
| GetCultures(CultureTypes) |
Obtém a lista de culturas suportadas filtrada pelo parâmetro especificado CultureTypes . |
| GetFormat(Type) |
Obtém um objeto que define como formatar o tipo especificado. |
| GetHashCode() |
Serve como função de hash para o atual CultureInfo, adequado 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 atual Object. (Herdado de Object) |
| ReadOnly(CultureInfo) |
Devolve um wrapper de apenas leitura em torno do objeto especificado CultureInfo . |
| ToString() |
Devolve uma string contendo o nome do atual CultureInfo no formato languagecode2-país/regiãocode2. |