UInt16.TryParse Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier non signé 16 bits. Une valeur de retour indique si la conversion a réussi ou a échoué.
Surcharges
TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt16) |
Tente d’analyser une étendue de caractères UTF-8 en une valeur. |
TryParse(ReadOnlySpan<Char>, UInt16) |
Tente de convertir la représentation sous forme de plage d'un nombre en son équivalent entier non signé 16 bits. Une valeur de retour indique si la conversion a réussi ou a échoué. |
TryParse(String, UInt16) |
Tente de convertir la représentation sous forme de chaîne d'un nombre en son équivalent entier non signé 16 bits. Une valeur de retour indique si la conversion a réussi ou a échoué. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt16) |
Tente d’analyser une étendue de caractères dans une valeur. |
TryParse(String, IFormatProvider, UInt16) |
Tente d’analyser une chaîne en une valeur. |
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt16) |
Tente d’analyser une étendue de caractères UTF-8 en une valeur. |
TryParse(ReadOnlySpan<Byte>, UInt16) |
Tente de convertir une étendue de caractères UTF-8 contenant la représentation sous forme de chaîne d’un nombre en entier non signé équivalent 16 bits. |
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16) |
Essaie de convertir la représentation sous forme de plage d'un nombre dans un style et un format propre à la culture spécifiés en son équivalent entier non signé 16 bits. Une valeur de retour indique si la conversion a réussi ou a échoué. |
TryParse(String, NumberStyles, IFormatProvider, UInt16) |
Essaie de convertir la représentation sous forme de chaîne d'un nombre dans un style et un format propre à la culture spécifiés en son équivalent entier non signé 16 bits. Une valeur de retour indique si la conversion a réussi ou a échoué. |
TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt16)
- Source:
- UInt16.cs
- Source:
- UInt16.cs
Tente d’analyser une étendue de caractères UTF-8 en une valeur.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = IUtf8SpanParsable<System::UInt16>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out ushort result);
static member TryParse : ReadOnlySpan<byte> * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As UShort) As Boolean
Paramètres
- utf8Text
- ReadOnlySpan<Byte>
Étendue de caractères UTF-8 à analyser.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture concernant utf8Text
.
- result
- UInt16
Au retour, contient le résultat d’une analyse utf8Text
réussie ou une valeur non définie en cas d’échec.
Retours
true
si utf8Text
a été correctement analysé ; sinon, false
.
S’applique à
TryParse(ReadOnlySpan<Char>, UInt16)
- Source:
- UInt16.cs
- Source:
- UInt16.cs
- Source:
- UInt16.cs
Important
Cette API n’est pas conforme CLS.
Tente de convertir la représentation sous forme de plage d'un nombre en son équivalent entier non signé 16 bits. Une valeur de retour indique si la conversion a réussi ou a échoué.
public:
static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::UInt16 % result);
public static bool TryParse (ReadOnlySpan<char> s, out ushort result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out ushort result);
static member TryParse : ReadOnlySpan<char> * uint16 -> bool
[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * uint16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As UShort) As Boolean
Paramètres
- s
- ReadOnlySpan<Char>
Plage contenant les caractères représentant le nombre à convertir.
- result
- UInt16
Quand cette méthode est retournée, contient la valeur de l'entier signé 16 bits équivalente au nombre contenu dans s
si la conversion a réussi, ou zéro si elle a échoué. La conversion échoue si le paramètre s
est null
ou Empty, ou s'il n'est pas au format approprié. ou représente un nombre inférieur à UInt16.MinValue ou supérieur à UInt16.MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result
sera remplacée.
Retours
true
si la conversion de s
est réussie ; sinon, false
.
- Attributs
S’applique à
TryParse(String, UInt16)
- Source:
- UInt16.cs
- Source:
- UInt16.cs
- Source:
- UInt16.cs
Important
Cette API n’est pas conforme CLS.
- Alternative à la conformité CLS
- System.Int32.TryParse(String, Int32)
Tente de convertir la représentation sous forme de chaîne d'un nombre en son équivalent entier non signé 16 bits. Une valeur de retour indique si la conversion a réussi ou a échoué.
public:
static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::UInt16 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, out ushort result);
public static bool TryParse (string? s, out ushort result);
[System.CLSCompliant(false)]
public static bool TryParse (string? s, out ushort result);
[<System.CLSCompliant(false)>]
static member TryParse : string * uint16 -> bool
static member TryParse : string * uint16 -> bool
Public Shared Function TryParse (s As String, ByRef result As UShort) As Boolean
Paramètres
- s
- String
Chaîne qui représente le nombre à convertir.
- result
- UInt16
Quand cette méthode est retournée, contient la valeur de l'entier signé 16 bits équivalente au nombre contenu dans s
si la conversion a réussi, ou zéro si elle a échoué. La conversion échoue si le s
paramètre est null
ou Empty, n’est pas au format correct ou représente un nombre inférieur à UInt16.MinValue ou supérieur à UInt16.MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result
sera remplacée.
Retours
true
si la conversion de s
est réussie ; sinon, false
.
- Attributs
Exemples
L’exemple suivant appelle la TryParse(String, UInt16) méthode une fois pour chaque élément d’un tableau de chaînes.
string[] numericStrings = { "1293.8", "+1671.7", "28347.",
" 33113684 ", "(0)", "-0", "-1",
"+1293617", "18-", "119870", "31,024",
" 3127094 ", "00700000" };
uint number;
foreach (string numericString in numericStrings)
{
if (UInt32.TryParse(numericString, out number))
Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
else
Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString);
}
// The example displays the following output:
// Cannot convert '1293.8' to a UInt32.
// Cannot convert '+1671.7' to a UInt32.
// Cannot convert '28347.' to a UInt32.
// Converted ' 33113684 ' to 33113684.
// Cannot convert '(0)' to a UInt32.
// Converted '-0' to 0.
// Cannot convert '-1' to a UInt32.
// Converted '+1293617' to 1293617.
// Cannot convert '18-' to a UInt32.
// Converted '119870' to 119870.
// Cannot convert '31,024' to a UInt32.
// Converted ' 3127094 ' to 3127094.
// Converted '0070000' to 70000.
let numericStrings =
[| "1293.8"; "+1671.7"; "28347."
" 33113684 "; "(0)"; "-0"; "-1"
"+1293617"; "18-"; "119870"; "31,024"
" 3127094 "; "00700000" |]
for numericString in numericStrings do
match UInt32.TryParse numericString with
| true, number ->
printfn $"Converted '{numericString}' to {number}."
| _ ->
printfn $"Cannot convert '{numericString}' to a UInt32."
// The example displays the following output:
// Cannot convert '1293.8' to a UInt32.
// Cannot convert '+1671.7' to a UInt32.
// Cannot convert '28347.' to a UInt32.
// Converted ' 33113684 ' to 33113684.
// Cannot convert '(0)' to a UInt32.
// Converted '-0' to 0.
// Cannot convert '-1' to a UInt32.
// Converted '+1293617' to 1293617.
// Cannot convert '18-' to a UInt32.
// Converted '119870' to 119870.
// Cannot convert '31,024' to a UInt32.
// Converted ' 3127094 ' to 3127094.
// Converted '0070000' to 70000.
Dim numericStrings() As String = {"1293.8", "+1671.7", "28347.",
" 33113684 ", "(0)", "-0", "-1",
"+1293617", "18-", "119870",
"31,024", " 3127094 ", "0070000" }
Dim number As UInteger
For Each numericString As String In numericStrings
If UInt32.TryParse(numericString, number) Then
Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
Else
Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString)
End If
Next
' The example displays the following output:
' Cannot convert '1293.8' to a UInt32.
' Cannot convert '+1671.7' to a UInt32.
' Cannot convert '28347.' to a UInt32.
' Converted ' 33113684 ' to 33113684.
' Cannot convert '(0)' to a UInt32.
' Converted '-0' to 0.
' Cannot convert '-1' to a UInt32.
' Converted '+1293617' to 1293617.
' Cannot convert '18-' to a UInt32.
' Converted '119870' to 119870.
' Cannot convert '31,024' to a UInt32.
' Converted ' 3127094 ' to 3127094.
' Converted '0070000' to 70000.
Remarques
La TryParse(String, UInt16) méthode est semblable à la Parse(String) méthode, sauf qu’elle ne lève pas d’exception si la conversion échoue. Cette méthode élimine la nécessité d’utiliser la gestion des exceptions pour tester un FormatException si s
n’est pas valide et ne peut pas être analysé avec succès.
Le s
paramètre doit être la représentation sous forme de chaîne d’un nombre décimal sous la forme suivante :
[ws] [sign] digits[ws]
Les éléments entre crochets ([ et ]) sont facultatifs. Le tableau suivant décrit chaque élément.
Élément | Description |
---|---|
ws | Espace blanc facultatif. |
sign | Signe facultatif. Les caractères de signe valides sont déterminés par les NumberFormatInfo.NegativeSign propriétés et NumberFormatInfo.PositiveSign de la culture actuelle. |
chiffres | Séquence de chiffres décimaux compris entre 0 et 9. |
Notes
La chaîne spécifiée par le s
paramètre ne peut pas contenir de séparateurs de groupe ou de séparateur décimal, et elle ne peut pas avoir de partie décimale.
Le s
paramètre est interprété à l’aide du NumberStyles.Integer style . En plus des chiffres décimaux, seuls les espaces de début et de fin avec un signe de début sont autorisés. Pour définir explicitement les éléments de style avec les informations de mise en forme spécifiques à la culture qui peuvent être présentes dans s
, appelez la TryParse(String, NumberStyles, IFormatProvider, UInt16) méthode .
Le s
paramètre est analysé à l’aide des informations de mise en forme d’un NumberFormatInfo objet pour la culture système actuelle. Pour plus d'informations, consultez NumberFormatInfo.CurrentInfo.
Cette surcharge interprète tous les chiffres du s
paramètre comme des chiffres décimaux. Pour analyser la représentation sous forme de chaîne d’un nombre hexadécimal, appelez plutôt la TryParse(String, NumberStyles, IFormatProvider, UInt16) surcharge.
Voir aussi
- Parse(String)
- ToString()
- Analyse de chaînes numériques dans .NET
- Exemple : utilitaire de mise en forme .NET Core WinForms (C#)
- Exemple : utilitaire de mise en forme .NET Core WinForms (Visual Basic)
S’applique à
TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt16)
- Source:
- UInt16.cs
- Source:
- UInt16.cs
- Source:
- UInt16.cs
Tente d’analyser une étendue de caractères dans une valeur.
public:
static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = ISpanParsable<System::UInt16>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out ushort result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As UShort) As Boolean
Paramètres
- s
- ReadOnlySpan<Char>
Étendue des caractères à analyser.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture concernant s
.
- result
- UInt16
Lorsque cette méthode retourne, contient le résultat de l’analyse s
réussie ou une valeur non définie en cas d’échec.
Retours
true
si s
a été correctement analysé ; sinon, false
.
S’applique à
TryParse(String, IFormatProvider, UInt16)
- Source:
- UInt16.cs
- Source:
- UInt16.cs
- Source:
- UInt16.cs
Tente d’analyser une chaîne en une valeur.
public:
static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = IParsable<System::UInt16>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out ushort result);
static member TryParse : string * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As UShort) As Boolean
Paramètres
- s
- String
Chaîne à analyser.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture concernant s
.
- result
- UInt16
Lorsque cette méthode retourne, contient le résultat d’une analyse s
réussie ou une valeur non définie en cas d’échec.
Retours
true
si s
a été correctement analysé ; sinon, false
.
S’applique à
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt16)
- Source:
- UInt16.cs
- Source:
- UInt16.cs
Tente d’analyser une étendue de caractères UTF-8 en une valeur.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = System::Numerics::INumberBase<System::UInt16>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out ushort result);
static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean
Paramètres
- utf8Text
- ReadOnlySpan<Byte>
Étendue de caractères UTF-8 à analyser.
- style
- NumberStyles
Combinaison de styles numériques au niveau du bit qui peut être présente dans utf8Text
.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture concernant utf8Text
.
- result
- UInt16
Au retour, contient le résultat d’une analyse utf8Text
réussie ou une valeur non définie en cas d’échec.
Retours
true
si utf8Text
a été correctement analysé ; sinon, false
.
S’applique à
TryParse(ReadOnlySpan<Byte>, UInt16)
- Source:
- UInt16.cs
- Source:
- UInt16.cs
Tente de convertir une étendue de caractères UTF-8 contenant la représentation sous forme de chaîne d’un nombre en entier non signé équivalent 16 bits.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] System::UInt16 % result);
public static bool TryParse (ReadOnlySpan<byte> utf8Text, out ushort result);
static member TryParse : ReadOnlySpan<byte> * uint16 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As UShort) As Boolean
Paramètres
- utf8Text
- ReadOnlySpan<Byte>
Étendue contenant les caractères UTF-8 représentant le nombre à convertir.
- result
- UInt16
Lorsque cette méthode retourne, contient la valeur entière non signée 16 bits équivalente au nombre contenu dans utf8Text
si la conversion a réussi, ou zéro si la conversion a échoué. Ce paramètre est passé sous forme non initialisée. Toute valeur fournie initialement dans le résultat sera remplacée.
Retours
true
si la conversion de utf8Text
est réussie ; sinon, false
.
S’applique à
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16)
- Source:
- UInt16.cs
- Source:
- UInt16.cs
- Source:
- UInt16.cs
Important
Cette API n’est pas conforme CLS.
Essaie de convertir la représentation sous forme de plage d'un nombre dans un style et un format propre à la culture spécifiés en son équivalent entier non signé 16 bits. Une valeur de retour indique si la conversion a réussi ou a échoué.
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result);
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = System::Numerics::INumberBase<System::UInt16>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ushort result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out ushort result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ushort result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean
Paramètres
- s
- ReadOnlySpan<Char>
Plage contenant les caractères représentant le nombre à convertir. La plage est interprétée à l'aide du style spécifié par le paramètre style
.
- style
- NumberStyles
Combinaison d'opérations de bits de valeurs d'énumération qui indique le format autorisé du paramètre s
. Une valeur typique à spécifier est Integer.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture sur s
.
- result
- UInt16
Quand cette méthode est retournée, contient la valeur de l'entier signé 16 bits équivalente au nombre contenu dans s
si la conversion a réussi, ou zéro si elle a échoué. La conversion échoue si le s
paramètre est null
ou Empty, n’est pas dans un format conforme à style
, ou représente un nombre inférieur à UInt16.MinValue ou supérieur à UInt16.MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result
sera remplacée.
Retours
true
si la conversion de s
est réussie ; sinon, false
.
- Attributs
S’applique à
TryParse(String, NumberStyles, IFormatProvider, UInt16)
- Source:
- UInt16.cs
- Source:
- UInt16.cs
- Source:
- UInt16.cs
Important
Cette API n’est pas conforme CLS.
- Alternative à la conformité CLS
- System.Int32.TryParse(String, Int32)
Essaie de convertir la représentation sous forme de chaîne d'un nombre dans un style et un format propre à la culture spécifiés en son équivalent entier non signé 16 bits. Une valeur de retour indique si la conversion a réussi ou a échoué.
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result);
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt16 % result) = System::Numerics::INumberBase<System::UInt16>::TryParse;
[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ushort result);
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ushort result);
[System.CLSCompliant(false)]
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ushort result);
[<System.CLSCompliant(false)>]
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint16 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) As Boolean
Paramètres
- s
- String
Chaîne qui représente le nombre à convertir. La chaîne est interprétée à l'aide du style spécifié par le paramètre style
.
- style
- NumberStyles
Combinaison d'opérations de bits de valeurs d'énumération qui indique le format autorisé du paramètre s
. Une valeur typique à spécifier est Integer.
- provider
- IFormatProvider
Objet qui fournit des informations de mise en forme propres à la culture sur s
.
- result
- UInt16
Quand cette méthode est retournée, contient la valeur de l'entier signé 16 bits équivalente au nombre contenu dans s
si la conversion a réussi, ou zéro si elle a échoué. La conversion échoue si le s
paramètre est null
ou Empty, n’est pas dans un format conforme à style
, ou représente un nombre inférieur à UInt16.MinValue ou supérieur à UInt16.MaxValue. Ce paramètre est passé non initialisé ; toute valeur fournie initialement dans result
sera remplacée.
Retours
true
si la conversion de s
est réussie ; sinon, false
.
- Attributs
Exceptions
style
n’est pas une valeur NumberStyles.
- ou -
style
n’est pas une combinaison des valeurs AllowHexSpecifier et HexNumber.
Exemples
L’exemple suivant appelle la TryParse(String, NumberStyles, IFormatProvider, UInt16) méthode avec un certain nombre de chaînes et NumberStyles de valeurs différentes.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string numericString;
NumberStyles styles;
numericString = "10603";
styles = NumberStyles.Integer;
CallTryParse(numericString, styles);
numericString = "-10603";
styles = NumberStyles.None;
CallTryParse(numericString, styles);
numericString = "29103.00";
styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
CallTryParse(numericString, styles);
numericString = "10345.72";
styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
CallTryParse(numericString, styles);
numericString = "2210E-01";
styles = NumberStyles.Integer | NumberStyles.AllowExponent;
CallTryParse(numericString, styles);
numericString = "9112E-01";
CallTryParse(numericString, styles);
numericString = "312E01";
CallTryParse(numericString, styles);
numericString = "FFC8";
CallTryParse(numericString, NumberStyles.HexNumber);
numericString = "0x8F8C";
CallTryParse(numericString, NumberStyles.HexNumber);
}
private static void CallTryParse(string stringToConvert, NumberStyles styles)
{
ushort number;
bool result = UInt16.TryParse(stringToConvert, styles,
CultureInfo.InvariantCulture, out number);
if (result)
Console.WriteLine($"Converted '{stringToConvert}' to {number}.");
else
Console.WriteLine($"Attempted conversion of '{stringToConvert}' failed.");
}
}
// The example displays the following output:
// Converted '10603' to 10603.
// Attempted conversion of '-10603' failed.
// Converted '29103.00' to 29103.
// Attempted conversion of '10345.72' failed.
// Converted '2210E-01' to 221.
// Attempted conversion of '9112E-01' failed.
// Converted '312E01' to 3120.
// Converted 'FFC8' to 65480.
// Attempted conversion of '0x8F8C' failed.
open System
open System.Globalization
let callTryParse (stringToConvert: string) (styles: NumberStyles) =
match UInt16.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
| true, number ->
printfn $"Converted '{stringToConvert}' to {number}."
| _ ->
printfn $"Attempted conversion of '{stringToConvert}' failed."
do
let numericString = "10603"
let styles = NumberStyles.Integer
callTryParse numericString styles
let numericString = "-10603"
let styles = NumberStyles.None
callTryParse numericString styles
let numericString = "29103.00"
let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
callTryParse numericString styles
let numericString = "10345.72"
let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
callTryParse numericString styles
let numericString = "2210E-01"
let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
callTryParse numericString styles
let numericString = "9112E-01"
callTryParse numericString styles
let numericString = "312E01"
callTryParse numericString styles
let numericString = "FFC8"
callTryParse numericString NumberStyles.HexNumber
let numericString = "0x8F8C"
callTryParse numericString NumberStyles.HexNumber
// The example displays the following output:
// Converted '10603' to 10603.
// Attempted conversion of '-10603' failed.
// Converted '29103.00' to 29103.
// Attempted conversion of '10345.72' failed.
// Converted '2210E-01' to 221.
// Attempted conversion of '9112E-01' failed.
// Converted '312E01' to 3120.
// Converted 'FFC8' to 65480.
// Attempted conversion of '0x8F8C' failed.
Imports System.Globalization
Module Example
Public Sub Main()
Dim numericString As String
Dim styles As NumberStyles
numericString = "10603"
styles = NumberStyles.Integer
CallTryParse(numericString, styles)
numericString = "-10603"
styles = NumberStyles.None
CallTryParse(numericString, styles)
numericString = "29103.00"
styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
CallTryParse(numericString, styles)
numericString = "10345.72"
styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
CallTryParse(numericString, styles)
numericString = "2210E-01"
styles = NumberStyles.Integer Or NumberStyles.AllowExponent
CallTryParse(numericString, styles)
numericString = "9112E-01"
CallTryParse(numericString, styles)
numericString = "312E01"
CallTryParse(numericString, styles)
numericString = "FFC8"
CallTryParse(numericString, NumberStyles.HexNumber)
numericString = "0x8F8C"
CallTryParse(numericString, NumberStyles.HexNumber)
End Sub
Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
Dim number As UShort
Dim result As Boolean = UInt16.TryParse(stringToConvert, styles, _
CultureInfo.InvariantCulture, number)
If result Then
Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
Else
Console.WriteLine("Attempted conversion of '{0}' failed.", _
Convert.ToString(stringToConvert))
End If
End Sub
End Module
' The example displays the following output to the console:
' Converted '10603' to 10603.
' Attempted conversion of '-10603' failed.
' Converted '29103.00' to 29103.
' Attempted conversion of '10345.72' failed.
' Converted '2210E-01' to 221.
' Attempted conversion of '9112E-01' failed.
' Converted '312E01' to 3120.
' Converted 'FFC8' to 65480.
' Attempted conversion of '0x8F8C' failed.
Remarques
La TryParse(String, NumberStyles, IFormatProvider, UInt16) méthode est semblable à la Parse(String, NumberStyles, IFormatProvider) méthode, sauf qu’elle ne lève pas d’exception si la conversion échoue. Cette méthode élimine la nécessité d’utiliser la gestion des exceptions pour tester un FormatException si s
n’est pas valide et ne peut pas être analysé correctement.
Le style
paramètre définit les éléments de style (tels que les espaces blancs ou un signe positif ou négatif) autorisés dans le s
paramètre pour que l’opération d’analyse réussisse. Il doit s’agir d’une combinaison d’indicateurs de bits de l’énumération NumberStyles . Selon la valeur de style
, le s
paramètre peut inclure les éléments suivants :
[ws] [$][sign][digits,]digits[.fractional_digits][E[sign]exponential_digits][ws]
Les éléments entre crochets ([ et ]) sont facultatifs. Ou, si le style
paramètre inclut AllowHexSpecifier, le s
paramètre peut inclure les éléments suivants :
[ws] hexdigits[ws]
Le tableau suivant décrit chaque élément.
Ws Espace blanc facultatif. Les espaces blancs peuvent apparaître au début de s
si style
inclut l’indicateur NumberStyles.AllowLeadingWhite ou à la fin de s
si style
inclut l’indicateur NumberStyles.AllowTrailingWhite .
$ Symbole monétaire spécifique à la culture. Sa position dans la chaîne est définie par la CurrencyPositivePattern propriété de l’objet NumberFormatInfo retourné par la GetFormat méthode du provider
paramètre . Le symbole monétaire peut apparaître dans s
si style
inclut l’indicateur NumberStyles.AllowCurrencySymbol .
Signe Signe facultatif. Le signe peut apparaître au début de s
si style
inclut l’indicateur NumberStyles.AllowLeadingSign , et il peut apparaître à la fin de s
si style
inclut l’indicateur NumberStyles.AllowTrailingSign . Les parenthèses peuvent être utilisées dans s
pour indiquer une valeur négative si style
inclut l’indicateur NumberStyles.AllowParentheses . Toutefois, si le signe négatif est présent, s
ne peut représenter que la valeur zéro pour que l’opération d’analyse réussisse.
Chiffres Séquence de chiffres comprises entre 0 et 9.
, Séparateur de groupe spécifique à la culture. Le séparateur de groupe de la culture spécifiée par provider
peut apparaître dans s
si style
inclut l’indicateur NumberStyles.AllowThousands .
.
Symbole décimal spécifique à la culture. Le symbole décimal de la culture spécifiée par provider
peut apparaître dans s
si style
inclut l’indicateur NumberStyles.AllowDecimalPoint .
fractional_digits Une ou plusieurs occurrences du chiffre 0. Les chiffres fractionnaires ne peuvent apparaître dans s
que si style
inclut l’indicateur NumberStyles.AllowDecimalPoint .
E Caractère « e » ou « E », qui indique que la valeur est représentée en notation exponentielle (scientifique). Le s
paramètre peut représenter un nombre en notation exponentielle si style
inclut l’indicateur NumberStyles.AllowExponent .
exponential_digits Séquence de chiffres comprises entre 0 et 9. Le s
paramètre peut représenter un nombre en notation exponentielle si style
inclut l’indicateur NumberStyles.AllowExponent .
hexdigits Séquence de chiffres hexadécimaux de 0 à f ou de 0 à F.
Notes
Tous les caractères NUL (U+0000) de fin dans s
sont ignorés par l’opération d’analyse, quelle que soit la valeur de l’argument style
.
Une chaîne avec des chiffres décimaux uniquement (qui correspond à l’indicateur NumberStyles.None ) analyse toujours correctement. La plupart des membres restants NumberStyles contrôlent les éléments qui peuvent être présents, mais qui ne sont pas obligatoirement présents, dans cette chaîne d’entrée. Le tableau suivant indique comment les membres individuels NumberStyles affectent les éléments qui peuvent être présents dans s
.
Valeurs non composites NumberStyles |
Éléments autorisés en valeur en plus des chiffres |
---|---|
None | Chiffres décimaux uniquement. |
AllowDecimalPoint | Éléments décimaux (.) et fractional_digits . Toutefois, fractional_digits ne doit se composer que d’un ou plusieurs chiffres 0, sinon la méthode retourne false . |
AllowExponent | Caractère « e » ou « E », qui indique une notation exponentielle, ainsi que exponential_digits. Si s représente un nombre en notation exponentielle, il ne peut pas avoir un composant fractionnaire non nul. |
AllowLeadingWhite | Élément ws au début de s . |
AllowTrailingWhite | Élément ws à la fin de s . |
AllowLeadingSign | Élément sign avant les chiffres. |
AllowTrailingSign | Élément sign après les chiffres. |
AllowParentheses | Élément sign sous la forme de parenthèses englobant une valeur numérique nulle. |
AllowThousands | Élément séparateur de groupe (,). |
AllowCurrencySymbol | Élément currency ($). |
Currency | Tous les éléments. Toutefois, s ne peut pas représenter un nombre hexadécimal ou un nombre en notation exponentielle. |
Float | L’élément ws au début ou à la fin de s , signe au début de s , et le symbole décimal (.). Le s paramètre peut également utiliser la notation exponentielle. |
Number | Éléments ws, sign, séparateur de groupe (,) et décimale (.). |
Any | Tous les éléments. Toutefois, s ne peut pas représenter un nombre hexadécimal. |
Si l’indicateur NumberStyles.AllowHexSpecifier est utilisé, s
doit être une valeur hexadécimale. Les chiffres hexadécimaux valides sont de 0 à 9, de a à f et de A à F. Un préfixe tel que « 0x » n’est pas pris en charge et entraîne l’échec de l’opération d’analyse. Les seuls autres indicateurs qui peuvent être présents dans style
sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite. (L’énumération NumberStyles a un style composite, HexNumber, qui inclut les deux indicateurs d’espace blanc.)
Notes
Si s
est la représentation sous forme de chaîne d’un nombre hexadécimal, elle ne peut pas être précédée d’une décoration (telle que 0x
ou &h
) qui le différencie en tant que nombre hexadécimal. Cela entraîne l’échec de la conversion.
Le provider
paramètre est une IFormatProvider implémentation. Sa GetFormat méthode retourne un NumberFormatInfo objet qui fournit des informations spécifiques à la culture sur le format de s
. Le provider
paramètre peut être l’un des éléments suivants :
Objet CultureInfo qui représente la culture qui fournit des informations de mise en forme. Sa GetFormat méthode retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme numérique pour cette culture.
Objet NumberFormatInfo qui fournit des informations de mise en forme numérique. (Son implémentation de GetFormat retourne simplement elle-même.)
Objet personnalisé qui implémente IFormatProvider. Sa GetFormat méthode instancie et retourne l’objet NumberFormatInfo qui fournit des informations de mise en forme.
Si provider
est null
, l’objet NumberFormatInfo de la culture actuelle est utilisé.
Voir aussi
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour