RegionInfo Constructores
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicializa una nueva instancia de la clase RegionInfo.
Sobrecargas
| RegionInfo(Int32) |
Inicializa una nueva instancia de la clase RegionInfo de acuerdo con el país o región asociados a la referencia cultural especificada. |
| RegionInfo(String) |
Inicializa una nueva instancia de la clase RegionInfo de acuerdo con el país o región, o la referencia cultural concreta, especificados por nombre. |
RegionInfo(Int32)
- Source:
- RegionInfo.cs
- Source:
- RegionInfo.cs
- Source:
- RegionInfo.cs
Inicializa una nueva instancia de la clase RegionInfo de acuerdo con el país o región asociados a la referencia cultural especificada.
public:
RegionInfo(int culture);public RegionInfo (int culture);new System.Globalization.RegionInfo : int -> System.Globalization.RegionInfoPublic Sub New (culture As Integer)Parámetros
- culture
- Int32
Identificador de referencia cultural.
Excepciones
culture especifica una referencia cultural invariable, personalizada o neutra.
O bien
Solo .NET 6+: el modo invariable de globalización está habilitado en el entorno.
Ejemplos
En el ejemplo de código siguiente se comparan dos instancias de RegionInfo que se crearon de forma diferente.
using namespace System;
using namespace System::Globalization;
int main()
{
// Creates a RegionInfo using the ISO 3166 two-letter code.
RegionInfo^ myRI1 = gcnew RegionInfo( "US" );
// Creates a RegionInfo using a CultureInfo.LCID.
RegionInfo^ myRI2 = gcnew RegionInfo( (gcnew CultureInfo( "en-US",false ))->LCID );
// Compares the two instances.
if ( myRI1->Equals( myRI2 ) )
Console::WriteLine( "The two RegionInfo instances are equal." );
else
Console::WriteLine( "The two RegionInfo instances are NOT equal." );
}
/*
This code produces the following output.
The two RegionInfo instances are equal.
*/
using System;
using System.Globalization;
public class SamplesRegionInfo {
public static void Main() {
// Creates a RegionInfo using the ISO 3166 two-letter code.
RegionInfo myRI1 = new RegionInfo( "US" );
// Creates a RegionInfo using a CultureInfo.LCID.
RegionInfo myRI2 = new RegionInfo( new CultureInfo("en-US",false).LCID );
// Compares the two instances.
if ( myRI1.Equals( myRI2 ) )
Console.WriteLine( "The two RegionInfo instances are equal." );
else
Console.WriteLine( "The two RegionInfo instances are NOT equal." );
}
}
/*
This code produces the following output.
The two RegionInfo instances are equal.
*/
Imports System.Globalization
Public Class SamplesRegionInfo
Public Shared Sub Main()
' Creates a RegionInfo using the ISO 3166 two-letter code.
Dim myRI1 As New RegionInfo("US")
' Creates a RegionInfo using a CultureInfo.LCID.
Dim myRI2 As New RegionInfo(New CultureInfo("en-US", False).LCID)
' Compares the two instances.
If myRI1.Equals(myRI2) Then
Console.WriteLine("The two RegionInfo instances are equal.")
Else
Console.WriteLine("The two RegionInfo instances are NOT equal.")
End If
End Sub
End Class
'This code produces the following output.
'
'The two RegionInfo instances are equal.
Comentarios
RegionInfo(String) es el constructor recomendado para crear instancias de un RegionInfo objeto. A diferencia del RegionInfo(Int32) constructor que requiere un identificador de referencia cultural numérica como parámetro, su parámetro es un nombre de referencia cultural más legible o código de país.
El identificador de referencia cultural se asigna al identificador de configuración regional correspondiente de National Language Support (NLS). Para obtener más información, consulte Referencia de LCID de Windows.
El valor de la Name propiedad del nuevo RegionInfo objeto creado mediante una llamada a este constructor es el código de letra ISO 3166 2 para el país o región, no el idioma combinado y el código de país o región. Por ejemplo, si se crea una instancia de un RegionInfo objeto con el identificador de referencia cultural 0x0409 para la referencia cultural inglés (Estados Unidos), el valor de la Name propiedad es "US". En cambio, si se crea una instancia de un RegionInfo objeto con el idioma combinado y el código en-US de país o región de la referencia cultural inglés (Estados Unidos), el valor de la Name propiedad es "en-US" en .NET Framework y solo "US" en .NET Core y .NET 5+.
Consulte también
Se aplica a
RegionInfo(String)
- Source:
- RegionInfo.cs
- Source:
- RegionInfo.cs
- Source:
- RegionInfo.cs
Inicializa una nueva instancia de la clase RegionInfo de acuerdo con el país o región, o la referencia cultural concreta, especificados por nombre.
public:
RegionInfo(System::String ^ name);public RegionInfo (string name);new System.Globalization.RegionInfo : string -> System.Globalization.RegionInfoPublic Sub New (name As String)Parámetros
- name
- String
Cadena que contiene un código de dos letras definidos en ISO 3166 para el país o la región.
O bien
Cadena que contiene el nombre de la referencia cultural para una referencia cultural concreta, una referencia cultural personalizada o una referencia cultural solo de Windows. Si el nombre de la referencia cultural no tiene el formato de RFC 4646, la aplicación debe especificar el nombre completo de la referencia cultural, en lugar de solo el del país o región.
Excepciones
name es null.
name no es un nombre de país o región válido ni el nombre de la referencia cultural concreta.
O bien
Solo .NET 6+: el modo invariable de globalización está habilitado en el entorno.
Ejemplos
En el ejemplo de código siguiente se comparan dos instancias de RegionInfo que se crearon de forma diferente.
using namespace System;
using namespace System::Globalization;
int main()
{
// Creates a RegionInfo using the ISO 3166 two-letter code.
RegionInfo^ myRI1 = gcnew RegionInfo( "US" );
// Creates a RegionInfo using a CultureInfo.LCID.
RegionInfo^ myRI2 = gcnew RegionInfo( (gcnew CultureInfo( "en-US",false ))->LCID );
// Compares the two instances.
if ( myRI1->Equals( myRI2 ) )
Console::WriteLine( "The two RegionInfo instances are equal." );
else
Console::WriteLine( "The two RegionInfo instances are NOT equal." );
}
/*
This code produces the following output.
The two RegionInfo instances are equal.
*/
using System;
using System.Globalization;
public class SamplesRegionInfo {
public static void Main() {
// Creates a RegionInfo using the ISO 3166 two-letter code.
RegionInfo myRI1 = new RegionInfo( "US" );
// Creates a RegionInfo using a CultureInfo.LCID.
RegionInfo myRI2 = new RegionInfo( new CultureInfo("en-US",false).LCID );
// Compares the two instances.
if ( myRI1.Equals( myRI2 ) )
Console.WriteLine( "The two RegionInfo instances are equal." );
else
Console.WriteLine( "The two RegionInfo instances are NOT equal." );
}
}
/*
This code produces the following output.
The two RegionInfo instances are equal.
*/
Imports System.Globalization
Public Class SamplesRegionInfo
Public Shared Sub Main()
' Creates a RegionInfo using the ISO 3166 two-letter code.
Dim myRI1 As New RegionInfo("US")
' Creates a RegionInfo using a CultureInfo.LCID.
Dim myRI2 As New RegionInfo(New CultureInfo("en-US", False).LCID)
' Compares the two instances.
If myRI1.Equals(myRI2) Then
Console.WriteLine("The two RegionInfo instances are equal.")
Else
Console.WriteLine("The two RegionInfo instances are NOT equal.")
End If
End Sub
End Class
'This code produces the following output.
'
'The two RegionInfo instances are equal.
En el ejemplo de código siguiente se crean instancias de mediante nombres de RegionInfo referencia cultural.
using namespace System;
using namespace System::Collections;
using namespace System::Globalization;
namespace Sample
{
public ref class SamplesRegionInfo
{
public:
static void Work()
{
// Creates an array containing culture names.
array <String^>^ commonCultures =
{"", "ar", "ar-DZ", "en", "en-US"};
// Creates a RegionInfo for each of the culture names.
// Note that "ar" is the culture name for the neutral
// culture "Arabic", but it is also the region name for
// the country/region "Argentina"; therefore, it does not
// fail as expected.
Console::WriteLine("Without checks...");
for each (String^ cultureID in commonCultures)
{
try
{
RegionInfo^ region =
gcnew RegionInfo(cultureID);
}
catch (ArgumentException^ ex)
{
Console::WriteLine(ex);
}
}
Console::WriteLine();
Console::WriteLine("Checking the culture"
" names first...");
for each (String^ cultureID in commonCultures)
{
if (cultureID->Length == 0)
{
Console::WriteLine(
"The culture is the invariant culture.");
}
else
{
CultureInfo^ culture =
gcnew CultureInfo(cultureID, false);
if (culture->IsNeutralCulture)
{
Console::WriteLine("The culture {0} is "
"a neutral culture.", cultureID);
}
else
{
Console::WriteLine("The culture {0} is "
"a specific culture.", cultureID);
try
{
RegionInfo^ region =
gcnew RegionInfo(cultureID);
}
catch (ArgumentException^ ex)
{
Console::WriteLine(ex);
}
}
}
}
Console::ReadLine();
}
};
}
int main()
{
Sample::SamplesRegionInfo::Work();
return 0;
}
/*
This code produces the following output.
Without checks...
System.ArgumentException: Region name '' is not supported.
Parameter name: name
at System.Globalization.RegionInfo..ctor(String name)
at SamplesRegionInfo.Main()
System.ArgumentException: Region name 'en' is not supported.
Parameter name: name
at System.Globalization.CultureTableRecord..ctor(String regionName,
Boolean useUserOverride)
at System.Globalization.RegionInfo..ctor(String name)
at SamplesRegionInfo.Main()
Checking the culture names first...
The culture is the invariant culture.
The culture ar is a neutral culture.
The culture ar-DZ is a specific culture.
The culture en is a neutral culture.
The culture en-US is a specific culture.
*/
using System;
using System.Globalization;
public class SamplesRegionInfo {
public static void Main() {
// Creates an array containing culture names.
String[] myCultures = new String[] { "", "ar", "ar-DZ", "en", "en-US" };
// Creates a RegionInfo for each of the culture names.
// Note that "ar" is the culture name for the neutral culture "Arabic",
// but it is also the region name for the country/region "Argentina";
// therefore, it does not fail as expected.
Console.WriteLine("Without checks...");
foreach (String culture in myCultures) {
try {
RegionInfo myRI = new RegionInfo( culture );
}
catch ( ArgumentException e ) {
Console.WriteLine( e.ToString() );
}
}
Console.WriteLine();
Console.WriteLine( "Checking the culture names first..." );
foreach (String culture in myCultures) {
if ( culture == "" ) {
Console.WriteLine("The culture is the invariant culture.");
}
else {
CultureInfo myCI = new CultureInfo( culture, false );
if ( myCI.IsNeutralCulture )
{
Console.WriteLine( "The culture {0} is a neutral culture.", culture );
}
else {
Console.WriteLine( "The culture {0} is a specific culture.", culture );
try {
RegionInfo myRI = new RegionInfo( culture );
}
catch ( ArgumentException e ) {
Console.WriteLine( e.ToString() );
}
}
}
}
}
}
/*
This code produces the following output.
Without checks...
System.ArgumentException: Region name '' is not supported.
Parameter name: name
at System.Globalization.RegionInfo..ctor(String name)
at SamplesRegionInfo.Main()
System.ArgumentException: Region name 'en' is not supported.
Parameter name: name
at System.Globalization.CultureTableRecord..ctor(String regionName, Boolean useUserOverride)
at System.Globalization.RegionInfo..ctor(String name)
at SamplesRegionInfo.Main()
Checking the culture names first...
The culture is the invariant culture.
The culture ar is a neutral culture.
The culture ar-DZ is a specific culture.
The culture en is a neutral culture.
The culture en-US is a specific culture.
*/
Imports System.Globalization
Public Class SamplesRegionInfo
Public Shared Sub Main()
' Creates an array containing culture names.
Dim myCultures() As String = {"", "ar", "ar-DZ", "en", "en-US"}
Dim culture As String
' Creates a RegionInfo for each of the culture names.
' Note that "ar" is the culture name for the neutral culture "Arabic",
' but it is also the region name for the country/region "Argentina";
' therefore, it does not fail as expected.
Console.WriteLine("Without checks...")
For Each culture In myCultures
Try
Dim myRI As New RegionInfo(culture)
Catch e As ArgumentException
Console.WriteLine(e.ToString())
End Try
Next
Console.WriteLine()
Console.WriteLine("Checking the culture names first...")
For Each culture In myCultures
If culture = "" Then
Console.WriteLine("The culture is the invariant culture.")
Else
Dim myCI As New CultureInfo(culture, False)
If myCI.IsNeutralCulture Then
Console.WriteLine("The culture {0} is a neutral culture.", culture)
Else
Console.WriteLine("The culture {0} is a specific culture.", culture)
Try
Dim myRI As New RegionInfo(culture)
Catch e As ArgumentException
Console.WriteLine(e.ToString())
End Try
End If
End If
Next
End Sub
End Class
'The example displays the following output.
'
'Without checks...
'System.ArgumentException: Region name '' is not supported.
'Parameter name: name
' at System.Globalization.RegionInfo..ctor(String name)
' at SamplesRegionInfo.Main()
'System.ArgumentException: Region name 'en' is not supported.
'Parameter name: name
' at System.Globalization.CultureTableRecord..ctor(String regionName, Boolean useUserOverride)
' at System.Globalization.RegionInfo..ctor(String name)
' at SamplesRegionInfo.Main()
'
'Checking the culture names first...
'The culture is the invariant culture.
'The culture ar is a neutral culture.
'The culture ar-DZ is a specific culture.
'The culture en is a neutral culture.
'The culture en-US is a specific culture.
Comentarios
El name parámetro es uno de los códigos definidos para país o región, o un nombre de referencia cultural específico, personalizado o solo de Windows. El caso no es significativo. Sin embargo, las Namepropiedades , TwoLetterISORegionNamey ThreeLetterISORegionName devuelven el código especificado o el nombre de referencia cultural en mayúsculas.
Los nombres predefinidos RegionInfo se enumeran en los códigos ISO 3166: País.
Debe proporcionar el nombre de una referencia cultural específica en lugar de solo un nombre de país o región en el name parámetro . Por ejemplo, en-US para inglés (Estados Unidos) o es-US para español (Estados Unidos) es preferible porque US propiedades como NativeName y CurrencyNativeName reflejan un idioma específico. az-Latn-AZ o az-Cyrl-AZ es preferible a AZ porque las propiedades como NativeName, CurrencyNativeNamey CurrencySymbol reflejan un script específico. Los nombres de referencia cultural predefinidos se enumeran en la referencia de LCID de Windows.
Este constructor produce un ArgumentException si name es una referencia cultural neutra (por ejemplo en , para inglés).
Notas a los autores de las llamadas
Este constructor solo acepta referencias culturales específicas o códigos de país o región. Sin embargo, algunos nombres de referencia cultural neutros son los mismos que los códigos de país o región. En este caso, name se interpreta como un código de país o región en lugar de un nombre de referencia cultural neutro y este constructor no inicia un ArgumentException.
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de