System.Globalization.CultureAndRegionInfoBuilder – konstruktor
Tento článek obsahuje doplňující poznámky k referenční dokumentaci pro toto rozhraní API.
Tento článek se týká konstruktoru CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) .
Parametr cultureName určuje název nového CultureAndRegionInfoBuilder objektu.
Parametr flags se používá pro CultureAndRegionModifiers hodnotu, která určuje, zda je nový CultureAndRegionInfoBuilder objekt novou vlastní jazykovou verzí, nebo nahrazuje existující neutrální jazykovou verzi, konkrétní jazykovou verzi nebo národní prostředí Windows.
cultureName Pokud parametr určuje existující jazykovou verzi .NET, zaregistrovanou vlastní jazykovou verzi nebo jazykovou verzi vygenerovanou z národního prostředí Windows, CultureAndRegionInfoBuilder konstruktor automaticky naplní nový CultureAndRegionInfoBuilder objekt informacemi o jazykové verzi a zemi/oblasti.
Naplňte nový CultureAndRegionInfoBuilder objekt informacemi o jazykové verzi a zemi/oblasti vyvoláním LoadDataFromCultureInfo metod a LoadDataFromRegionInfo metod.
Názvy vlastních jazykových verzí
Upřednostňovaný formát parametru cultureName pro novou vlastní jazykovou verzi je "[prefix-]language[-region][-suffix[…]]]", kde language je komponenta povinná a komponenta a suffixprefixregionkomponenty jsou volitelné. Maximální délka každé součásti je 8 znaků a maximální délka celého cultureName parametru je 84 znaků.
Součástí prefix je identifikace IANA (Internet Assigned Numbers Authority). Zadejte "i-" nebo "I-" pro názvy jazykových verzí zaregistrovaných v IANA nebo "x-" nebo "X-" pro názvy jazykových verzí vyhrazených pro soukromé použití. Jinak se předpona nevyžaduje. Další informace naleznete v dokumentu RFC 4646, "Tags for the Identification of Languages" (Značky pro identifikaci jazyků).
Součást language parametru cultureName určuje dvoumísmenný dvoumísmenný kód odvozený od ISO 639-1 a region určuje velké dvoumísmenné kód odvozené od ISO 3166. Například en-US znamená angličtinu jako mluvený v USA. Absence region komponenty označuje neutrální jazykovou verzi.
Hodnota cultureName , která je stejná jako název jazykové verze zahrnuté v rozhraní .NET, označuje náhradní jazykovou verzi (přepsání). Hodnoty, které lze přiřadit vlastnostem náhradní jazykové verze, jsou omezené. Další informace o těchto omezeních najdete v tématu výjimky pro každou vlastnost.
Aplikace používá komponentu suffix k rozlišení podobných jazykových verzí. Například dvě společnosti, ABC a XYZ, vytvářejí a sdílejí novou ASP.NET webovou službu pro podporu svých produktů na různých trzích po celém světě. Webové stránky služby zobrazují informace, jako je regionální logo a místní telefonní číslo každé společnosti v závislosti na jazykové verzi uživatele. Obsah specifický pro jazykovou verzi pro každou webovou stránku je v samostatných souborech prostředků identifikovaných názvem jazykové verze a kvalifikovaným názvem společnosti. Například soubory prostředků pro jazykové verze en-US a ja-JP se nazývají en-US-ABC, en-US-XYZ, ja-JP-ABC a ja-JP-XYZ. Přípony "ABC" a "XYZ" umožňují webové službě používat stejnou logiku aplikace k zobrazení různých informací specifických pro trh.
Komponenta suffix se může skládat z dílčích komponent, kde každý dílčí podkomponent je oddělený pomlčkou a maximální délka každého podsoučtu je 8 znaků. Pokud je parametrem například "en-US-honda-cars" cultureName , je komponenta suffix "-honda-cars".
