CultureInfo Classe

Definição

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.

Aplica-se a

Ver também