Obtiene o establece un
NumberFormatInfo que define el formato de presentación de números, moneda y porcentaje culturalmente apropiado.
Espacio de nombres: System.Globalization
Ensamblado: mscorlib (en mscorlib.dll)
Visual Basic (Declaración)
Public Overridable Property NumberFormat As NumberFormatInfo
Dim instance As CultureInfo
Dim value As NumberFormatInfo
value = instance.NumberFormat
instance.NumberFormat = value
public virtual NumberFormatInfo NumberFormat { get; set; }
public:
virtual property NumberFormatInfo^ NumberFormat {
NumberFormatInfo^ get ();
void set (NumberFormatInfo^ value);
}
/** @property */
public NumberFormatInfo get_NumberFormat ()
/** @property */
public void set_NumberFormat (NumberFormatInfo value)
public function get NumberFormat () : NumberFormatInfo
public function set NumberFormat (value : NumberFormatInfo)
Valor de propiedad
NumberFormatInfo que define el formato de presentación de números, moneda y porcentaje culturalmente apropiado.
Una clase NumberFormatInfo sólo se puede crear para la referencia cultural invariable o para referencias culturales específicas, pero no para referencias culturales neutras.
Se han dividido las diferentes referencias culturales en tres grupos: culturas invariables, culturas neutras y culturas específicas.
La referencia cultural invariable no tiene en cuenta la referencia cultural. Se puede especificar la referencia cultural invariable por el nombre mediante una cadena vacía ("") o por el identificador de referencia cultural 0x007F. InvariantCulture recupera una instancia de la referencia cultural invariable. Se encuentra asociada al idioma inglés pero a ningún país o región. Se puede utilizar en casi todos los métodos del espacio de nombres de globalización que requieran una referencia cultural.
Una referencia cultural neutra es aquélla asociada a un idioma pero no a un país o región. Una referencia cultural específica es la que está asociada a un idioma y a un país o región. Por ejemplo, "fr" es una referencia cultural neutra y "fr-FR" es una referencia cultural específica. Tenga en cuenta que "zh-CHS" (chino simplificado) y "zh-CHT" (chino tradicional) son referencias culturales neutras.
Valores de reemplazo
El usuario puede reemplazar, si lo desea, algunos de los valores asociados a la referencia cultural actual de Windows en Configuración regional y de idioma del Panel de control. Por ejemplo, el usuario puede mostrar la fecha en un formato diferente o utilizar una moneda diferente a la predeterminada para la referencia cultural.
Si UseUserOverride es true y la referencia cultural especificada coincide con la referencia cultural actual de Windows, CultureInfo utiliza estos nuevos valores, incluida la configuración del usuario para las propiedades de la instancia de DateTimeFormatInfo devuelta por la propiedad DateTimeFormat, y las propiedades de la instancia de NumberFormatInfo devueltas por la propiedad NumberFormat. Si la configuración del usuario no es compatible con la referencia cultural asociada a CultureInfo (por ejemplo, si el calendario seleccionado no es uno de OptionalCalendars), el resultado de los métodos y los valores de las propiedades no se definen.
No se calculará el valor de las propiedades DateTimeFormat y NumberFormat hasta que se obtenga acceso a ellas. Si utiliza el Panel de control para cambiar la referencia cultural actual a una nueva referencia cultural mientras se ejecuta la aplicación, y después obtiene acceso a la propiedad DateTimeFormat o NumberFormat, la aplicación obtendrá los valores predeterminados para la nueva referencia cultural, no los valores de reemplazo de la referencia cultural original. Si desea conservar los valores de reemplazo de la referencia cultural actual original, obtenga acceso a las propiedades DateTimeFormat y NumberFormat antes de cambiar la referencia cultural actual.
En el siguiente ejemplo de código se muestra cómo CultureInfo.Clone también clona las instancias de DateTimeFormatInfo y NumberFormatInfo asociadas a la clase CultureInfo.
Imports System
Imports System.Globalization
Public Class SamplesCultureInfo
Public Shared Sub Main()
' Creates and initializes a CultureInfo.
Dim myCI As New CultureInfo("en-US", False)
' Clones myCI and modifies the DTFI and NFI instances associated with the clone.
Dim myCIclone As CultureInfo = CType(myCI.Clone(), CultureInfo)
myCIclone.DateTimeFormat.AMDesignator = "a.m."
myCIclone.DateTimeFormat.DateSeparator = "-"
myCIclone.NumberFormat.CurrencySymbol = "USD"
myCIclone.NumberFormat.NumberDecimalDigits = 4
' Displays the properties of the DTFI and NFI instances associated with the original and with the clone.
Console.WriteLine("DTFI/NFI PROPERTY" + ControlChars.Tab + "ORIGINAL" + ControlChars.Tab + "MODIFIED CLONE")
Console.WriteLine("DTFI.AMDesignator" + ControlChars.Tab + "{0}" + ControlChars.Tab + ControlChars.Tab + "{1}", myCI.DateTimeFormat.AMDesignator, myCIclone.DateTimeFormat.AMDesignator)
Console.WriteLine("DTFI.DateSeparator" + ControlChars.Tab + "{0}" + ControlChars.Tab + ControlChars.Tab + "{1}", myCI.DateTimeFormat.DateSeparator, myCIclone.DateTimeFormat.DateSeparator)
Console.WriteLine("NFI.CurrencySymbol" + ControlChars.Tab + "{0}" + ControlChars.Tab + ControlChars.Tab + "{1}", myCI.NumberFormat.CurrencySymbol, myCIclone.NumberFormat.CurrencySymbol)
Console.WriteLine("NFI.NumberDecimalDigits" + ControlChars.Tab + "{0}" + ControlChars.Tab + ControlChars.Tab + "{1}", myCI.NumberFormat.NumberDecimalDigits, myCIclone.NumberFormat.NumberDecimalDigits)
End Sub 'Main
End Class 'SamplesCultureInfo
' This code produces the following output.
'
' DTFI/NFI PROPERTY ORIGINAL MODIFIED CLONE
' DTFI.AMDesignator AM a.m.
' DTFI.DateSeparator / -
' NFI.CurrencySymbol $ USD
' NFI.NumberDecimalDigits 2 4
using System;
using System.Globalization;
public class SamplesCultureInfo {
public static void Main() {
// Creates and initializes a CultureInfo.
CultureInfo myCI = new CultureInfo("en-US", false);
// Clones myCI and modifies the DTFI and NFI instances associated with the clone.
CultureInfo myCIclone = (CultureInfo) myCI.Clone();
myCIclone.DateTimeFormat.AMDesignator = "a.m.";
myCIclone.DateTimeFormat.DateSeparator = "-";
myCIclone.NumberFormat.CurrencySymbol = "USD";
myCIclone.NumberFormat.NumberDecimalDigits = 4;
// Displays the properties of the DTFI and NFI instances associated with the original and with the clone.
Console.WriteLine( "DTFI/NFI PROPERTY\tORIGINAL\tMODIFIED CLONE" );
Console.WriteLine( "DTFI.AMDesignator\t{0}\t\t{1}", myCI.DateTimeFormat.AMDesignator, myCIclone.DateTimeFormat.AMDesignator );
Console.WriteLine( "DTFI.DateSeparator\t{0}\t\t{1}", myCI.DateTimeFormat.DateSeparator, myCIclone.DateTimeFormat.DateSeparator );
Console.WriteLine( "NFI.CurrencySymbol\t{0}\t\t{1}", myCI.NumberFormat.CurrencySymbol, myCIclone.NumberFormat.CurrencySymbol );
Console.WriteLine( "NFI.NumberDecimalDigits\t{0}\t\t{1}", myCI.NumberFormat.NumberDecimalDigits, myCIclone.NumberFormat.NumberDecimalDigits );
}
}
/*
This code produces the following output.
DTFI/NFI PROPERTY ORIGINAL MODIFIED CLONE
DTFI.AMDesignator AM a.m.
DTFI.DateSeparator / -
NFI.CurrencySymbol $ USD
NFI.NumberDecimalDigits 2 4
*/
using namespace System;
using namespace System::Globalization;
int main()
{
// Creates and initializes a CultureInfo.
CultureInfo^ myCI = gcnew CultureInfo( "en-US",false );
// Clones myCI and modifies the DTFI and NFI instances associated with the clone.
CultureInfo^ myCIclone = dynamic_cast<CultureInfo^>(myCI->Clone());
myCIclone->DateTimeFormat->AMDesignator = "a.m.";
myCIclone->DateTimeFormat->DateSeparator = "-";
myCIclone->NumberFormat->CurrencySymbol = "USD";
myCIclone->NumberFormat->NumberDecimalDigits = 4;
// Displays the properties of the DTFI and NFI instances associated with the original and with the clone.
Console::WriteLine( "DTFI/NFI PROPERTY\tORIGINAL\tMODIFIED CLONE" );
Console::WriteLine( "DTFI.AMDesignator\t{0}\t\t{1}", myCI->DateTimeFormat->AMDesignator, myCIclone->DateTimeFormat->AMDesignator );
Console::WriteLine( "DTFI.DateSeparator\t{0}\t\t{1}", myCI->DateTimeFormat->DateSeparator, myCIclone->DateTimeFormat->DateSeparator );
Console::WriteLine( "NFI.CurrencySymbol\t{0}\t\t{1}", myCI->NumberFormat->CurrencySymbol, myCIclone->NumberFormat->CurrencySymbol );
Console::WriteLine( "NFI.NumberDecimalDigits\t{0}\t\t{1}", myCI->NumberFormat->NumberDecimalDigits, myCIclone->NumberFormat->NumberDecimalDigits );
}
/*
This code produces the following output.
DTFI/NFI PROPERTY ORIGINAL MODIFIED CLONE
DTFI.AMDesignator AM a.m.
DTFI.DateSeparator / -
NFI.CurrencySymbol $ USD
NFI.NumberDecimalDigits 2 4
*/
import System.* ;
import System.Globalization.* ;
public class SamplesCultureInfo
{
public static void main(String[] args)
{
// Creates and initializes a CultureInfo.
CultureInfo myCI = new CultureInfo("en-US", false);
// Clones myCI and modifies the DTFI and NFI instances
// associated with the clone.
CultureInfo myCIclone = ((CultureInfo)(myCI.Clone()));
myCIclone.get_DateTimeFormat().set_AMDesignator( "a.m.");
myCIclone.get_DateTimeFormat().set_DateSeparator ("-");
myCIclone.get_NumberFormat().set_CurrencySymbol("USD");
myCIclone.get_NumberFormat().set_NumberDecimalDigits(4);
// Displays the properties of the DTFI and NFI instances associated
// with the original and with the clone.
Console.WriteLine("DTFI/NFI PROPERTY\tORIGINAL\tMODIFIED CLONE");
Console.WriteLine("DTFI.AMDesignator\t{0}\t\t{1}",
myCI.get_DateTimeFormat().get_AMDesignator(),
myCIclone.get_DateTimeFormat().get_AMDesignator());
Console.WriteLine("DTFI.DateSeparator\t{0}\t\t{1}",
myCI.get_DateTimeFormat().get_DateSeparator(),
myCIclone.get_DateTimeFormat().get_DateSeparator());
Console.WriteLine("NFI.CurrencySymbol\t{0}\t\t{1}",
myCI.get_NumberFormat().get_CurrencySymbol(),
myCIclone.get_NumberFormat().get_CurrencySymbol());
Console.WriteLine("NFI.NumberDecimalDigits\t{0}\t\t{1}",
System.Convert.ToString(
myCI.get_NumberFormat().get_NumberDecimalDigits()),
System.Convert.ToString(
myCIclone.get_NumberFormat().get_NumberDecimalDigits()));
} //main
} //SamplesCultureInfo
/*
This code produces the following output.
DTFI/NFI PROPERTY ORIGINAL MODIFIED CLONE
DTFI.AMDesignator AM a.m.
DTFI.DateSeparator / -
NFI.CurrencySymbol $ USD
NFI.NumberDecimalDigits 2 4
*/
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
.NET Framework
Compatible con: 2.0, 1.1, 1.0
.NET Compact Framework
Compatible con: 2.0, 1.0