System.Globalization.CultureAndRegionInfoBuilder-Konstruktor

Dieser Artikel enthält ergänzende Hinweise zur Referenzdokumentation für diese API.

Dieser Artikel bezieht sich auf den CultureAndRegionInfoBuilder(String, CultureAndRegionModifiers) Konstruktor.

Der cultureName Parameter gibt den Namen des neuen CultureAndRegionInfoBuilder Objekts an.

Der flags Parameter wird für einen CultureAndRegionModifiers Wert verwendet, der angibt, ob es sich bei dem neuen CultureAndRegionInfoBuilder Objekt um eine neue benutzerdefinierte Kultur handelt, oder eine vorhandene neutrale Kultur, eine bestimmte Kultur oder ein Windows-Gebietsschema ersetzt.

Wenn der cultureName Parameter eine vorhandene .NET-Kultur, registrierte benutzerdefinierte Kultur oder Kultur angibt, die aus einem Windows-Gebietsschema generiert wurde, füllt der CultureAndRegionInfoBuilder Konstruktor das neue CultureAndRegionInfoBuilder Objekt automatisch mit Informationen zu Kultur und Land/Region auf.

Füllen Sie das neue CultureAndRegionInfoBuilder Objekt mit Informationen zu Kultur und Land/Region auf, indem Sie die LoadDataFromCultureInfo Methoden aufrufen LoadDataFromRegionInfo .

Benutzerdefinierte Kulturnamen

Das bevorzugte Format des cultureName Parameters für eine neue benutzerdefinierte Kultur lautet "[-][-]language[prefix-suffixregion[…]]", wobei die language Komponente erforderlich ist und die prefixKomponenten regionund suffix Komponenten optional sind. Die maximale Länge jeder Komponente beträgt 8 Zeichen und die maximale Länge des gesamten cultureName Parameters beträgt 84 Zeichen.

Die prefix Komponente ist die IANA-Identifikation (Internet Assigned Numbers Authority). Geben Sie "i-" oder "I-" für Kulturnamen an, die bei der IANA registriert sind, oder "x-" oder "X-" für Kulturnamen, die für die private Verwendung reserviert sind. Andernfalls ist das Präfix nicht erforderlich. Weitere Informationen finden Sie unter RFC 4646, "Tags for the Identification of Languages".

Die language Komponente des cultureName Parameters gibt einen aus ISO 639-1 abgeleiteten Kleinbuchstabencode mit zwei Buchstaben an und region gibt einen aus ISO 3166 abgeleiteten Code mit zwei Buchstaben in Großbuchstaben an. Beispielsweise steht en-US für Englisch, wie im USA gesprochen. Das Fehlen der region Komponente bedeutet eine neutrale Kultur.

A cultureName that is the same as the name of a culture included with .NET signifis a replacement (override) culture. Die Werte, die den Eigenschaften einer Ersetzungskultur zugewiesen werden können, sind begrenzt. Weitere Informationen zu solchen Einschränkungen finden Sie in den Ausnahmen für jede Eigenschaft.

Die Anwendung verwendet die suffix Komponente, um ähnliche Kulturen zu unterscheiden. Beispielsweise erstellen und teilen sich zwei Unternehmen, ABC und XYZ, einen neuen ASP.NET Webdienst, um ihre Produkte auf verschiedenen Märkten auf der ganzen Welt zu bewerben. Die Webseiten für den Dienst zeigen Informationen wie das regionale Logo und die lokale Telefonnummer jedes Unternehmens je nach Kultur des Benutzers an. Der kulturspezifische Inhalt für jede Webseite befindet sich in separaten Ressourcendateien, die durch den Kulturnamen identifiziert und nach Firmennamen qualifiziert sind. Beispielsweise werden Ressourcendateien für die Kulturen "en-US" und "ja-JP" als "en-US-ABC", "en-US-XYZ", "ja-JP-ABC" und "ja-JP-XYZ" bezeichnet. Mit den Suffixen "ABC" und "XYZ" kann der Webdienst dieselbe Anwendungslogik verwenden, um unterschiedliche marktspezifische Informationen anzuzeigen.

Die suffix Komponente kann aus Unterkomponenten bestehen, wobei jede Teilkomponente durch einen Bindestrich getrennt ist und die maximale Länge der einzelnen Unterkomponenten 8 Zeichen beträgt. Wenn beispielsweise "en-US-honda-cars" der cultureName Parameter ist, ist "-honda-cars" die suffix Komponente.