Exporter (0) Imprimer
Développer tout

CultureInfo.CreateSpecificCulture, méthode

Crée un CultureInfo qui représente la culture spécifique associée au nom spécifié.

Espace de noms : System.Globalization
Assembly : mscorlib (dans mscorlib.dll)

public static CultureInfo CreateSpecificCulture (
	string name
)
public static CultureInfo CreateSpecificCulture (
	String name
)
public static function CreateSpecificCulture (
	name : String
) : CultureInfo

Paramètres

name

Nom CultureInfo prédéfini ou nom d'un CultureInfo existant.

Valeur de retour

CultureInfo représentant : La culture dite indifférente, si name est une chaîne vide (""). - ou - La culture spécifique associée à name, si name est une culture neutre. - ou - La culture spécifiée par name, si name est déjà une culture spécifique.

Type d'exceptionCondition

ArgumentNullException

name est référence Null (Nothing en Visual Basic).

ArgumentException

name n'est pas un nom de culture valide.

- ou -

Aucune culture spécifique n'est associée à la culture spécifiée par name. par exemple "zh-CHS" ou "zh-CHT".

Les cultures sont généralement regroupées en trois jeux : la culture dite indifférente, les cultures neutres et les cultures spécifiques.

La culture dite indifférente est non dépendante de la culture. Vous pouvez spécifier la culture dite indifférente par son nom à l'aide d'une chaîne vide ("") ou par son identificateur de culture 0x007F. InvariantCulture récupère une instance de la culture dite indifférente. Elle est associée à la langue anglaise, mais n'est associée à aucun pays/à aucune région. Elle peut être utilisée dans quasiment n'importe quelle méthode de l'espace de noms Globalization requérant une culture.

Une culture neutre est associée à une langue, mais elle n'est associée à aucun pays/à aucune région. En revanche, une culture spécifique est associée à la fois à une langue et à un pays ou une région. Par exemple, "fr" est une culture neutre et "fr-FR" est une culture spécifique. Notez que "zh-CHS" (Chinois simplifié) et "zh-CHT" (Chinois traditionnel) sont des cultures neutres.

Les cultures ont une hiérarchie telle que le parent d'une culture spécifique est une culture neutre et le parent d'une culture neutre est InvariantCulture. La propriété Parent retourne la culture neutre associée à une culture spécifique.

Si les ressources de la culture spécifique ne sont pas disponibles dans le système, les ressources de la culture neutre sont utilisées ; si les ressources de la culture neutre ne sont pas disponibles, les ressources incorporées dans l'assembly principal sont utilisées. Pour plus d'informations sur le processus de secours pour les ressources, consultez Empaquetage et déploiement de ressources.

La liste des cultures dans l'API Windows est légèrement différente de la liste des cultures dans le .NET Framework. Par exemple, la culture neutre zh-CHT "Chinois (Traditionnel)" avec l'identificateur de culture 0x7C04 n'est pas disponible dans l'API Windows. Si l'interopérabilité avec Windows est nécessaire (par exemple, via le mécanisme p/invoke), utilisez une culture spécifique définie dans le système d'exploitation. Cela garantira la cohérence avec les paramètres régionaux Windows équivalents, identifiés par le même LCID.

L'exemple de code suivant illustre les résultats de CreateSpecificCulture avec différents types de culture.

using System;
using System.Globalization;

public class SamplesCultureInfo  {

   public static void Main()  {

      // Prints the header.
      Console.WriteLine( "CULTURE                                              SPECIFIC CULTURE" );

      // Determines the specific culture associated with each culture in the .NET Framework.
      foreach ( CultureInfo ci in CultureInfo.GetCultures( CultureTypes.AllCultures ) )  {
         Console.Write( "{0,-12} {1,-40}", ci.Name, ci.EnglishName );
         try  {
            Console.WriteLine( "{0}", CultureInfo.CreateSpecificCulture( ci.Name ).Name );
         }
         catch  {
            Console.WriteLine( "(no associated specific culture)" );
         }
      }

   }

}


/*
This code produces the following output.  This output has been cropped for brevity.

CULTURE                                              SPECIFIC CULTURE
ar           Arabic                                  ar-SA
ar-SA        Arabic (Saudi Arabia)                   ar-SA
ar-IQ        Arabic (Iraq)                           ar-IQ
ar-EG        Arabic (Egypt)                          ar-EG
ar-LY        Arabic (Libya)                          ar-LY
ar-DZ        Arabic (Algeria)                        ar-DZ
ar-MA        Arabic (Morocco)                        ar-MA
ar-TN        Arabic (Tunisia)                        ar-TN
ar-OM        Arabic (Oman)                           ar-OM
ar-YE        Arabic (Yemen)                          ar-YE
ar-SY        Arabic (Syria)                          ar-SY
ar-JO        Arabic (Jordan)                         ar-JO
ar-LB        Arabic (Lebanon)                        ar-LB
ar-KW        Arabic (Kuwait)                         ar-KW
ar-AE        Arabic (U.A.E.)                         ar-AE
ar-BH        Arabic (Bahrain)                        ar-BH
ar-QA        Arabic (Qatar)                          ar-QA
bg           Bulgarian                               bg-BG
bg-BG        Bulgarian (Bulgaria)                    bg-BG
ca           Catalan                                 ca-ES
ca-ES        Catalan (Catalan)                       ca-ES
zh-CHS       Chinese (Simplified)                    (no associated specific culture)
zh-TW        Chinese (Taiwan)                        zh-TW
zh-CN        Chinese (People's Republic of China)    zh-CN
zh-HK        Chinese (Hong Kong S.A.R.)              zh-HK
zh-SG        Chinese (Singapore)                     zh-SG
zh-MO        Chinese (Macao S.A.R.)                  zh-MO
zh-CHT       Chinese (Traditional)                   (no associated specific culture)
cs           Czech                                   cs-CZ
cs-CZ        Czech (Czech Republic)                  cs-CZ
da           Danish                                  da-DK
da-DK        Danish (Denmark)                        da-DK

*/

import System.* ;
import System.Globalization.* ;

public class SamplesCultureInfo
{
    public static void main(String[] args)
    {
        // Prints the header.
        Console.WriteLine("CULTURE                                            "
            + " SPECIFIC CULTURE");
        
        // Determines the specific culture associated with each culture in the 
        // .NET Framework.
        for (int iCtr = 0; 
            iCtr < (CultureInfo.GetCultures(CultureTypes.AllCultures).length); 
            iCtr++) {
            CultureInfo ci = 
                CultureInfo.GetCultures(CultureTypes.AllCultures)[iCtr];
            Console.Write("{0,-12} {1,-40}", ci.get_Name(), 
                ci.get_EnglishName());
            try {
                Console.WriteLine("{0}", CultureInfo.CreateSpecificCulture(
                    ci.get_Name()).get_Name());
            }
            catch(System.Exception exp){
                Console.WriteLine("(no associated specific culture)");
            }
        }
    } //main
} //SamplesCultureInfo

/*
This code produces the following output.  This output has been cropped for 
brevity.

CULTURE                                              SPECIFIC CULTURE
ar           Arabic                                  ar-SA
ar-SA        Arabic (Saudi Arabia)                   ar-SA
ar-IQ        Arabic (Iraq)                           ar-IQ
ar-EG        Arabic (Egypt)                          ar-EG
ar-LY        Arabic (Libya)                          ar-LY
ar-DZ        Arabic (Algeria)                        ar-DZ
ar-MA        Arabic (Morocco)                        ar-MA
ar-TN        Arabic (Tunisia)                        ar-TN
ar-OM        Arabic (Oman)                           ar-OM
ar-YE        Arabic (Yemen)                          ar-YE
ar-SY        Arabic (Syria)                          ar-SY
ar-JO        Arabic (Jordan)                         ar-JO
ar-LB        Arabic (Lebanon)                        ar-LB
ar-KW        Arabic (Kuwait)                         ar-KW
ar-AE        Arabic (U.A.E.)                         ar-AE
ar-BH        Arabic (Bahrain)                        ar-BH
ar-QA        Arabic (Qatar)                          ar-QA
bg           Bulgarian                               bg-BG
bg-BG        Bulgarian (Bulgaria)                    bg-BG
ca           Catalan                                 ca-ES
ca-ES        Catalan (Catalan)                       ca-ES
zh-CHS       Chinese (Simplified)                    (no associated specific 
culture)
zh-TW        Chinese (Taiwan)                        zh-TW
zh-CN        Chinese (People's Republic of China)    zh-CN
zh-HK        Chinese (Hong Kong S.A.R.)              zh-HK
zh-SG        Chinese (Singapore)                     zh-SG
zh-MO        Chinese (Macau S.A.R.)                  zh-MO
zh-CHT       Chinese (Traditional)                   (no associated specific 
culture)
cs           Czech                                   cs-CZ
cs-CZ        Czech (Czech Republic)                  cs-CZ
da           Danish                                  da-DK
da-DK        Danish (Denmark)                        da-DK
*/

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft