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

Classe CultureAndRegionInfoBuilder

 

Definisce impostazioni cultura personalizzate nuove o basate su altre impostazioni cultura e paese/area geografica. È possibile installare le impostazioni cultura personalizzate in un computer e usarle in qualsiasi applicazione in esecuzione. Questa classe non può essere ereditata.

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

System.Object
  System.Globalization.CultureAndRegionInfoBuilder

[ComVisibleAttribute(false)]
public sealed class CultureAndRegionInfoBuilder

NomeDescrizione
System_CAPS_pubmethodCultureAndRegionInfoBuilder(String, CultureAndRegionModifiers)

Inizializza una nuova istanza della classe CultureAndRegionInfoBuilder.

NomeDescrizione
System_CAPS_pubpropertyAvailableCalendars

Ottiene o imposta una matrice di calendari supportati dall'oggetto CultureAndRegionInfoBuilder.

System_CAPS_pubpropertyCompareInfo

Ottiene o imposta l'oggetto CompareInfo che definisce la modalità di confronto delle stringhe per le impostazioni cultura.

System_CAPS_pubpropertyConsoleFallbackUICulture

Ottiene o definisce impostazioni cultura dell'interfaccia utente alternative adatte per le applicazioni di console quando le impostazioni cultura predefinite dell'interfaccia utente grafica non sono appropriate.

System_CAPS_pubpropertyCultureEnglishName

Ottiene o imposta il nome delle impostazioni cultura in inglese.

System_CAPS_pubpropertyCultureName

Ottiene il nome delle impostazioni cultura create.

System_CAPS_pubpropertyCultureNativeName

Ottiene o imposta il nome delle impostazioni cultura nel formato e nella lingua impostati per la visualizzazione.

System_CAPS_pubpropertyCultureTypes

Ottiene il valore di CultureTypes che descrive le impostazioni cultura rappresentate dall'oggetto CultureAndRegionInfoBuilder corrente.

System_CAPS_pubpropertyCurrencyEnglishName

Ottiene o imposta il nome in inglese della valuta usata nel paese/area geografica rappresentato dall'oggetto CultureAndRegionInfoBuilder.

System_CAPS_pubpropertyCurrencyNativeName

Ottiene o imposta il nome nativo della valuta usata nel paese/area geografica rappresentato dall'oggetto CultureAndRegionInfoBuilder corrente.

System_CAPS_pubpropertyGeoId

Ottiene o imposta un numero di identificazione univoco per un'area geografica, un paese, una città o una località.

System_CAPS_pubpropertyGregorianDateTimeFormat

Ottiene o imposta un oggetto DateTimeFormatInfo che definisce il formato di date e ore in base al calendario gregoriano.

System_CAPS_pubpropertyIetfLanguageTag

Ottiene o imposta un nome di impostazioni cultura formattato in base allo standard RFC 4646 relativo ai tag per l'identificazione delle lingue.

System_CAPS_pubpropertyIsMetric

Ottiene o imposta un valore che indica se nel paese/area geografica in questione viene usato il sistema metrico per le misurazioni.

System_CAPS_pubpropertyISOCurrencySymbol

Ottiene o imposta il simbolo di valuta di tre caratteri ISO 4217 associato al paese/area geografica.

System_CAPS_pubpropertyIsRightToLeft

Ottiene o imposta la direzione predominante delle righe di testo nel sistema di scrittura associato all'oggetto CultureAndRegionInfoBuilder corrente.

System_CAPS_pubpropertyKeyboardLayoutId

Ottiene o imposta l'ID delle impostazioni locali di input attivo.

System_CAPS_pubpropertyLCID

Ottiene l'identificatore di impostazioni cultura per l'oggetto CultureAndRegionInfoBuilder corrente.

System_CAPS_pubpropertyNumberFormat

Ottiene o imposta un oggetto NumberFormatInfo che definisce il formato per la visualizzazione di numeri, valute e percentuali appropriato per la lingua.

System_CAPS_pubpropertyParent

Ottiene o imposta l'oggetto CultureInfo che rappresenta le impostazioni cultura padre delle impostazioni cultura personalizzate correnti.

System_CAPS_pubpropertyRegionEnglishName

Ottiene o imposta il nome completo del paese/area geografica in lingua inglese.

System_CAPS_pubpropertyRegionName

Ottiene il nome del paese/area geografica per l'oggetto CultureAndRegionInfoBuilder corrente.

System_CAPS_pubpropertyRegionNativeName

Ottiene o imposta il nome completo del paese/area geografica usato dalle persone di queste impostazioni cultura personalizzate.

System_CAPS_pubpropertyTextInfo

Ottiene o imposta l'oggetto TextInfo che definisce il sistema di scrittura associato alle impostazioni cultura personalizzate.

System_CAPS_pubpropertyThreeLetterISOLanguageName

Ottiene o imposta il codice ISO 639-2 di tre lettere per le impostazioni cultura personalizzate.

System_CAPS_pubpropertyThreeLetterISORegionName

Ottiene o imposta il codice di tre lettere definito in base allo standard ISO 3166 per il paese/area geografica.

System_CAPS_pubpropertyThreeLetterWindowsLanguageName

Ottiene o imposta il codice di tre lettere per la lingua, in base alla definizione nell'API Windows.

System_CAPS_pubpropertyThreeLetterWindowsRegionName

Ottiene o imposta il codice di tre lettere assegnato in Windows al paese/area geografica rappresentato dalle impostazioni cultura personalizzate correnti.

System_CAPS_pubpropertyTwoLetterISOLanguageName

Ottiene o imposta il codice ISO 639-1 di due lettere per la lingua dell'oggetto CultureInfo corrente.

System_CAPS_pubpropertyTwoLetterISORegionName

Ottiene o imposta il codice di due lettere definito in base allo standard ISO 3166 per il paese/area geografica.

NomeDescrizione
System_CAPS_pubmethodSystem_CAPS_staticCreateFromLdml(String)

Ricostituisce un oggetto CultureAndRegionInfoBuilder da un file XML specificato contenente una rappresentazione dell'oggetto.

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodLoadDataFromCultureInfo(CultureInfo)

Imposta le proprietà dell'oggetto CultureAndRegionInfoBuilder corrente in base alle proprietà corrispondenti dell'oggetto CultureInfo specificato.

System_CAPS_pubmethodLoadDataFromRegionInfo(RegionInfo)

Imposta le proprietà dell'oggetto CultureAndRegionInfoBuilder corrente in base alle proprietà corrispondenti dell'oggetto RegionInfo specificato.

System_CAPS_pubmethodRegister()

Rende l'oggetto CultureAndRegionInfoBuilder corrente persistente come impostazioni cultura personalizzate nel computer locale e rende tali impostazioni cultura disponibili alle applicazioni. Richiede privilegi di amministratore.

System_CAPS_pubmethodSave(String)

Scrive una rappresentazione XML dell'oggetto CultureAndRegionInfoBuilder corrente nel file specificato.

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object.)

System_CAPS_pubmethodSystem_CAPS_staticUnregister(String)

Elimina impostazioni cultura personalizzate dal computer locale.

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

Per impostazione predefinita, .NET Framework supporta CultureInfo gli oggetti che rappresentano un set predefinito di impostazioni cultura. Per un elenco di queste impostazioni cultura, vedere il National Language Support (NLS) API Reference a Developer Center. La CultureAndRegionInfoBuilder classe consente di creare impostazioni cultura personalizzate che è completamente nuova o che esegue l'override delle impostazioni cultura predefinite. Quando una lingua personalizzata è installata e registrata in un computer specifico, questa diventa distinguibile da predefiniti CultureInfo oggetti e può essere creata un'istanza e uso è analogo a tali oggetti.

System_CAPS_importantImportante

Si noti che la CultureAndRegionInfoBuilder classe si trova in un assembly denominato sysglobl. dll. Completata la compilazione di codice che utilizza questo tipo è necessario aggiungere un riferimento a sysglobl. dll.

Impostazioni cultura personalizzate possono essere registrate in un computer solo da un utente che disponga dei diritti amministrativi nel computer. Di conseguenza, le App in genere non creare e installare le impostazioni cultura personalizzate. In alternativa, è possibile utilizzare la CultureAndRegionInfoBuilder classe per creare uno strumento speciale che un amministratore può utilizzare per creare, installare e registrare una lingua personalizzata. Dopo aver registrata le impostazioni cultura personalizzate in un computer, è possibile utilizzare la CultureInfo classe nell'app per creare istanze delle impostazioni cultura personalizzate, come accade per impostazioni cultura predefinite.

Se si analizza le stringhe di data e ora generate per una lingua personalizzata, è necessario utilizzare il DateTime.ParseExact o DateTime.TryParseExact anziché il DateTime.Parse o DateTime.TryParse metodo per aumentare le probabilità che l'operazione di analisi avrà esito positivo. Una stringa di data e ora per impostazioni cultura personalizzate può essere complessa e pertanto difficile da analizzare. Il Parse e TryParse metodi tentano di analizzare una stringa con più criteri di analisi impliciti, ognuno dei quali potrebbe avere esito negativo. Il TryParseExact (metodo), invece, richiede l'applicazione di definire in modo esplicito uno o più modelli di analisi che possono avranno esito positivo.

Utilizzare la CultureAndRegionInfoBuilder classe per definire e assegnare un nome impostazioni cultura personalizzate. La lingua personalizzata può essere una lingua completamente nuova, una nuova impostazione cultura basato su una lingua esistente (vale a dire una lingua supplementare) o una lingua che sostituisce una lingua di .NET Framework esistente. 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 lingua esistente, passare il nome delle impostazioni cultura e CultureAndRegionModifiers.Replacement al costruttore valore di enumerazione. Per creare una nuova impostazione cultura o supplementari, passare un nome di lingua univoco e il CultureAndRegionModifiers.Neutral o CultureAndRegionModifiers.None valore di enumerazione.

    System_CAPS_noteNota

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

  2. Se si sta creando una lingua nuova o supplementare:

    • Popolare il CultureAndRegionInfoBuilder proprietà dell'oggetto chiamando il LoadDataFromCultureInfo metodo e passando un CultureInfo oggetto i cui valori di proprietà sono simili per il nuovo oggetto.

    • Popolare il CultureAndRegionInfoBuilder internazionali dell'oggetto chiamando il LoadDataFromRegionInfo metodo e passando un RegionInfo oggetto che rappresenta l'area delle impostazioni cultura personalizzate.

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

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

Se si sviluppa un'applicazione di registrazione per una lingua personalizzata è separata dall'applicazione che crea le impostazioni cultura, chiamare il CreateFromLdml per caricare il file XML che contiene la definizione della lingua personalizzata e creare un'istanza di CultureAndRegionInfoBuilder oggetto. Per gestire la registrazione, chiamare il Register metodo. Per la registrazione abbia esito positivo, l'applicazione che registra le impostazioni cultura personalizzate debba essere in esecuzione con privilegi amministrativi nel sistema di destinazione; in caso contrario, la chiamata a Register genera un UnauthorizedAccessException eccezione.

System_CAPS_warningAvviso

Dati delle impostazioni cultura possono variare tra i sistemi. Se si utilizza il CultureAndRegionInfoBuilder classe per creare una lingua personalizzata è uniforme su più sistemi e si sta creando delle impostazioni cultura personalizzate per il caricamento dei dati da esistente CultureInfo e RegionInfo oggetti e la personalizzazione, è necessario sviluppare due diverse utilità. Il primo crea le impostazioni cultura personalizzate e lo salva in un file XML. Il secondo Usa il CreateFromLdml metodo per caricare le impostazioni cultura personalizzate da un file XML e registrarlo nel computer di destinazione.

Il processo di registrazione vengono eseguite le attività seguenti:

  • Crea un file nlp contenente le informazioni che sono definite nel CultureAndRegionInfoBuilder oggetto.

  • Archivia il file nlp nella directory di sistema %windir%\Globalization nel computer di destinazione. In questo modo le impostazioni della lingua personalizzata in modo permanente tra le sessioni. (Il CultureAndRegionInfoBuilder metodo richiede privilegi amministrativi, poiché il file nlp viene archiviato in una directory di sistema.)

  • Prepara .NET Framework per la ricerca di directory di sistema %windir%\Globalization anziché una cache interna alla successiva richiesta di creazione di una nuova lingua personalizzata.

Quando una lingua personalizzata è stata registrata, non distinguibile da impostazioni cultura che sono predefinite per .NET Framework. Le impostazioni cultura personalizzate sono disponibile fino a quando una chiamata al CultureAndRegionInfoBuilder metodo rimuove il file nlp dal computer locale.

È possibile creare un'istanza delle impostazioni cultura personalizzate in uno dei modi seguenti:

Inoltre, la matrice di CultureInfo oggetti restituito dal CultureInfo.GetCultures metodo include le impostazioni cultura personalizzate.

L'esempio seguente definisce una lingua personalizzata ru-US che rappresenta la lingua russa negli Stati Uniti. L'esempio definisce le impostazioni cultura personalizzate per il caricamento delle impostazioni da russe (Russia) CultureInfo oggetto e Stati Uniti RegionInfo dell'oggetto e quindi imposta il numero di CultureAndRegionInfoBuilder proprietà. Nell'esempio registra la lingua personalizzata, quindi ne crea un'istanza e rende impostazioni cultura del thread corrente.

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

.NET Framework
Disponibile da 2.0

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: