CultureInfo.CreateSpecificCulture-Methode
Erstellt eine CultureInfo, die die zum angegebenen Namen gehörige spezifische Kultur darstellt.
Namespace: System.Globalization
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Shared Function CreateSpecificCulture ( _
name As String _
) As CultureInfo
'Usage
Dim name As String
Dim returnValue As CultureInfo
returnValue = CultureInfo.CreateSpecificCulture(name)
public static CultureInfo CreateSpecificCulture (
string name
)
public:
static CultureInfo^ CreateSpecificCulture (
String^ name
)
public static CultureInfo CreateSpecificCulture (
String name
)
public static function CreateSpecificCulture (
name : String
) : CultureInfo
Parameter
- name
Ein vordefinierter CultureInfo-Name oder der Name einer vorhandenen CultureInfo.
Rückgabewert
Folgendes wird von CultureInfo dargestellt: Die invariante Kultur, wenn name eine leere Zeichenfolge ist (""). – oder – Die spezifische, name zugeordnete Kultur, wenn name eine neutrale Kultur ist. – oder – Die von name angegebene Kultur, wenn name bereits eine bestimmte Kultur ist.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
name ist NULL (Nothing in Visual Basic). |
|
name ist kein gültiger Kulturname. – oder – Der von name angegebenen Kultur ist keine spezifische Kultur zugeordnet. Beispiel: "zh-CHS" oder "zh-CHT". |
Hinweise
Die Kulturen sind i. d. R. in drei Gruppen zusammengefasst: die invariante Kultur, die neutralen Kulturen und die spezifischen Kulturen.
Bei der invarianten Kultur wird keine Kultur berücksichtigt. Sie können die invariante Kultur durch einen Namen mit leerer Zeichenfolge ("") oder durch den zugehörigen Kulturbezeichner 0x007F angeben. InvariantCulture ruft eine Instanz der invarianten Kultur ab. Sie ist der englischen Sprache zugeordnet, aber ohne Bezug auf ein Land oder eine Region. Sie kann in fast allen Methoden im Globalization-Namespace verwendet werden, die eine Kultur erfordern.
Eine neutrale Kultur ist eine Kultur, die einer Sprache zugeordnet ist, aber keinem Land und keiner Region. Eine spezifische Kultur ist eine Kultur, die einer Sprache und einem Land oder einer Region zugeordnet ist. Beispielsweise ist "fr" eine neutrale Kultur, und "fr-FR" ist eine spezifische Kultur. Beachten Sie, dass es sich bei "zh-CHS" (vereinfachtes Chinesisch) und "zh-CHT" (traditionelles Chinesisch) um neutrale Kulturen handelt.
Die Kulturen bilden eine Hierarchie, bei der das übergeordnete Element einer bestimmten Kultur eine neutrale Kultur und das übergeordnete Element einer neutralen Kultur die InvariantCulture ist. Die Parent-Eigenschaft gibt die mit einer bestimmten Kultur verbundene neutrale Kultur zurück.
Wenn die Ressourcen für die entsprechende Kultur im System nicht zur Verfügung stehen, werden die Ressourcen für die neutrale Kultur verwendet. Wenn die Ressourcen für die neutrale Kultur nicht verfügbar sind, werden die in der Hauptassembly eingebetteten Ressourcen verwendet. Weitere Informationen über den Vorgang des Ressourcenfallbacks finden Sie unter Verpacken und Bereitstellen von Ressourcen.
Die Liste der Kulturen in der Windows-API unterscheidet sich geringfügig von der Liste der Kulturen in .NET Framework. Die neutrale Kultur zh-CHT "Chinesisch (traditionell)" mit dem Kulturbezeichner 0x7C04 steht in der Windows-API beispielsweise nicht zur Verfügung. Wenn Interoperabilität mit Windows erforderlich ist (z. B. über den p/invoke-Mechanismus), verwenden Sie eine im Betriebssystem definierte, spezifische Kultur. Auf diese Weise wird Konsistenz mit dem äquivalenten Windows-Gebietsschema garantiert, das mit derselben LCID angegeben wird.
| Thema | Position |
|---|---|
| Gewusst wie: Festlegen der Kultur und der Kultur der Benutzeroberfläche für die Globalisierung von ASP.NET-Webseiten | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen der Kultur und der Kultur der Benutzeroberfläche für die Globalisierung von ASP.NET-Webseiten | Erstellen von ASP.NET-Webanwendungen in Visual Studio |
| Gewusst wie: Festlegen der Kultur und der Kultur der Benutzeroberfläche für die Globalisierung von ASP.NET-Webseiten | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Codebeispiel werden die Ergebnisse von CreateSpecificCulture mit unterschiedlichen Kulturtypen angezeigt.
Imports System
Imports System.Globalization
Public Class SamplesCultureInfo
Public Shared Sub Main()
' Prints the header.
Console.WriteLine("CULTURE SPECIFIC CULTURE")
' Determines the specific culture associated with each culture in the .NET Framework.
Dim ci As CultureInfo
For Each ci In CultureInfo.GetCultures(CultureTypes.AllCultures)
Console.Write("{0,-12} {1,-40}", ci.Name, ci.EnglishName)
Try
Console.WriteLine("{0}", CultureInfo.CreateSpecificCulture(ci.Name).Name)
Catch e As ArgumentException
Console.WriteLine("(no associated specific culture)")
End Try
Next ci
End Sub 'Main
End Class 'SamplesCultureInfo
'This code produces the following output. This output has been cropped for brevity.
'
'CULTURE SPECIFIC CULTURE
'ar Arabic ar-SA
'ar-SA Arabic (Saudi Arabia) ar-SA
'ar-IQ Arabic (Iraq) ar-IQ
'ar-EG Arabic (Egypt) ar-EG
'ar-LY Arabic (Libya) ar-LY
'ar-DZ Arabic (Algeria) ar-DZ
'ar-MA Arabic (Morocco) ar-MA
'ar-TN Arabic (Tunisia) ar-TN
'ar-OM Arabic (Oman) ar-OM
'ar-YE Arabic (Yemen) ar-YE
'ar-SY Arabic (Syria) ar-SY
'ar-JO Arabic (Jordan) ar-JO
'ar-LB Arabic (Lebanon) ar-LB
'ar-KW Arabic (Kuwait) ar-KW
'ar-AE Arabic (U.A.E.) ar-AE
'ar-BH Arabic (Bahrain) ar-BH
'ar-QA Arabic (Qatar) ar-QA
'bg Bulgarian bg-BG
'bg-BG Bulgarian (Bulgaria) bg-BG
'ca Catalan ca-ES
'ca-ES Catalan (Catalan) ca-ES
'zh-CHS Chinese (Simplified) (no associated specific culture)
'zh-TW Chinese (Taiwan) zh-TW
'zh-CN Chinese (People's Republic of China) zh-CN
'zh-HK Chinese (Hong Kong S.A.R.) zh-HK
'zh-SG Chinese (Singapore) zh-SG
'zh-MO Chinese (Macao S.A.R.) zh-MO
'zh-CHT Chinese (Traditional) (no associated specific culture)
'cs Czech cs-CZ
'cs-CZ Czech (Czech Republic) cs-CZ
'da Danish da-DK
'da-DK Danish (Denmark) da-DK
using System;
using System.Globalization;
public class SamplesCultureInfo {
public static void Main() {
// Prints the header.
Console.WriteLine( "CULTURE SPECIFIC CULTURE" );
// Determines the specific culture associated with each culture in the .NET Framework.
foreach ( CultureInfo ci in CultureInfo.GetCultures( CultureTypes.AllCultures ) ) {
Console.Write( "{0,-12} {1,-40}", ci.Name, ci.EnglishName );
try {
Console.WriteLine( "{0}", CultureInfo.CreateSpecificCulture( ci.Name ).Name );
}
catch {
Console.WriteLine( "(no associated specific culture)" );
}
}
}
}
/*
This code produces the following output. This output has been cropped for brevity.
CULTURE SPECIFIC CULTURE
ar Arabic ar-SA
ar-SA Arabic (Saudi Arabia) ar-SA
ar-IQ Arabic (Iraq) ar-IQ
ar-EG Arabic (Egypt) ar-EG
ar-LY Arabic (Libya) ar-LY
ar-DZ Arabic (Algeria) ar-DZ
ar-MA Arabic (Morocco) ar-MA
ar-TN Arabic (Tunisia) ar-TN
ar-OM Arabic (Oman) ar-OM
ar-YE Arabic (Yemen) ar-YE
ar-SY Arabic (Syria) ar-SY
ar-JO Arabic (Jordan) ar-JO
ar-LB Arabic (Lebanon) ar-LB
ar-KW Arabic (Kuwait) ar-KW
ar-AE Arabic (U.A.E.) ar-AE
ar-BH Arabic (Bahrain) ar-BH
ar-QA Arabic (Qatar) ar-QA
bg Bulgarian bg-BG
bg-BG Bulgarian (Bulgaria) bg-BG
ca Catalan ca-ES
ca-ES Catalan (Catalan) ca-ES
zh-CHS Chinese (Simplified) (no associated specific culture)
zh-TW Chinese (Taiwan) zh-TW
zh-CN Chinese (People's Republic of China) zh-CN
zh-HK Chinese (Hong Kong S.A.R.) zh-HK
zh-SG Chinese (Singapore) zh-SG
zh-MO Chinese (Macao S.A.R.) zh-MO
zh-CHT Chinese (Traditional) (no associated specific culture)
cs Czech cs-CZ
cs-CZ Czech (Czech Republic) cs-CZ
da Danish da-DK
da-DK Danish (Denmark) da-DK
*/
using namespace System;
using namespace System::Globalization;
int main()
{
// Prints the header.
Console::WriteLine( "CULTURE SPECIFIC CULTURE" );
// Determines the specific culture associated with each culture in the .NET Framework.
System::Collections::IEnumerator^ myEnum = CultureInfo::GetCultures( CultureTypes::AllCultures )->GetEnumerator();
while ( myEnum->MoveNext() )
{
CultureInfo^ ci = dynamic_cast<CultureInfo^>(myEnum->Current);
Console::Write( "{0, -12} {1, -40}", ci->Name, ci->EnglishName );
try
{
Console::WriteLine( "{0}", CultureInfo::CreateSpecificCulture( ci->Name )->Name );
}
catch ( Exception^ )
{
Console::WriteLine( "(no associated specific culture)" );
}
}
}
/*
This code produces the following output. This output has been cropped for brevity.
CULTURE SPECIFIC CULTURE
ar Arabic ar-SA
ar-SA Arabic (Saudi Arabia) ar-SA
ar-IQ Arabic (Iraq) ar-IQ
ar-EG Arabic (Egypt) ar-EG
ar-LY Arabic (Libya) ar-LY
ar-DZ Arabic (Algeria) ar-DZ
ar-MA Arabic (Morocco) ar-MA
ar-TN Arabic (Tunisia) ar-TN
ar-OM Arabic (Oman) ar-OM
ar-YE Arabic (Yemen) ar-YE
ar-SY Arabic (Syria) ar-SY
ar-JO Arabic (Jordan) ar-JO
ar-LB Arabic (Lebanon) ar-LB
ar-KW Arabic (Kuwait) ar-KW
ar-AE Arabic (U.A.E.) ar-AE
ar-BH Arabic (Bahrain) ar-BH
ar-QA Arabic (Qatar) ar-QA
bg Bulgarian bg-BG
bg-BG Bulgarian (Bulgaria) bg-BG
ca Catalan ca-ES
ca-ES Catalan (Catalan) ca-ES
zh-CHS Chinese (Simplified) (no associated specific culture)
zh-TW Chinese (Taiwan) zh-TW
zh-CN Chinese (People's Republic of China) zh-CN
zh-HK Chinese (Hong Kong S.A.R.) zh-HK
zh-SG Chinese (Singapore) zh-SG
zh-MO Chinese (Macao S.A.R.) zh-MO
zh-CHT Chinese (Traditional) (no associated specific culture)
cs Czech cs-CZ
cs-CZ Czech (Czech Republic) cs-CZ
da Danish da-DK
da-DK Danish (Denmark) da-DK
*/
import System.* ;
import System.Globalization.* ;
public class SamplesCultureInfo
{
public static void main(String[] args)
{
// Prints the header.
Console.WriteLine("CULTURE "
+ " SPECIFIC CULTURE");
// Determines the specific culture associated with each culture in the
// .NET Framework.
for (int iCtr = 0;
iCtr < (CultureInfo.GetCultures(CultureTypes.AllCultures).length);
iCtr++) {
CultureInfo ci =
CultureInfo.GetCultures(CultureTypes.AllCultures)[iCtr];
Console.Write("{0,-12} {1,-40}", ci.get_Name(),
ci.get_EnglishName());
try {
Console.WriteLine("{0}", CultureInfo.CreateSpecificCulture(
ci.get_Name()).get_Name());
}
catch(System.Exception exp){
Console.WriteLine("(no associated specific culture)");
}
}
} //main
} //SamplesCultureInfo
/*
This code produces the following output. This output has been cropped for
brevity.
CULTURE SPECIFIC CULTURE
ar Arabic ar-SA
ar-SA Arabic (Saudi Arabia) ar-SA
ar-IQ Arabic (Iraq) ar-IQ
ar-EG Arabic (Egypt) ar-EG
ar-LY Arabic (Libya) ar-LY
ar-DZ Arabic (Algeria) ar-DZ
ar-MA Arabic (Morocco) ar-MA
ar-TN Arabic (Tunisia) ar-TN
ar-OM Arabic (Oman) ar-OM
ar-YE Arabic (Yemen) ar-YE
ar-SY Arabic (Syria) ar-SY
ar-JO Arabic (Jordan) ar-JO
ar-LB Arabic (Lebanon) ar-LB
ar-KW Arabic (Kuwait) ar-KW
ar-AE Arabic (U.A.E.) ar-AE
ar-BH Arabic (Bahrain) ar-BH
ar-QA Arabic (Qatar) ar-QA
bg Bulgarian bg-BG
bg-BG Bulgarian (Bulgaria) bg-BG
ca Catalan ca-ES
ca-ES Catalan (Catalan) ca-ES
zh-CHS Chinese (Simplified) (no associated specific
culture)
zh-TW Chinese (Taiwan) zh-TW
zh-CN Chinese (People's Republic of China) zh-CN
zh-HK Chinese (Hong Kong S.A.R.) zh-HK
zh-SG Chinese (Singapore) zh-SG
zh-MO Chinese (Macau S.A.R.) zh-MO
zh-CHT Chinese (Traditional) (no associated specific
culture)
cs Czech cs-CZ
cs-CZ Czech (Czech Republic) cs-CZ
da Danish da-DK
da-DK Danish (Denmark) da-DK
*/
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
CultureInfo-Klasse
CultureInfo-Member
System.Globalization-Namespace
CultureInfo
Parent