Costruttore System.Globalization.CultureAndRegionInfoBuilder

Questo articolo fornisce osservazioni supplementari alla documentazione di riferimento per questa API.

Questo articolo riguarda il CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) costruttore.

Il cultureName parametro specifica il nome del nuovo CultureAndRegionInfoBuilder oggetto.

Il flags parametro viene usato per un CultureAndRegionModifiers valore che specifica se il nuovo CultureAndRegionInfoBuilder oggetto è una nuova impostazione cultura personalizzata o sostituisce impostazioni cultura non associate, impostazioni cultura specifiche o impostazioni locali di Windows esistenti.

Se il cultureName parametro specifica impostazioni cultura .NET esistenti, impostazioni cultura personalizzate registrate o impostazioni cultura generate da impostazioni locali di Windows, il CultureAndRegionInfoBuilder costruttore popola automaticamente il nuovo CultureAndRegionInfoBuilder oggetto con informazioni relative alle impostazioni cultura e al paese o all'area geografica.

Popolare il nuovo oggetto CultureAndRegionInfoBuilder con le informazioni relative a impostazioni cultura e paese/area geografica richiamando i metodi LoadDataFromCultureInfo e LoadDataFromRegionInfo.

Nomi delle impostazioni cultura personalizzate

Il formato preferito del cultureName parametro per una nuova impostazione cultura personalizzata è "[prefix-]language[-region][]suffix…]", dove il language componente è obbligatorio e i prefixcomponenti , regione suffix sono facoltativi. La lunghezza massima di ogni componente è di 8 caratteri e la lunghezza massima dell'intero cultureName parametro è di 84 caratteri.

Il prefix componente è l'identificazione IANA (Internet Assigned Numbers Authority). Specificare "i-" o "I-" per i nomi delle impostazioni cultura registrati con IANA o "x-" o "X-" per i nomi delle impostazioni cultura riservati per l'uso privato. In caso contrario, il prefisso non è obbligatorio. Per altre informazioni, vedere RFC 4646, "Tag per l'identificazione dei linguaggi".

Il language componente del cultureName parametro specifica un codice a due lettere minuscole derivato da ISO 639-1 e region specifica un codice a due lettere maiuscole derivato da ISO 3166. Ad esempio, en-US è l'inglese parlato nel Stati Uniti. L'assenza region del componente indica impostazioni cultura neutre.

Oggetto cultureName che corrisponde al nome di impostazioni cultura incluse in .NET indica impostazioni cultura di sostituzione (override). I valori che possono essere assegnati alle proprietà di impostazioni cultura di sostituzione sono limitati. Per altre informazioni su tali limitazioni, vedere le eccezioni per ogni proprietà.

L'applicazione usa il suffix componente per distinguere impostazioni cultura simili. Ad esempio, due aziende, ABC e XYZ, creano e condividono un nuovo servizio Web ASP.NET per promuovere i loro prodotti in mercati diversi in tutto il mondo. Le pagine Web per il servizio visualizzano informazioni quali il logo regionale e il numero di telefono locale di ogni società a seconda delle impostazioni cultura dell'utente. Il contenuto specifico delle impostazioni cultura per ogni pagina Web si trova in file di risorse separati identificati dal nome delle impostazioni cultura e qualificati dal nome della società. Ad esempio, i file di risorse per le impostazioni cultura en-US e ja-JP sono denominati en-US-ABC, en-US-XYZ, ja-JP-ABC e ja-JP-XYZ. I suffissi "ABC" e "XYZ" consentono al servizio Web di usare la stessa logica dell'applicazione per visualizzare informazioni specifiche del mercato diverse.

Il suffix componente può essere costituito da sottocomponenti, dove ogni sottocomponente è delimitato da un trattino e la lunghezza massima di ogni sottocomponente è di 8 caratteri. Ad esempio, se "en-US-honda-cars" è il cultureName parametro , "-honda-cars" è il suffix componente.