System.Globalization.CultureAndRegionInfoBuilder, konstruktor

Ten artykuł zawiera dodatkowe uwagi dotyczące dokumentacji referencyjnej dla tego interfejsu API.

Ten artykuł dotyczy konstruktora CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) .

Parametr cultureName określa nazwę nowego CultureAndRegionInfoBuilder obiektu.

Parametr flags jest używany dla CultureAndRegionModifiers wartości, która określa, czy nowy CultureAndRegionInfoBuilder obiekt jest nową kulturą niestandardową, czy zastępuje istniejącą kulturę neutralną, konkretną kulturę lub ustawienia regionalne systemu Windows.

cultureName Jeśli parametr określa istniejącą kulturę platformy .NET, zarejestrowaną kulturę niestandardową lub kulturę wygenerowaną na podstawie ustawień regionalnych systemu Windows, CultureAndRegionInfoBuilder konstruktor automatycznie wypełnia nowy CultureAndRegionInfoBuilder obiekt informacjami o kulturze i kraju/regionie.

Wypełnij nowy CultureAndRegionInfoBuilder obiekt informacjami o kulturze i kraju/regionie, wywołując LoadDataFromCultureInfo metody i .LoadDataFromRegionInfo

Nazwy niestandardowych kultur

Preferowany format parametru cultureName dla nowej kultury niestandardowej to "[-][prefix-region]language[-suffix[][…]]", gdzie language składnik jest wymagany, a prefixskładniki , regioni suffix są opcjonalne. Maksymalna długość każdego składnika wynosi 8 znaków, a maksymalna długość całego cultureName parametru to 84 znaki.

Składnik prefix jest identyfikacją urzędu IANA (Internet Assigned Numbers Authority). Określ wartości "i-" lub "I-" dla nazw kultur zarejestrowanych w IANA lub "x-" lub "X-" dla nazw kultury zarezerwowanych do użytku prywatnego. W przeciwnym razie prefiks nie jest wymagany. Aby uzyskać więcej informacji, zobacz RFC 4646" "Tagi identyfikacji języków".

Składnik language parametru cultureName określa małą literę dwuliterowego kodu pochodzącego z ISO 639-1 i region określa dwuliterowy kod pochodzący z iso 3166. Na przykład en-US oznacza angielski jako mówiony w Stany Zjednoczone. Brak region składnika oznacza neutralną kulturę.

Wartość cultureName taka sama jak nazwa kultury dołączonej do platformy .NET oznacza kulturę zastępczą (zastępowanie). Wartości, które można przypisać do właściwości kultury zastępczej, są ograniczone. Aby uzyskać więcej informacji na temat takich ograniczeń, zobacz wyjątki dla każdej właściwości.

Aplikacja używa suffix składnika do rozróżniania podobnych kultur. Na przykład dwie firmy, ABC i XYZ, tworzą i współdzielą nową usługę internetową ASP.NET, aby promować swoje produkty na różnych rynkach na całym świecie. Strony sieci Web usługi zawierają informacje, takie jak regionalne logo i lokalny numer telefonu każdej firmy w zależności od kultury użytkownika. Zawartość specyficzna dla kultury dla każdej strony sieci Web znajduje się w osobnych plikach zasobów identyfikowanych przez nazwę kultury i kwalifikowaną przez nazwę firmy. Na przykład pliki zasobów dla kultur en-US i ja-JP mają nazwy en-US-ABC, en-US-XYZ, ja-JP-ABC i ja-JP-XYZ. Sufiksy "ABC" i "XYZ" umożliwiają usłudze sieci Web używanie tej samej logiki aplikacji do wyświetlania różnych informacji specyficznych dla rynku.

Składnik suffix może składać się z podskładników, gdzie każdy podskładnik jest rozdzielany łącznikiem, a maksymalna długość każdego podskładnika wynosi 8 znaków. Na przykład jeśli parametr "en-US-honda-cars" jest cultureName parametrem "-honda-cars" jest składnikiem suffix .