Convert.ToUInt32, méthode (String, IFormatProvider)
.NET Framework 3.0
Convertit la représentation String spécifiée d'un nombre en un entier non signé 32 bits équivalent à l'aide des informations de mise en forme propres à la culture spécifiées.
Cette méthode n'est pas conforme CLS. Espace de noms: System
Assembly : mscorlib (dans mscorlib.dll)
Assembly : mscorlib (dans mscorlib.dll)
[CLSCompliantAttribute(false)] public static uint ToUInt32 ( string value, IFormatProvider provider )
/** @attribute CLSCompliantAttribute(false) */ public static UInt32 ToUInt32 ( String value, IFormatProvider provider )
CLSCompliantAttribute(false) public static function ToUInt32 ( value : String, provider : IFormatProvider ) : uint
Non applicable.
Paramètres
- value
String contenant un nombre à convertir.
- provider
Implémentation de l'interface IFormatProvider qui fournit des informations de mise en forme propres à la culture.
Valeur de retour
Entier non signé 32 bits équivalant à la valeur de value. - ou - Zéro si value est référence Null (Nothing en Visual Basic).La valeur de retour est le résultat de l'appel à la méthode UInt32.Parse sur value.
provider est une instance de IFormatProvider obtenant un objet NumberFormatInfo. L'objet NumberFormatInfo fournit des informations propres à la culture sur le format de value. Si provider est référence Null (Nothing en Visual Basic), NumberFormatInfo de la culture en cours est utilisé.
L'exemple de code suivant convertit les représentations String des entiers 32 bits non signés avec la méthode ToUInt32, à l'aide d'un objet IFormatProvider.
// Example of the Convert.ToUInt32( string ) and // Convert.ToUInt32( string, IFormatProvider ) methods. using System; using System.Globalization; class ToUInt32ProviderDemo { static string format = "{0,-22}{1,-20}{2}"; // Get the exception type name; remove the namespace prefix. static string GetExceptionType( Exception ex ) { string exceptionType = ex.GetType( ).ToString( ); return exceptionType.Substring( exceptionType.LastIndexOf( '.' ) + 1 ); } static void ConvertToUInt32( string numericStr, IFormatProvider provider ) { object defaultValue; object providerValue; // Convert numericStr to UInt32 without a format provider. try { defaultValue = Convert.ToUInt32( numericStr ); } catch( Exception ex ) { defaultValue = GetExceptionType( ex ); } // Convert numericStr to UInt32 with a format provider. try { providerValue = Convert.ToUInt32( numericStr, provider ); } catch( Exception ex ) { providerValue = GetExceptionType( ex ); } Console.WriteLine( format, numericStr, defaultValue, providerValue ); } public static void Main( ) { // Create a NumberFormatInfo object and set several of its // properties that apply to numbers. NumberFormatInfo provider = new NumberFormatInfo(); // These properties affect the conversion. provider.NegativeSign = "neg "; provider.PositiveSign = "pos "; // These properties do not affect the conversion. // The input string cannot have decimal and group separators. provider.NumberDecimalSeparator = "."; provider.NumberGroupSeparator = ","; provider.NumberGroupSizes = new int[ ] { 3 }; Console.WriteLine("This example of\n" + " Convert.ToUInt32( string ) and \n" + " Convert.ToUInt32( string, IFormatProvider ) " + "\ngenerates the following output. It converts " + "several strings to \nuint values, using " + "default formatting or a NumberFormatInfo object.\n" ); Console.WriteLine( format, "String to convert", "Default/exception", "Provider/exception" ); Console.WriteLine( format, "-----------------", "-----------------", "------------------" ); // Convert strings, with and without an IFormatProvider. ConvertToUInt32( "123456789", provider ); ConvertToUInt32( "+123456789", provider ); ConvertToUInt32( "pos 123456789", provider ); ConvertToUInt32( "123456789.", provider ); ConvertToUInt32( "123,456,789", provider ); ConvertToUInt32( "4294967295", provider ); ConvertToUInt32( "4294967296", provider ); ConvertToUInt32( "-1", provider ); } } /* This example of Convert.ToUInt32( string ) and Convert.ToUInt32( string, IFormatProvider ) generates the following output. It converts several strings to uint values, using default formatting or a NumberFormatInfo object. String to convert Default/exception Provider/exception ----------------- ----------------- ------------------ 123456789 123456789 123456789 +123456789 123456789 FormatException pos 123456789 FormatException 123456789 123456789. FormatException FormatException 123,456,789 FormatException FormatException 4294967295 4294967295 4294967295 4294967296 OverflowException OverflowException -1 OverflowException FormatException */
// Example of the Convert.ToUInt32( string ) and
// Convert.ToUInt32( string, IFormatProvider ) methods.
import System.* ;
import System.Globalization.* ;
class ToUInt32ProviderDemo
{
private static String format = "{0,-22}{1,-20}{2}";
// Get the exception type name; remove the namespace prefix.
static String GetExceptionType(System.Exception ex)
{
String exceptionType = ex.GetType().ToString();
return exceptionType.Substring((exceptionType.LastIndexOf('.') + 1));
} //GetExceptionType
static void ConvertToUInt32(String numericStr, IFormatProvider provider)
{
Object defaultValue;
Object providerValue;
// Convert numericStr to UInt32 without a format provider.
try {
defaultValue = Convert.ToUInt32(numericStr);
}
catch (System.Exception ex) {
defaultValue = GetExceptionType(ex);
}
// Convert numericStr to UInt32 with a format provider.
try {
providerValue = Convert.ToUInt32(numericStr, provider);
}
catch (System.Exception ex) {
providerValue = GetExceptionType(ex);
}
Console.WriteLine(format, numericStr, defaultValue, providerValue);
} //ConvertToUInt32
public static void main(String[] args)
{
// Create a NumberFormatInfo object and set several of its
// properties that apply to numbers.
NumberFormatInfo provider = new NumberFormatInfo();
// These properties affect the conversion.
provider.set_NegativeSign("neg ");
provider.set_PositiveSign("pos ");
// These properties do not affect the conversion.
// The input string cannot have decimal and group separators.
provider.set_NumberDecimalSeparator(".");
provider.set_NumberGroupSeparator(",");
provider.set_NumberGroupSizes(new int[] { 3 });
Console.WriteLine(("This example of\n"
+ " Convert.ToUInt32( string ) and \n"
+ " Convert.ToUInt32( string, IFormatProvider ) "
+ "\ngenerates the following output. It converts "
+ "several strings to \nuint values, using "
+ "default formatting or a NumberFormatInfo object.\n"));
Console.WriteLine(format, "String to convert", "Default/exception",
"Provider/exception");
Console.WriteLine(format, "-----------------", "-----------------",
"------------------");
// Convert strings, with and without an IFormatProvider.
ConvertToUInt32("123456789", provider);
ConvertToUInt32("+123456789", provider);
ConvertToUInt32("pos 123456789", provider);
ConvertToUInt32("123456789.", provider);
ConvertToUInt32("123,456,789", provider);
ConvertToUInt32("4294967295", provider);
ConvertToUInt32("4294967296", provider);
ConvertToUInt32("-1", provider);
} //main
} //ToUInt32ProviderDemo
/*
This example of
Convert.ToUInt32( string ) and
Convert.ToUInt32( string, IFormatProvider )
generates the following output. It converts several strings to
uint values, using default formatting or a NumberFormatInfo object.
String to convert Default/exception Provider/exception
----------------- ----------------- ------------------
123456789 123456789 123456789
+123456789 123456789 FormatException
pos 123456789 FormatException 123456789
123456789. FormatException FormatException
123,456,789 FormatException FormatException
4294967295 4294967295 4294967295
4294967296 OverflowException OverflowException
-1 OverflowException FormatException
*/
Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.