Linguagem

CultureInfo.GetCultures(CultureTypes) Método

Definição

Obtém a lista de culturas suportadas filtrada pelo parâmetro especificado CultureTypes .

public:
 static cli::array <System::Globalization::CultureInfo ^> ^ GetCultures(System::Globalization::CultureTypes types);
public static System.Globalization.CultureInfo[] GetCultures(System.Globalization.CultureTypes types);
static member GetCultures : System.Globalization.CultureTypes -> System.Globalization.CultureInfo[]
Public Shared Function GetCultures (types As CultureTypes) As CultureInfo()

Parâmetros

types
CultureTypes

Uma combinação bit a bit dos valores de enumeração que filtram as culturas para recuperar.

Devoluções

Um array que contém as culturas especificadas pelo types parâmetro. A variedade de culturas é desordenada.

Exceções

types especifica uma combinação inválida de CultureTypes valores.

Exemplos

O seguinte exemplo de código apresenta várias propriedades das culturas neutras.

Note

O exemplo mostra as zh-CHS culturas e zh-CHT com os identificadores de cultura 0x0004 e 0x7C04, respetivamente. No entanto, as suas aplicações Windows Vista devem usar o nome zh-Hans em vez de zh-CHS e o nome zh-Hant em vez de zh-CHT. Os zh-Hans nomes e zh-Hant representam o padrão atual e devem ser usados, a menos que tenha uma razão para usar os nomes mais antigos.

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

O GetCultures método é mais frequentemente chamado com o types parâmetro definido nos seguintes valores:

  • SpecificCultures, que devolve todas as culturas específicas.

  • NeutralCultures, que devolve todas as culturas neutras e a cultura invariante.

  • AllCultures, que devolve todas as culturas neutras e específicas, as culturas instaladas no sistema Windows e as culturas personalizadas criadas pelo utilizador.

  • UserCustomCulture, que devolve todas as culturas personalizadas, como as registadas pela CultureAndRegionInfoBuilder classe. Nas versões de Windows anteriores à Windows 10, o valor UserCustomCulture aplica-se a todas as culturas personalizadas definidas pelo utilizador. Começando por Windows 10, aplica-se a culturas de sistema que não possuem dados culturais completos e que não possuem um identificador local único, conforme indicado pelo valor da propriedade LCID. Como resultado, código como o seguinte devolverá resultados diferentes quando executado no Windows 10 e numa versão anterior do Windows.

    using System;
    using System.Globalization;
    
    public class Example
    {
       public static void Main()
       {
           CultureInfo[] cultures = CultureInfo.GetCultures(CultureTypes.UserCustomCulture |
                                                            CultureTypes.SpecificCultures);
          int ctr = 0;
          foreach (var culture in cultures)
             if ((culture.CultureTypes & CultureTypes.UserCustomCulture) == CultureTypes.UserCustomCulture)
                ctr++;
    
          Console.WriteLine("Number of Specific Custom Cultures: {0}", ctr);
       }
    }
    // If run under Windows 8, the example displays output like the following:
    //      Number of Specific Custom Cultures: 6
    // If run under Windows 10, the example displays output like the following:
    //      Number of Specific Custom Cultures: 279
    
    Dim cultures() As CultureInfo = CultureInfo.GetCultures(CultureTypes.UserCustomCulture Or
                                                           CultureTypes.SpecificCultures)
    Dim ctr As Integer = 0
    For Each culture In cultures
        If (culture.CultureTypes And CultureTypes.UserCustomCulture) = CultureTypes.UserCustomCulture Then
            ctr += 1
        End If
    Next
    Console.WriteLine("Number of Specific Custom Cultures: {0}", ctr)
    
    ' If run under Windows 8, the example displays output like the following:
    '      Number of Specific Custom Cultures: 6
    ' If run under Windows 10, the example displays output like the following:
    '      Number of Specific Custom Cultures: 279
    

Aplica-se a

Ver também