CultureInfoCF 1.0, ECMA 1.0, serializable

System.Globalization (mscorlib.dll)class

The CultureInfo class encapsulates information about handling information according to the special requirements of a particular culture and language. Culture information is identified by language and country/region codes as specified in RFC 1766. For example, U.S. English is identified as en-US. The two-letter, lowercase language codes are defined in ISO 639-1. The two-letter, uppercase region codes are defined in ISO 3166.

The specific CultureInfo to use at runtime can be found in a number of ways. The class provides four public properties that return the current CultureInfo instance. CurrentCulture returns the value of Thread.CurrentCulture, which is the CultureInfo used by the current thread. CurrentUICulture returns the CultureInfo used by the System.Resources.ResourceManager. This can be a user, machine, or application-based locale setting. It is set in Thread.CurrentUICulture. InstalledUICulture gets the default CultureInfo used by the ResourceManager and represents the locale of the Operating system. InvariantCulture returns the CultureInfo for the invariant locale, which is non-culture-specific, as well as in the default OS language. This is used with non-culture-specific functions such as system-level calls.

The instance properties of the class provide a number of ways to retrieve the culture name. For example, NativeName gets the culture name in the language of that culture. LCID gets the NLS-specified number for a culture name. Other properties get or set the various class instances used for localization. Calendar, CompareInfo, DateTimeFormat, NumberFormat, and TextInfo return instances of the analogous classes that set their functionality.

public class CultureInfo : ICloneable, IFormatProvider {
// Public Constructors
   public CultureInfo(int culture);
   public CultureInfo(int culture, bool useUserOverride);
   public CultureInfo(string name);
   public CultureInfo(string name, bool useUserOverride);
// Public Static Properties
   public static CultureInfo CurrentCulture{get; }
   public static CultureInfo CurrentUICulture{get; }
   public static CultureInfo InstalledUICulture{get; }
   public static CultureInfo InvariantCulture{get; }
// Public Instance Properties
   public virtual Calendar Calendar{get; }
   public virtual CompareInfo CompareInfo{get; }
   public virtual DateTimeFormatInfo DateTimeFormat{set; get; }
   public virtual string DisplayName{get; }
   public virtual string EnglishName{get; }
   public virtual bool IsNeutralCulture{get; }
   public bool IsReadOnly{get; }
   public virtual int LCID{get; }
   public virtual string Name{get; }
   public virtual string NativeName{get; }
   public virtual NumberFormatInfo NumberFormat{set; get; }
   public virtual Calendar[ ] OptionalCalendars{get; }
   public virtual CultureInfo Parent{get; }
   public virtual TextInfo TextInfo{get; }
   public virtual string ThreeLetterISOLanguageName{get; }
   public virtual string ThreeLetterWindowsLanguageName{get; }
   public virtual string TwoLetterISOLanguageName{get; }
   public bool UseUserOverride{get; }
// Public Static Methods
   public static CultureInfo CreateSpecificCulture(string name);
   public static CultureInfo[ ] GetCultures(CultureTypes types);
   public static CultureInfo ReadOnly(CultureInfo ci);
// Public Instance Methods
   public void ClearCachedData( );
  public virtual object Clone( );        
// implements ICloneable
  public override bool Equals(object value);        
// overrides object
  public virtual object GetFormat(Type formatType); 
// implements IFormatProvider
   public override int GetHashCode( );    
// overrides object
   public override string ToString( );    
// overrides object

Returned By

System.Reflection.AssemblyName.CultureInfo, System.Threading.Thread.{CurrentCulture, CurrentUICulture}

Passed To

Multiple types

    Part II: Programming with the .NET Framework
    Part IV: API Quick Reference
    Chapter 26. System