Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Costruttore RegionInfo (String)

 

Data di pubblicazione: ottobre 2016

Inizializza una nuova istanza di RegionInfo (classe) in base al paese/area geografica o impostazioni cultura specifiche, specificato dal nome.

Spazio dei nomi:   System.Globalization
Assembly:  mscorlib (in mscorlib.dll)

public RegionInfo(
	string name
)

Parametri

name
Type: System.String

Stringa contenente un codice a due lettere definito in ISO 3166 per il paese.

-oppure-

Stringa contenente il nome di impostazioni cultura specifiche, personalizzate o solo Windows. Se il nome delle impostazioni cultura non è in formato RFC 4646, l'applicazione deve specificare il nome intero delle impostazioni cultura, anziché solo il paese.

Exception Condition
ArgumentNullException

name è null.

ArgumentException

name non è un nome di paese valido o impostazioni cultura specifiche.

Il name parametro è uno dei codici definiti per il paese/regione o un nome di impostazioni cultura specifiche, personalizzate o solo Windows. Caso non è significativo. Tuttavia, il Name, TwoLetterISORegionName, e ThreeLetterISORegionName restituiscono il nome specificato in codice o delle impostazioni cultura in lettere maiuscole.

Oggetto predefinito RegionInfo nomi sono elencati Country names and code elements sul sito Web di ISO.

È necessario fornire il nome di impostazioni cultura specifiche anziché un solo nome di paese/area geografica nel name parametro. Ad esempio, è preferibile US en-US per inglese (Stati Uniti) o es-US per lo spagnolo (Stati Uniti) perché le proprietà come NativeName e CurrencyNativeName riflettono una lingua specifica. è preferibile AZ AZ-Latn-AZ o az-Cyrl-AZ perché le proprietà come NativeName, CurrencyNativeName, e CurrencySymbol riflettono uno script specifico. I nomi predefiniti delle impostazioni cultura sono elencati nel National Language Support (NLS) API Reference in Go Global Developer Center. Si noti che una chiamata a questo costruttore genera un ArgumentException Se name è una lingua (ad esempio en per la lingua inglese).

Note per i chiamanti:

Questo costruttore accetta solo le impostazioni cultura specifiche o i codici paese. Tuttavia, alcuni nomi di impostazioni cultura di sistema sono uguali ai codici paese/area geografica. In questo caso, name viene interpretato come un codice paese/regione anziché un nome di lingua e questo costruttore non generino un ArgumentException.

Nell'esempio seguente confronta due istanze di RegionInfo creati in modo diverso.

using System;
using System.Globalization;

public class SamplesRegionInfo  {

   public static void Main()  {

      // Creates a RegionInfo using the ISO 3166 two-letter code.
      RegionInfo myRI1 = new RegionInfo( "US" );

      // Creates a RegionInfo using a CultureInfo.LCID.
      RegionInfo myRI2 = new RegionInfo( new CultureInfo("en-US",false).LCID );

      // Compares the two instances.
      if ( myRI1.Equals( myRI2 ) )
         Console.WriteLine( "The two RegionInfo instances are equal." );
      else
         Console.WriteLine( "The two RegionInfo instances are NOT equal." );

   }

}

/*
This code produces the following output.

The two RegionInfo instances are equal.

*/

Esempio di codice seguente crea istanze di RegionInfo utilizzando i nomi delle impostazioni cultura.

using System;
using System.Globalization;

public class SamplesRegionInfo  {

   public static void Main()  {

      // Creates an array containing culture names.
      String[] myCultures = new String[]  { "", "ar", "ar-DZ", "en", "en-US" };

      // Creates a RegionInfo for each of the culture names.
      //    Note that "ar" is the culture name for the neutral culture "Arabic",
      //    but it is also the region name for the country/region "Argentina";
      //    therefore, it does not fail as expected.
      Console.WriteLine("Without checks...");
      foreach (String culture in myCultures)  {
         try  {
            RegionInfo myRI = new RegionInfo( culture );
         }
         catch ( ArgumentException e )  {
            Console.WriteLine( e.ToString() );
         }
      }

      Console.WriteLine();

      Console.WriteLine( "Checking the culture names first..." );
      foreach (String culture in myCultures)  {
         if ( culture == "" )  {
            Console.WriteLine("The culture is the invariant culture.");
         }
         else  {
            CultureInfo myCI = new CultureInfo( culture, false );
            if ( myCI.IsNeutralCulture )
               Console.WriteLine( "The culture {0} is a neutral culture.", culture );
            else   {
               Console.WriteLine( "The culture {0} is a specific culture.", culture );
               try  {
                  RegionInfo myRI = new RegionInfo( culture );
               }
               catch ( ArgumentException e )  {
                  Console.WriteLine( e.ToString() );
               }
            }
         }
      }

   }

}

/*
This code produces the following output.

Without checks...
System.ArgumentException: Region name '' is not supported.
Parameter name: name
   at System.Globalization.RegionInfo..ctor(String name)
   at SamplesRegionInfo.Main()
System.ArgumentException: Region name 'en' is not supported.
Parameter name: name
   at System.Globalization.CultureTableRecord..ctor(String regionName, Boolean useUserOverride)
   at System.Globalization.RegionInfo..ctor(String name)
   at SamplesRegionInfo.Main()

Checking the culture names first...
The culture is the invariant culture.
The culture ar is a neutral culture.
The culture ar-DZ is a specific culture.
The culture en is a neutral culture.
The culture en-US is a specific culture.

*/

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 1.1
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: