CultureInfo.GetCultures(CultureTypes) Método

Referencia

Definición

Espacio de nombres:: System.Globalization

Ensamblado:: System.Runtime.dll

Ensamblado:: netstandard.dll

Ensamblado:: mscorlib.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene la lista de referencias culturales admitidas filtradas por el parámetro CultureTypes especificado.

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

Combinación bit a bit de los valores de la enumeración que filtran las referencias culturales que se van a obtener.

Devoluciones

CultureInfo[]

Matriz que contiene las referencias culturales especificadas por el parámetro types. La matriz de referencias culturales no está ordenada.

Excepciones

ArgumentOutOfRangeException

types especifica una combinación no válida de valores de CultureTypes.

Ejemplos

En el ejemplo de código siguiente se muestran varias propiedades de las referencia culturales neutras.

Nota

En el ejemplo se muestran las referencia culturales y zh-CHS con 0x0004 y 0x7C04 de referencia zh-CHT cultural, respectivamente. Sin embargo, las Windows Vista deben usar el nombre en lugar de y el nombre zh-Hans zh-CHS en lugar de zh-Hant zh-CHT. Los nombres y representan el estándar actual y deben usarse a menos que tenga una razón zh-Hans para usar los nombres más zh-Hant antiguos.

using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Displays several properties of the neutral cultures.
   Console::WriteLine( "CULTURE ISO ISO WIN DISPLAYNAME                              ENGLISHNAME" );
   System::Collections::IEnumerator^ enum0 = CultureInfo::GetCultures( CultureTypes::NeutralCultures )->GetEnumerator();
   while ( enum0->MoveNext() )
   {
      CultureInfo^ ci = safe_cast<CultureInfo^>(enum0->Current);
      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                                 
zh-Hans zh  zho CHS Chinese (Simplified)                     Chinese (Simplified)                    
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-Hant zh  zho CHT Chinese (Traditional)                    Chinese (Traditional)                   
zh-CHS  zh  zho CHS Chinese (Simplified) Legacy              Chinese (Simplified) Legacy             
zh-CHT  zh  zho CHT Chinese (Traditional) Legacy             Chinese (Traditional) Legacy            

*/

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
zh-Hans zh  zho CHS Chinese (Simplified)                     Chinese (Simplified)
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-Hant zh  zho CHT Chinese (Traditional)                    Chinese (Traditional)
zh-CHS  zh  zho CHS Chinese (Simplified) Legacy              Chinese (Simplified) Legacy
zh-CHT  zh  zho CHT Chinese (Traditional) Legacy             Chinese (Traditional) Legacy

*/

Imports System.Globalization

Module Module1

   Public Sub Main()

      ' 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

   End Sub



'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                                 
'zh-Hans zh  zho CHS Chinese (Simplified)                     Chinese (Simplified)                    
'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-Hant zh  zho CHT Chinese (Traditional)                    Chinese (Traditional)                   
'zh-CHS  zh  zho CHS Chinese (Simplified) Legacy              Chinese (Simplified) Legacy             
'zh-CHT  zh  zho CHT Chinese (Traditional) Legacy             Chinese (Traditional) Legacy            

End Module

Comentarios

El GetCultures método se llama normalmente con el parámetro establecido en los valores types siguientes:

SpecificCultures, que devuelve todas las referencia culturales específicas.
NeutralCultures, que devuelve todas las referencia culturales neutras y la referencia cultural invariable.
AllCultures, que devuelve todas las referencia culturales neutras y específicas, las referencia culturales instaladas en el sistema Windows y las referencia culturales personalizadas creadas por el usuario.

UserCustomCulture, que devuelve todas las referencia culturales personalizadas, como las registradas por la CultureAndRegionInfoBuilder clase . En las versiones de Windows antes Windows 10, el valor se aplica a todas las referencia culturales UserCustomCulture personalizadas definidas por el usuario. A partir Windows 10, se aplica a las referencia culturales del sistema que carecen de datos culturales completos y que no tienen un identificador local único, como indica el valor LCID de propiedad. Como resultado, el código como el siguiente devolverá resultados diferentes cuando se ejecute en Windows 10 y en una versión anterior de 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

Imports System.Globalization

Module Example
   Sub Main()
       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)
   End Sub
End Module
' 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

Se aplica a

Consulte también

CultureTypes