CultureTypes Enumeração
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.
Define os tipos de listas de cultura que podem ser recuperadas usando o GetCultures(CultureTypes) método.
Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.
public enum class CultureTypes
[System.Flags]
[System.Serializable]
public enum CultureTypes
[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum CultureTypes
[System.Flags]
public enum CultureTypes
[<System.Flags>]
[<System.Serializable>]
type CultureTypes =
[<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CultureTypes =
[<System.Flags>]
type CultureTypes =
Public Enum CultureTypes
- Herança
- Atributos
Campos
| Name | Valor | Description |
|---|---|---|
| NeutralCultures | 1 | Culturas associadas a uma língua mas que não são específicas de um país/região. |
| SpecificCultures | 2 | Culturas específicas de um país/região. |
| InstalledWin32Cultures | 4 | Este membro está obsoleto. Todas as culturas que estão instaladas no sistema operativo Windows. |
| AllCultures | 7 | Todas as culturas reconhecidas por .NET, incluindo culturas neutras e específicas e culturas personalizadas criadas pelo utilizador. No .NET Framework 4 e versões posteriores e no .NET Core a correr no Windows, inclui os dados de cultura disponíveis do sistema operativo Windows. No .NET Core a correr em Linux e macOS, inclui dados de cultura definidos nas bibliotecas ICU. AllCultures é um corpo composto que inclui os NeutralCultures, SpecificCultures, e InstalledWin32Cultures valores. |
| UserCustomCulture | 8 | Este membro está obsoleto. Culturas personalizadas criadas pelo utilizador. |
| ReplacementCultures | 16 | Este membro está obsoleto. Culturas personalizadas criadas pelo utilizador que substituem culturas enviadas com o .NET Framework. |
| WindowsOnlyCultures | 32 | Este membro está desatualizado e é ignorado. |
| FrameworkCultures | 64 | Este membro está obsoleto; usar este valor com GetCultures(CultureTypes) retorna culturas neutras e específicas enviadas com .NET Framework 2.0. |
Exemplos
O exemplo seguinte demonstra o CultureTypes.AllCultures elemento de enumeração e a CultureTypes propriedade.
using System;
using System.Globalization;
class Sample
{
public static void Main()
{
// Get and enumerate all cultures.
var allCultures = CultureInfo.GetCultures(CultureTypes.AllCultures);
foreach (var ci in allCultures)
{
// Display the name of each culture.
Console.Write($"{ci.EnglishName} ({ci.Name}): ");
// Indicate the culture type.
if (ci.CultureTypes.HasFlag(CultureTypes.NeutralCultures))
Console.Write(" NeutralCulture");
if (ci.CultureTypes.HasFlag(CultureTypes.SpecificCultures))
Console.Write(" SpecificCulture");
Console.WriteLine();
}
}
}
/*
The following is a portion of the output from this example.
Tajik (tg): NeutralCulture
Tajik (Cyrillic) (tg-Cyrl): NeutralCulture
Tajik (Cyrillic, Tajikistan) (tg-Cyrl-TJ): SpecificCulture
Thai (th): NeutralCulture
Thai (Thailand) (th-TH): SpecificCulture
Tigrinya (ti): NeutralCulture
Tigrinya (Eritrea) (ti-ER): SpecificCulture
Tigrinya (Ethiopia) (ti-ET): SpecificCulture
Tigre (tig): NeutralCulture
Tigre (Eritrea) (tig-ER): SpecificCulture
Turkmen (tk): NeutralCulture
Turkmen (Turkmenistan) (tk-TM): SpecificCulture
Setswana (tn): NeutralCulture
Setswana (Botswana) (tn-BW): SpecificCulture
Setswana (South Africa) (tn-ZA): SpecificCulture
*/
Imports System.Globalization
Module Module1
Public Sub Main()
' Get and enumerate all cultures.
Dim allCultures = CultureInfo.GetCultures(CultureTypes.AllCultures)
For Each ci In allCultures
' Display the name of each culture.
Console.Write($"{ci.EnglishName} ({ci.Name}): ")
' Indicate the culture type.
If ci.CultureTypes.HasFlag(CultureTypes.NeutralCultures) Then
Console.Write(" NeutralCulture")
End If
If ci.CultureTypes.HasFlag(CultureTypes.SpecificCultures) Then
Console.Write(" SpecificCulture")
End If
Console.WriteLine()
Next
End Sub
End Module
' The following is a portion of the output from this example.
' Tajik (tg): NeutralCulture
' Tajik (Cyrillic) (tg-Cyrl): NeutralCulture
' Tajik (Cyrillic, Tajikistan) (tg-Cyrl-TJ): SpecificCulture
' Thai (th): NeutralCulture
' Thai (Thailand) (th-TH): SpecificCulture
' Tigrinya (ti): NeutralCulture
' Tigrinya (Eritrea) (ti-ER): SpecificCulture
' Tigrinya (Ethiopia) (ti-ET): SpecificCulture
' Tigre (tig): NeutralCulture
' Tigre (Eritrea) (tig-ER): SpecificCulture
' Turkmen (tk): NeutralCulture
' Turkmen (Turkmenistan) (tk-TM): SpecificCulture
' Setswana (tn): NeutralCulture
' Setswana (Botswana) (tn-BW): SpecificCulture
' Setswana (South Africa) (tn-ZA): SpecificCulture
O exemplo seguinte apresenta várias propriedades das culturas neutras.
using System;
using System.Globalization;
public class SamplesCultureInfo
{
public static void Main()
{
// Displays several properties of the neutral cultures.
Console.WriteLine("CULTURE ISO ISO WIN DISPLAYNAME ENGLISHNAME");
foreach (CultureInfo ci in CultureInfo.GetCultures(CultureTypes.NeutralCultures))
{
Console.Write("{0,-7}", ci.Name);
Console.Write(" {0,-3}", ci.TwoLetterISOLanguageName);
Console.Write(" {0,-3}", ci.ThreeLetterISOLanguageName);
Console.Write(" {0,-3}", ci.ThreeLetterWindowsLanguageName);
Console.Write(" {0,-40}", ci.DisplayName);
Console.WriteLine(" {0,-40}", ci.EnglishName);
}
}
}
/*
This code produces the following output. This output has been cropped for brevity.
CULTURE ISO ISO WIN DISPLAYNAME ENGLISHNAME
ar ar ara ARA Arabic Arabic
bg bg bul BGR Bulgarian Bulgarian
ca ca cat CAT Catalan Catalan
cs cs ces CSY Czech Czech
da da dan DAN Danish Danish
de de deu DEU German German
el el ell ELL Greek Greek
en en eng ENU English English
es es spa ESP Spanish Spanish
fi fi fin FIN Finnish Finnish
zh zh zho CHS Chinese Chinese
zh-Hans zh zho CHS Chinese (Simplified) Chinese (Simplified)
zh-Hant zh zho ZHH Chinese (Traditional) Chinese (Traditional)
Note: zh-Hant returns ZHH when using ICU (default). When NLS mode is enabled, it returns CHT.
*/
' Displays several properties of the neutral cultures.
Console.WriteLine("CULTURE ISO ISO WIN DISPLAYNAME ENGLISHNAME")
Dim ci As CultureInfo
For Each ci In CultureInfo.GetCultures(CultureTypes.NeutralCultures)
Console.Write("{0,-7}", ci.Name)
Console.Write(" {0,-3}", ci.TwoLetterISOLanguageName)
Console.Write(" {0,-3}", ci.ThreeLetterISOLanguageName)
Console.Write(" {0,-3}", ci.ThreeLetterWindowsLanguageName)
Console.Write(" {0,-40}", ci.DisplayName)
Console.WriteLine(" {0,-40}", ci.EnglishName)
Next ci
'This code produces the following output. This output has been cropped for brevity.
'
'CULTURE ISO ISO WIN DISPLAYNAME ENGLISHNAME
'ar ar ara ARA Arabic Arabic
'bg bg bul BGR Bulgarian Bulgarian
'ca ca cat CAT Catalan Catalan
'cs cs ces CSY Czech Czech
'da da dan DAN Danish Danish
'de de deu DEU German German
'el el ell ELL Greek Greek
'en en eng ENU English English
'es es spa ESP Spanish Spanish
'fi fi fin FIN Finnish Finnish
'zh zh zho CHS Chinese Chinese
'zh-Hans zh zho CHS Chinese (Simplified) Chinese (Simplified)
'zh-Hant zh zho ZHH Chinese (Traditional) Chinese (Traditional)
'
'Note: zh-Hant returns ZHH when using ICU (default). When NLS mode is enabled, it returns CHT.
Observações
Estes valores de tipo de cultura são devolvidos pela CultureInfo.CultureTypes propriedade e também servem como filtro que limita as culturas devolvidas pelo CultureInfo.GetCultures método. Para mais informações sobre culturas, veja CultureInfo.
Geralmente, enumeras todas as culturas usando o CultureTypes.AllCultures valor. Isto permite enumerar culturas personalizadas, bem como outros tipos culturais.
Note-se que todos CultureTypes os membros foram descontinuados, exceto , CultureTypes.AllCulturesCultureTypes.NeutralCultures, e CultureTypes.SpecificCultures.
.NET reconhece os seguintes tipos de cultura, todos incluídos nas enumerações devolvidas pelo membro de enumeração CultureTypes.AllTypes:
Culturas específicas, que especificam um país/região e uma língua. Os nomes destas culturas seguem o RFC 4646. O formato é
<languagecode2>-<country/regioncode2>, onde<languagecode2>é um código de duas letras minúsculas derivado da ISO 639-1, e<country/regioncode2>é um código de duas letras maiúsculas derivado da ISO 3166. Por exemplo, "en-US" para inglês (Estados Unidos) é uma cultura específica. Culturas personalizadas específicas (isto é, culturas que são de aplicação em vez de definidas por sistema) podem ter qualquer nome especificado pelo utilizador, não apenas um nome compatível com os padrões.Culturas neutras, que especificam uma língua sem respeito a um país/região. Os nomes das culturas neutras consistem no código minúsculo de duas letras derivado da ISO 639-1. Por exemplo: "en" (inglês) é uma cultura neutra. Culturas personalizadas neutras (isto é, culturas que são definidas por aplicações e não por sistema) podem ter qualquer nome especificado pelo utilizador, não apenas um código de duas letras.
A cultura invariante está incluída no array de culturas devolvidas pelo CultureInfo.GetCultures método que especifica este valor.
Culturas personalizadas, que são culturas definidas pela aplicação. As culturas personalizadas podem representar culturas específicas ou culturas neutras e podem ter qualquer nome especificado pela aplicação.
Em Windows versões anteriores à Windows 10, o valor
UserCustomCultureé atribuído a culturas personalizadas criadas pelo programador. Em Windows 10, o valorUserCustomCultureé também atribuído a culturas do sistema que não são suportadas por um conjunto completo de dados culturais e que não possuem identificadores locais únicos. (Todas as culturas do tipoUserCustomCulturepartilham um CultureInfo.LCID valor deLOCALE_CUSTOM_UNSPECIFIED(0x1000, ou 4096)). Como resultado, o métodoCultureInfo.GetCultures(CultureTypes.UserCustomCulture)devolve diferentes conjuntos de culturas em diferentes versões Windows.