CultureAndRegionInfoBuilder Classe

Definizione

public ref class CultureAndRegionInfoBuilder sealed

[System.Runtime.InteropServices.ComVisible(false)]
public sealed class CultureAndRegionInfoBuilder

[<System.Runtime.InteropServices.ComVisible(false)>]
type CultureAndRegionInfoBuilder = class

Public NotInheritable Class CultureAndRegionInfoBuilder

Ereditarietà

Object

CultureAndRegionInfoBuilder

Attributi

ComVisibleAttribute

Commenti

La CultureInfo classe contiene informazioni specifiche della cultura, ad esempio la lingua associata, la sottolingua, il paese/regione, il calendario e le convenzioni culturali. Questa classe fornisce anche istanze specifiche della cultura delle classi DateTimeFormatInfo, NumberFormatInfo, CompareInfo e TextInfo, necessarie per operazioni specifiche della cultura, ad esempio maiuscole e minuscole, formattazione e analisi di date e numeri e confronto di stringhe.

Per impostazione predefinita, .NET Framework supporta CultureInfo oggetti che rappresentano un set predefinito di impostazioni cultura. Per un elenco di queste impostazioni culturali disponibili nei sistemi Windows, consulta la colonna Tag lingua nell'elenco dei nomi di lingua/area geografica supportati da Windows. I nomi delle culture seguono lo standard definito da BCP 47. La classe CultureAndRegionInfoBuilder consente di creare una cultura personalizzata che è completamente nuova o che sovrascrive una cultura predefinita. Quando vengono installate e registrate impostazioni cultura personalizzate in un determinato computer, diventa indistinguibile da oggetti predefiniti CultureInfo e può essere creata un'istanza e usata esattamente come tali oggetti.

Le culture personalizzate possono essere registrate in un computer solo da un utente che dispone di diritti amministrativi su tale computer. Di conseguenza, le app in genere non creano e installano impostazioni cultura personalizzate. È invece possibile usare la CultureAndRegionInfoBuilder classe per creare uno strumento speciale che un amministratore può usare per creare, installare e registrare impostazioni cultura personalizzate. Dopo aver registrato la cultura personalizzata in un computer, è possibile usare la classe CultureInfo nell'app per creare istanze della cultura personalizzata proprio come faresti per una cultura predefinita.

Se si analizzano le stringhe di data e ora generate per impostazioni cultura personalizzate, è consigliabile usare il DateTime.ParseExact metodo o DateTime.TryParseExact anziché il DateTime.Parse metodo o DateTime.TryParse per migliorare la probabilità che l'operazione di analisi abbia esito positivo. Una stringa di data e ora per una cultura personalizzata può essere complessa e quindi difficile da interpretare. I Parse metodi e TryParse tentano di analizzare una stringa con diversi modelli di analisi impliciti, che potrebbero non riuscire. Il TryParseExact metodo, al contrario, richiede all'applicazione di designare in modo esplicito uno o più modelli di analisi esatti che potrebbero avere esito positivo.

Definizione e creazione di impostazioni cultura personalizzate

Si usa la CultureAndRegionInfoBuilder classe per definire e assegnare un nome alle impostazioni cultura personalizzate. Le impostazioni cultura personalizzate possono essere impostazioni cultura completamente nuove, nuove impostazioni cultura basate su impostazioni cultura esistenti (ovvero impostazioni cultura supplementari) o impostazioni cultura che sostituiscono le impostazioni cultura di .NET Framework esistenti. In ogni caso, i passaggi di base sono gli stessi:

1. Creare un'istanza di un CultureAndRegionInfoBuilder oggetto chiamando il relativo CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) costruttore. Per sostituire una cultura esistente, passa il nome della cultura e il valore di enumerazione CultureAndRegionModifiers.Replacement al costruttore. Per creare una nuova cultura o una cultura aggiuntiva, passare un nome cultura univoco e il valore di enumerazione CultureAndRegionModifiers.Neutral o CultureAndRegionModifiers.None.

   Note

   Se si utilizza il CultureAndRegionModifiers.Replacement valore di enumerazione per creare un'istanza di un CultureAndRegionInfoBuilder oggetto, le CultureAndRegionInfoBuilder proprietà dell'oggetto vengono popolate automaticamente con i valori dell'oggetto CultureInfo da sostituire.

2. Se stai creando una cultura nuova o supplementare:

   • Popolare le proprietà dell'oggetto CultureAndRegionInfoBuilder chiamando il metodo LoadDataFromCultureInfo e passando un oggetto CultureInfo le cui proprietà sono simili a quelle del tuo nuovo oggetto.

   • Popolare le CultureAndRegionInfoBuilder proprietà regionali dell'oggetto chiamando il LoadDataFromRegionInfo metodo e passando un RegionInfo oggetto che rappresenta l'area della propria cultura personalizzata.

3. Modificare le proprietà dell'oggetto CultureAndRegionInfoBuilder in base alle esigenze.

4. Se si prevede di registrare le impostazioni cultura personalizzate in una routine separata, chiamare il metodo Save. Viene generato un file XML che è possibile caricare e registrare in una routine di installazione delle impostazioni cultura personalizzate separata.

Registrazione di impostazioni cultura personalizzate

Se si sviluppa un'applicazione di registrazione per una cultura personalizzata separata dall'applicazione che crea la cultura, si chiama il metodo CreateFromLdml per caricare il file XML contenente la definizione della cultura personalizzata e si crea un'istanza dell'oggetto CultureAndRegionInfoBuilder. Per gestire la registrazione, chiamare il Register metodo . Affinché la registrazione abbia esito positivo, l'applicazione che registra la cultura personalizzata deve essere in esecuzione con privilegi amministrativi sul sistema di destinazione; in caso contrario, la chiamata a Register genera un'eccezione UnauthorizedAccessException.

Il processo di registrazione esegue le attività seguenti:

• Crea un file con estensione nlp che contiene le informazioni definite nell'oggetto CultureAndRegionInfoBuilder .

• Archivia il file con estensione nlp nella directory di sistema %windir%\Globalization nel computer di destinazione. In questo modo le impostazioni delle impostazioni cultura personalizzate possono essere mantenute tra le sessioni. Il CultureAndRegionInfoBuilder metodo richiede privilegi amministrativi perché il file con estensione nlp viene archiviato in una directory di sistema.

• Prepara .NET Framework per eseguire la ricerca nella directory di sistema %windir%\Globalization invece di una cache interna alla successiva richiesta di creazione delle nuove impostazioni cultura personalizzate.

Quando le impostazioni cultura personalizzate vengono registrate correttamente, è indistinguibile dalle impostazioni cultura predefinite dal framework di .NET. Le impostazioni cultura personalizzate sono disponibili fino a quando una chiamata al CultureAndRegionInfoBuilder metodo rimuove il file con estensione nlp dal computer locale.

Creazione di un'istanza di impostazioni cultura personalizzate

È possibile creare un'istanza della cultura personalizzata in uno dei seguenti modi:

• Richiamando il costruttore CultureInfo.CultureInfo con il nome della cultura.
• Chiamando il metodo CultureInfo.CreateSpecificCulture con il nome della cultura.
• Chiamando il metodo CultureInfo.GetCultureInfo con il nome della cultura.

Inoltre, la matrice di CultureInfo oggetti restituiti dal metodo CultureInfo.GetCultures include la cultura personalizzata.

Example

Nell'esempio seguente vengono definite impostazioni cultura personalizzate di ru-US che rappresenta la lingua russa nel Stati Uniti. L'esempio definisce le impostazioni cultura personalizzate caricando le impostazioni dall'oggetto Russo (Russia) CultureInfo e dall'oggetto Stati Uniti RegionInfo e quindi imposta una serie di CultureAndRegionInfoBuilder proprietà. Nell'esempio vengono registrate le impostazioni cultura personalizzate, quindi ne viene creata un'istanza e viene creata un'istanza delle impostazioni cultura correnti.

using System;
using System.Globalization;
using System.Threading;

public class Example
{
   public static void Main()
   {
      // Create a custom culture for ru-US.
      CultureAndRegionInfoBuilder car1 = new CultureAndRegionInfoBuilder("ru-US",
                                             CultureAndRegionModifiers.None);
      car1.LoadDataFromCultureInfo(CultureInfo.CreateSpecificCulture("ru-RU"));
      car1.LoadDataFromRegionInfo(new RegionInfo("en-US"));

      car1.CultureEnglishName = "Russian (United States)";
      car1.CultureNativeName = "русский (США)";
      car1.CurrencyNativeName = "Доллар (США)";
      car1.RegionNativeName = "США";

      // Register the culture.
      try {
         car1.Register();
      }
      catch (InvalidOperationException) {
         // Swallow the exception: the culture already is registered.
      }

      // Use the custom culture.
      CultureInfo ci = CultureInfo.CreateSpecificCulture("ru-US");
      Thread.CurrentThread.CurrentCulture = ci;
      Console.WriteLine("Current Culture: {0}",
                        Thread.CurrentThread.CurrentCulture.Name);
      Console.WriteLine("Writing System: {0}",
                        Thread.CurrentThread.CurrentCulture.TextInfo);
   }
}
// The example displays the following output:
//     Current Culture: ru-US
//     Writing System: TextInfo - ru-US

Imports System.Globalization
Imports System.Threading

Module Example
   Public Sub Main()
      ' Create a custom culture for ru-US.
      Dim car1 As New CultureAndRegionInfoBuilder("ru-US", CultureAndRegionModifiers.None)
      car1.LoadDataFromCultureInfo(CultureInfo.CreateSpecificCulture("ru-RU"))
      car1.LoadDataFromRegionInfo(New RegionInfo("en-US"))
      
      car1.CultureEnglishName = "Russian (United States)"
      car1.CultureNativeName = "русский (США)"
      car1.CurrencyNativeName = "Доллар (США)"
      car1.RegionNativeName = "США"

      ' Register the culture.
      Try
         car1.Register()
      Catch e As InvalidOperationException
         ' Swallow the exception: the culture already is registered.
      End Try
      
      ' Use the custom culture.
      Dim ci As CultureInfo = CultureInfo.CreateSpecificCulture("ru-US")
      Thread.CurrentThread.CurrentCulture = ci
      Console.WriteLine("Current Culture: {0}", 
                        Thread.CurrentThread.CurrentCulture.Name)
      Console.WriteLine("Writing System: {0}", 
                        Thread.CurrentThread.CurrentCulture.TextInfo)
   End Sub
End Module
' The example displays the following output:
'     Current Culture: ru-US
'     Writing System: TextInfo - ru-US