Int64.Parse Int64.Parse Int64.Parse Int64.Parse Method

Définition

Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier 64 bits signé.Converts the string representation of a number to its 64-bit signed integer equivalent.

Surcharges

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

Convertit la représentation sous forme de chaîne d'un nombre dans un style et un format propre à une culture spécifiés en entier 64 bits signé équivalent.Converts the string representation of a number in a specified style and culture-specific format to its 64-bit signed integer equivalent.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)
Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

Convertit une représentation d'un nombre sous forme de chaîne dans un style spécifié en entier 64 bits signé équivalent.Converts the string representation of a number in a specified style to its 64-bit signed integer equivalent.

Parse(String) Parse(String) Parse(String) Parse(String)

Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier 64 bits signé.Converts the string representation of a number to its 64-bit signed integer equivalent.

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

Convertit la représentation d'un nombre sous forme de chaîne dans un format propre à une culture spécifié en entier 64 bits signé équivalent.Converts the string representation of a number in a specified culture-specific format to its 64-bit signed integer equivalent.

Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider) Parse(String, NumberStyles, IFormatProvider)

Convertit la représentation sous forme de chaîne d'un nombre dans un style et un format propre à une culture spécifiés en entier 64 bits signé équivalent.Converts the string representation of a number in a specified style and culture-specific format to its 64-bit signed integer equivalent.

public:
 static long Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);
public static long Parse (string s, System.Globalization.NumberStyles style, IFormatProvider provider);
static member Parse : string * System.Globalization.NumberStyles * IFormatProvider -> int64
Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As Long

Paramètres

s
String String String String

Chaîne contenant un nombre à convertir.A string containing a number to convert.

style
NumberStyles NumberStyles NumberStyles NumberStyles

Combinaison de bits de valeurs d'énumération qui indique les éléments de style qui peuvent être présents dans s.A bitwise combination of enumeration values that indicates the style elements that can be present in s. Une valeur typique à spécifier est Integer.A typical value to specify is Integer.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

IFormatProvider qui fournit des informations de format propres à la culture concernant s.An IFormatProvider that supplies culture-specific formatting information about s.

Retours

Entier 64 bits signé équivalant au nombre spécifié dans s.A 64-bit signed integer equivalent to the number specified in s.

Exceptions

style n’est pas une valeur NumberStyles.style is not a NumberStyles value.

- ou --or- style n’est pas une combinaison des valeurs AllowHexSpecifier et HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

s n’est pas dans un format compatible avec style.s is not in a format compliant with style.

s représente un nombre inférieur à MinValue ou supérieur à MaxValue.s represents a number less than MinValue or greater than MaxValue.

ou-or- style prend en charge les chiffres fractionnaires, mais s inclut des chiffres fractionnaires différents de zéro.style supports fractional digits, but s includes non-zero fractional digits.

Exemples

L’exemple suivant utilise une variété de style paramètres provider et pour analyser les représentations sous forme Int64 de chaîne de valeurs.The following example uses a variety of style and provider parameters to parse the string representations of Int64 values. Il illustre également les différentes façons dont la même chaîne peut être interprétée en fonction de la culture dont les informations de mise en forme sont utilisées pour l’opération d’analyse.It also illustrates some of the different ways the same string can be interpreted depending on the culture whose formatting information is used for the parsing operation.

using System;
using System.Globalization;

public class ParseInt64
{
   public static void Main()
   {
      Convert("12,000", NumberStyles.Float | NumberStyles.AllowThousands, 
              new CultureInfo("en-GB"));
      Convert("12,000", NumberStyles.Float | NumberStyles.AllowThousands,
              new CultureInfo("fr-FR"));
      Convert("12,000", NumberStyles.Float, new CultureInfo("en-US"));
      
      Convert("12 425,00", NumberStyles.Float | NumberStyles.AllowThousands,
              new CultureInfo("sv-SE"));
      Convert("12,425.00", NumberStyles.Float | NumberStyles.AllowThousands,
              NumberFormatInfo.InvariantInfo);
      Convert("631,900", NumberStyles.Integer | NumberStyles.AllowDecimalPoint, 
              new CultureInfo("fr-FR"));
      Convert("631,900", NumberStyles.Integer | NumberStyles.AllowDecimalPoint,
              new CultureInfo("en-US"));
      Convert("631,900", NumberStyles.Integer | NumberStyles.AllowThousands,
              new CultureInfo("en-US"));
   }

   private static void Convert(string value, NumberStyles style, 
                               IFormatProvider provider)
   {
      try
      {
         long number = Int64.Parse(value, style, provider);
         Console.WriteLine("Converted '{0}' to {1}.", value, number);
      }
      catch (FormatException)
      {
         Console.WriteLine("Unable to convert '{0}'.", value);
      }   
      catch (OverflowException)
      {
         Console.WriteLine("'{0}' is out of range of the Int64 type.", value);   
      }
   }                               
}
// This example displays the following output to the console:
//       Converted '12,000' to 12000.
//       Converted '12,000' to 12.
//       Unable to convert '12,000'.
//       Converted '12 425,00' to 12425.
//       Converted '12,425.00' to 12425.
//       '631,900' is out of range of the Int64 type.
//       Unable to convert '631,900'.
//       Converted '631,900' to 631900.
Imports System.Globalization

Module ParseInt64
   Public Sub Main()
      Convert("12,000", NumberStyles.Float Or NumberStyles.AllowThousands, _
              New CultureInfo("en-GB"))      
      Convert("12,000", NumberStyles.Float Or NumberStyles.AllowThousands, _
              New CultureInfo("fr-FR"))
      Convert("12,000", NumberStyles.Float, New CultureInfo("en-US"))
      
      Convert("12 425,00", NumberStyles.Float Or NumberStyles.AllowThousands, _
              New CultureInfo("sv-SE")) 
      Convert("12,425.00", NumberStyles.Float Or NumberStyles.AllowThousands, _
              NumberFormatInfo.InvariantInfo) 
      Convert("631,900", NumberStyles.Integer Or NumberStyles.AllowDecimalPoint, _ 
              New CultureInfo("fr-FR"))
      Convert("631,900", NumberStyles.Integer Or NumberStyles.AllowDecimalPoint, _
              New CultureInfo("en-US"))
      Convert("631,900", NumberStyles.Integer Or NumberStyles.AllowThousands, _
              New CultureInfo("en-US"))
   End Sub

   Private Sub Convert(value As String, style As NumberStyles, _
                       provider As IFormatProvider)
      Try
         Dim number As Long = Int64.Parse(value, style, provider)
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Catch e As FormatException
         Console.WriteLine("Unable to convert '{0}'.", value)
      Catch e As OverflowException
         Console.WriteLine("'{0}' is out of range of the Int64 type.", value)   
      End Try
   End Sub                       
End Module
' This example displays the following output to the console:
'       Converted '12,000' to 12000.
'       Converted '12,000' to 12.
'       Unable to convert '12,000'.
'       Converted '12 425,00' to 12425.
'       Converted '12,425.00' to 12425.
'       '631,900' is out of range of the Int64 type.
'       Unable to convert '631,900'.
'       Converted '631,900' to 631900.

Remarques

Le style paramètre définit les éléments de style (tels qu’un espace blanc ou le signe positif) qui sont autorisés s dans le paramètre pour que l’opération d’analyse aboutisse.The style parameter defines the style elements (such as white space or the positive sign) that are allowed in the s parameter for the parse operation to succeed. Il doit s’agir d’une combinaison de bits indicateurs NumberStyles de l’énumération.It must be a combination of bit flags from the NumberStyles enumeration. Selon la valeur de style, le s paramètre peut inclure les éléments suivants:Depending on the value of style, the s parameter may include the following elements:

[ws][$][sign][digits,]digits[.fractional_digits][e[sign]exponential_digits][ws][ws][$][sign][digits,]digits[.fractional_digits][e[sign]exponential_digits][ws]

Ou, si style comprend AllowHexSpecifier:Or, if style includes AllowHexSpecifier:

[ws]hexdigits[ws][ws]hexdigits[ws]

Les éléments entre crochets ([ et ]) sont facultatifs.Elements in square brackets ([ and ]) are optional. Le tableau suivant décrit chaque élément.The following table describes each element.

ÉlémentElement DescriptionDescription
wsws Espace blanc facultatif.Optional white space. Un espace blanc peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingWhite indicateur, et il peut apparaître à la fin de s si style comprend l' NumberStyles.AllowTrailingWhite indicateur.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ Symbole monétaire propre à la culture.A culture-specific currency symbol. Sa position dans la chaîne est définie par la NumberFormatInfo.CurrencyPositivePattern propriété de l' NumberFormatInfo objet retourné provider par la GetFormat méthode du paramètre.Its position in the string is defined by the NumberFormatInfo.CurrencyPositivePattern property of the NumberFormatInfo object returned by the GetFormat method of the provider parameter. Le symbole monétaire peut apparaître dans s si style comprend l' NumberStyles.AllowCurrencySymbol indicateur.The currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Signe facultatif.An optional sign. Le signe peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingSign indicateur ou à la fin de s si style contient l' NumberStyles.AllowTrailingSign indicateur.The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag or at the end of s if style includes the NumberStyles.AllowTrailingSign flag. Les parenthèses peuvent être utilisées s dans pour indiquer une valeur négative style si comprend NumberStyles.AllowParentheses l’indicateur.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
digitsdigits

fractional_digitsfractional_digits

exponential_digitsexponential_digits
Séquence de chiffres comprise entre 0 et 9.A sequence of digits from 0 through 9.
,, Symbole de séparateur des milliers spécifique à la culture.A culture-specific thousands separator symbol. Le séparateur des milliers de la culture spécifiée provider par peut apparaître s dans style si comprend NumberStyles.AllowThousands l’indicateur.The thousands separator of the culture specified by provider can appear in s if style includes the NumberStyles.AllowThousands flag.
.. Symbole de virgule décimale propre à la culture.A culture-specific decimal point symbol. Le symbole de virgule décimale de la culture provider spécifiée par peut s apparaître style dans si NumberStyles.AllowDecimalPoint comprend l’indicateur.The decimal point symbol of the culture specified by provider can appear in s if style includes the NumberStyles.AllowDecimalPoint flag.

Seul le chiffre 0 peut apparaître sous la forme d’un chiffre fractionnaire pour que l’opération d’analyse aboutisse. Si les chiffres_fractionnaires incluent tout autre chiffre, OverflowException une exception est levée.Only the digit 0 can appear as a fractional digit for the parse operation to succeed; if fractional_digits includes any other digit, an OverflowException is thrown.
ee Caractère « e » ou « E », qui indique que la valeur est représentée en notation exponentielle.The 'e' or 'E' character, which indicates that the value is represented in exponential notation. Le s paramètre peut représenter un nombre en notation exponentielle si style contient l' NumberStyles.AllowExponent indicateur.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Séquence de chiffres hexadécimaux comprise entre 0 et f, ou 0 et F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Notes

Les caractères null de fin (U + 0000) dans s sont ignorés par l’opération d’analyse, quelle que soit la valeur style de l’argument.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Une chaîne avec des chiffres décimaux uniquement (qui correspond au NumberStyles.None style) est toujours analysée correctement si elle se trouve dans la plage Int64 du type.A string with decimal digits only (which corresponds to the NumberStyles.None style) always parses successfully if it is in the range of the Int64 type. La plupart des membres NumberStyles restants contrôlent les éléments qui peuvent être présents dans cette chaîne d’entrée, mais qui ne doivent pas l’être.Most of the remaining NumberStyles members control elements that may be but are not required to be present in this input string. Le tableau suivant indique comment les NumberStyles membres individuels affectent les éléments qui peuvent être présents sdans.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Valeurs NumberStyles non compositesNon-composite NumberStyles values Éléments autorisés dans s en plus des chiffresElements permitted in s in addition to digits
NumberStyles.None Chiffres décimaux uniquement.Decimal digits only.
NumberStyles.AllowDecimalPoint Virgule décimale ( .The decimal point ( . ) et de chiffres fractionnaires .) and fractional-digits elements. Toutefois, les chiffres fractionnaires doivent être composés d’un ou plusieurs chiffres 0, sinon OverflowException une est levée.However, fractional-digits must consist of only one or more 0 digits or an OverflowException is thrown.
NumberStyles.AllowExponent Le s paramètre peut également utiliser la notation exponentielle.The s parameter can also use exponential notation.
NumberStyles.AllowLeadingWhite Élément WS au début de s.The ws element at the beginning of s.
NumberStyles.AllowTrailingWhite Élément WS à la fin de s.The ws element at the end of s.
NumberStyles.AllowLeadingSign Un signe peut apparaître avant les chiffres.A sign can appear before digits.
NumberStyles.AllowTrailingSign Un signe peut apparaître après des chiffres.A sign can appear after digits.
NumberStyles.AllowParentheses Élément de signe sous forme de parenthèses entourant la valeur numérique.The sign element in the form of parentheses enclosing the numeric value.
NumberStyles.AllowThousands Élément de séparateur des milliers ( , ).The thousands separator ( , ) element.
NumberStyles.AllowCurrencySymbol $ Élément.The $ element.

Si l' NumberStyles.AllowHexSpecifier indicateur est utilisé, s doit être une valeur hexadécimale sans préfixe.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. Par exemple, « C9AF3 » est analysé avec succès, mais pas « 0xC9AF3 ».For example, "C9AF3" parses successfully, but "0xC9AF3" does not. Les seuls autres indicateurs qui peuvent être présents dans style sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite.The only other flags that can be present in style are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (L' NumberStyles énumération a un style de nombre NumberStyles.HexNumbercomposite,, qui inclut les deux indicateurs d’espace blanc.)(The NumberStyles enumeration has a composite number style, NumberStyles.HexNumber, that includes both white space flags.)

Le provider paramètre est une IFormatProvider implémentation, telle qu’un NumberFormatInfo objet CultureInfo ou.The provider parameter is an IFormatProvider implementation, such as a NumberFormatInfo or CultureInfo object. Le provider paramètre fournit des informations propres à la culture utilisées lors de l’analyse.The provider parameter supplies culture-specific information used in parsing. Si provider est null, leNumberFormatInfo pour la culture actuelle est utilisé.If provider is null, the NumberFormatInfo for the current culture is used.

Voir aussi

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider) Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

public static long Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider provider = null);
static member Parse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider -> int64
Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = null) As Long

Paramètres

Retours

Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles) Parse(String, NumberStyles)

Convertit une représentation d'un nombre sous forme de chaîne dans un style spécifié en entier 64 bits signé équivalent.Converts the string representation of a number in a specified style to its 64-bit signed integer equivalent.

public:
 static long Parse(System::String ^ s, System::Globalization::NumberStyles style);
public static long Parse (string s, System.Globalization.NumberStyles style);
static member Parse : string * System.Globalization.NumberStyles -> int64
Public Shared Function Parse (s As String, style As NumberStyles) As Long

Paramètres

s
String String String String

Chaîne contenant un nombre à convertir.A string containing a number to convert.

style
NumberStyles NumberStyles NumberStyles NumberStyles

Combinaison d'opérations au niveau du bit de valeurs NumberStyles indiquant le format autorisé de s.A bitwise combination of NumberStyles values that indicates the permitted format of s. Une valeur typique à spécifier est Integer.A typical value to specify is Integer.

Retours

Entier 64 bits signé équivalant au nombre spécifié dans s.A 64-bit signed integer equivalent to the number specified in s.

Exceptions

style n’est pas une valeur NumberStyles.style is not a NumberStyles value.

- ou --or- style n’est pas une combinaison des valeurs AllowHexSpecifier et HexNumber.style is not a combination of AllowHexSpecifier and HexNumber values.

s n’est pas dans un format compatible avec style.s is not in a format compliant with style.

s représente un nombre inférieur à MinValue ou supérieur à MaxValue.s represents a number less than MinValue or greater than MaxValue.

- ou --or- style prend en charge les chiffres fractionnaires, mais s inclut des chiffres fractionnaires différents de zéro.style supports fractional digits but s includes non-zero fractional digits.

Exemples

L’exemple suivant utilise la Int64.Parse(String, NumberStyles) méthode pour analyser les représentations sous forme de Int64 chaîne de plusieurs valeurs.The following example uses the Int64.Parse(String, NumberStyles) method to parse the string representations of several Int64 values. La culture actuelle de l’exemple est en-US.The current culture for the example is en-US.

using System;
using System.Globalization;

public class ParseInt32
{
   public static void Main()
   {
      Convert("104.0", NumberStyles.AllowDecimalPoint);
      Convert("104.9", NumberStyles.AllowDecimalPoint);
      Convert (" 106034", NumberStyles.None);
      Convert(" $17,198,064.42", NumberStyles.AllowCurrencySymbol |
                                 NumberStyles.Number);
      Convert(" $17,198,064.00", NumberStyles.AllowCurrencySymbol |
                                 NumberStyles.Number);
      Convert("103E06", NumberStyles.AllowExponent);
      Convert("1200E-02", NumberStyles.AllowExponent);
      Convert("1200E-03", NumberStyles.AllowExponent);
      Convert("-1,345,791", NumberStyles.AllowThousands);
      Convert("(1,345,791)", NumberStyles.AllowThousands |
                             NumberStyles.AllowParentheses);
      Convert("FFCA00A0", NumberStyles.HexNumber);                       
      Convert("0xFFCA00A0", NumberStyles.HexNumber);                       
   }

   private static void Convert(string value, NumberStyles style)
   {
      try
      {
         long number = Int64.Parse(value, style);
         Console.WriteLine("Converted '{0}' to {1}.", value, number);
      }
      catch (FormatException)
      {
         Console.WriteLine("Unable to convert '{0}'.", value);
      }
      catch (OverflowException)
      {
         Console.WriteLine("'{0}' is out of range of the Int64 type.", value);   
      }
   }
}
// The example displays the following output to the console:
//       Converted '104.0' to 104.
//       '104.9' is out of range of the Int64 type.
//       Unable to convert ' 106034'.
//       ' $17,198,064.42' is out of range of the Int64 type.
//       Converted ' $17,198,064.00' to 17198064.
//       Converted '103E06' to 103000000.
//       Converted '1200E-02' to 12.
//       '1200E-03' is out of range of the Int64 type.
//       Unable to convert '-1,345,791'.
//       Converted '(1,345,791)' to -1345791.
//       Converted 'FFCA00A0' to 4291428512.
//       Unable to convert '0xFFCA00A0'.
Imports System.Globalization

Module ParseInt64
   Public Sub Main()
      Convert("104.0", NumberStyles.AllowDecimalPoint)    
      Convert("104.9", NumberStyles.AllowDecimalPoint)
      Convert (" 106034", NumberStyles.None)
      Convert(" $17,198,064.42", NumberStyles.AllowCurrencySymbol Or _
                                 NumberStyles.Number)
      Convert(" $17,198,064.00", NumberStyles.AllowCurrencySymbol Or _
                                 NumberStyles.Number)
      Convert("103E06", NumberStyles.AllowExponent)  
      Convert("1200E-02", NumberStyles.AllowExponent)
      Convert("1200E-03", NumberStyles.AllowExponent)
      Convert("-1,345,791", NumberStyles.AllowThousands)
      Convert("(1,345,791)", NumberStyles.AllowThousands Or _
                             NumberStyles.AllowParentheses)
      Convert("FFCA00A0", NumberStyles.HexNumber)                       
      Convert("0xFFCA00A0", NumberStyles.HexNumber)                       
   End Sub
   
   Private Sub Convert(value As String, style As NumberStyles)
      Try
         Dim number As Long = Int64.Parse(value, style)
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Catch e As FormatException
         Console.WriteLine("Unable to convert '{0}'.", value)
      Catch e As OverflowException
         Console.WriteLine("'{0}' is out of range of the Int64 type.", value)   
      End Try
   End Sub
End Module
' The example displays the following output to the console:
'       Converted '104.0' to 104.
'       '104.9' is out of range of the Int64 type.
'       Unable to convert ' 106034'.
'       ' $17,198,064.42' is out of range of the Int64 type.
'       Converted ' $17,198,064.00' to 17198064.
'       Converted '103E06' to 103000000.
'       Converted '1200E-02' to 12.
'       '1200E-03' is out of range of the Int64 type.
'       Unable to convert '-1,345,791'.
'       Converted '(1,345,791)' to -1345791.
'       Converted 'FFCA00A0' to 4291428512.
'       Unable to convert '0xFFCA00A0'.

Remarques

Le style paramètre définit les éléments de style (tels que les espaces blancs, le symbole de signe positif ou négatif ou le symbole de séparateur des milliers) qui s sont autorisés dans le paramètre pour que l’opération d’analyse aboutisse.The style parameter defines the style elements (such as white space, the positive or negative sign symbol, or the thousands separator symbol) that are allowed in the s parameter for the parse operation to succeed. Il doit s’agir d’une combinaison de bits indicateurs NumberStyles de l’énumération.It must be a combination of bit flags from the NumberStyles enumeration. Selon la valeur de style, le s paramètre peut contenir les éléments suivants :Depending on the value of style, the s parameter may contain the following elements:

[ws][$][sign][digits,]digits[.fractional_digits][e[sign]exponential_digits][ws][ws][$][sign][digits,]digits[.fractional_digits][e[sign]exponential_digits][ws]

Ou, si style comprend AllowHexSpecifier:Or, if style includes AllowHexSpecifier:

[ws]hexdigits[ws][ws]hexdigits[ws]

Les éléments entre crochets ([ et ]) sont facultatifs.Elements in square brackets ([ and ]) are optional. Le tableau suivant décrit chaque élément.The following table describes each element.

ÉlémentElement DescriptionDescription
wsws Espace blanc facultatif.Optional white space. Un espace blanc peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingWhite indicateur, et il peut apparaître à la fin de s si style comprend l' NumberStyles.AllowTrailingWhite indicateur.White space can appear at the beginning of s if style includes the NumberStyles.AllowLeadingWhite flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingWhite flag.
$ Symbole monétaire propre à la culture.A culture-specific currency symbol. Sa position dans la chaîne est définie par les NumberFormatInfo.CurrencyNegativePattern propriétés NumberFormatInfo.CurrencyPositivePattern et de la culture actuelle.Its position in the string is defined by the NumberFormatInfo.CurrencyNegativePattern and NumberFormatInfo.CurrencyPositivePattern properties of the current culture. Le symbole monétaire de la culture actuelle peut apparaître s dans style si comprend NumberStyles.AllowCurrencySymbol l’indicateur.The current culture's currency symbol can appear in s if style includes the NumberStyles.AllowCurrencySymbol flag.
signsign Signe facultatif.An optional sign. Le signe peut apparaître au début de s si style comprend l' NumberStyles.AllowLeadingSign indicateur, et il peut apparaître à la fin de s si style contient l' NumberStyles.AllowTrailingSign indicateur.The sign can appear at the beginning of s if style includes the NumberStyles.AllowLeadingSign flag, and it can appear at the end of s if style includes the NumberStyles.AllowTrailingSign flag. Les parenthèses peuvent être utilisées s dans pour indiquer une valeur négative style si comprend NumberStyles.AllowParentheses l’indicateur.Parentheses can be used in s to indicate a negative value if style includes the NumberStyles.AllowParentheses flag.
digitsdigits

fractional_digitsfractional_digits

exponential_digitsexponential_digits
Séquence de chiffres comprise entre 0 et 9.A sequence of digits from 0 through 9. Pour les chiffres_fractionnaires, seul le chiffre 0 est valide.For fractional_digits, only the digit 0 is valid.
,, Symbole de séparateur des milliers spécifique à la culture.A culture-specific thousands separator symbol. Le séparateur des milliers de la culture actuelle peut s apparaître style dans si NumberStyles.AllowThousands comprend l’indicateur.The current culture's thousands separator can appear in s if style includes the NumberStyles.AllowThousands flag.
.. Symbole de virgule décimale propre à la culture.A culture-specific decimal point symbol. Le symbole de virgule décimale de la culture actuelle s peut style apparaître dans NumberStyles.AllowDecimalPoint si comprend l’indicateur.The current culture's decimal point symbol can appear in s if style includes the NumberStyles.AllowDecimalPoint flag. Seul le chiffre 0 peut apparaître sous la forme d’un chiffre fractionnaire pour que l’opération d’analyse aboutisse. Si les chiffres_fractionnaires incluent tout autre chiffre, OverflowException une exception est levée.Only the digit 0 can appear as a fractional digit for the parse operation to succeed; if fractional_digits includes any other digit, an OverflowException is thrown.
ee Caractère « e » ou « E », qui indique que la valeur est représentée en notation exponentielle.The 'e' or 'E' character, which indicates that the value is represented in exponential notation. Le s paramètre peut représenter un nombre en notation exponentielle si style contient l' NumberStyles.AllowExponent indicateur.The s parameter can represent a number in exponential notation if style includes the NumberStyles.AllowExponent flag.
hexdigitshexdigits Séquence de chiffres hexadécimaux comprise entre 0 et f, ou 0 et F.A sequence of hexadecimal digits from 0 through f, or 0 through F.

Notes

Les caractères null de fin (U + 0000) dans s sont ignorés par l’opération d’analyse, quelle que soit la valeur style de l’argument.Any terminating NUL (U+0000) characters in s are ignored by the parsing operation, regardless of the value of the style argument.

Une chaîne avec des chiffres uniquement (qui correspond au NumberStyles.None style) est toujours analysée correctement si elle se trouve dans la plage Int64 du type.A string with digits only (which corresponds to the NumberStyles.None style) always parses successfully if it is in the range of the Int64 type. La plupart des membres NumberStyles restants contrôlent les éléments qui peuvent être présents dans la chaîne d’entrée, mais qui ne doivent pas l’être.Most of the remaining NumberStyles members control elements that may be but are not required to be present in the input string. Le tableau suivant indique comment les NumberStyles membres individuels affectent les éléments qui peuvent être présents sdans.The following table indicates how individual NumberStyles members affect the elements that may be present in s.

Valeur NumberStylesNumberStyles value Éléments autorisés dans s en plus des chiffresElements permitted in s in addition to digits
None Élément digits uniquement.The digits element only.
AllowDecimalPoint Virgule décimale ( .The decimal point ( . ) et de chiffres fractionnaires .) and fractional-digits elements.
AllowExponent Le s paramètre peut également utiliser la notation exponentielle.The s parameter can also use exponential notation. Si s représente un nombre en notation exponentielle, la valeur numérique obtenue ne peut pas inclure de chiffres fractionnaires différents de zéro.If s represents a number in exponential notation, the resulting numeric value cannot include any non-zero fractional digits.
AllowLeadingWhite Élément WS au début de s.The ws element at the beginning of s.
AllowTrailingWhite Élément WS à la fin de s.The ws element at the end of s.
AllowLeadingSign Élément signe au début de s.The sign element at the beginning of s.
AllowTrailingSign Élément signe à la fin de s.The sign element at the end of s.
AllowParentheses Élément de signe sous forme de parenthèses entourant la valeur numérique.The sign element in the form of parentheses enclosing the numeric value.
AllowThousands Élément de séparateur des milliers ( , ).The thousands separator ( , ) element.
AllowCurrencySymbol $ Élément.The $ element.
Currency Tout le monde.All. Le s paramètre ne peut pas représenter un nombre hexadécimal ou un nombre en notation exponentielle.The s parameter cannot represent a hexadecimal number or a number in exponential notation.
Float L’élément WS au début ou à la fin sde, se connecte au sdébut de et la virgule décimale ( .The ws element at the beginning or end of s, sign at the beginning of s, and the decimal point ( . symbole.) symbol. Le s paramètre peut également utiliser la notation exponentielle.The s parameter can also use exponential notation.
Number Le séparateur WS, le signe, les milliers ( , ) et la virgule décimale ( .The ws, sign, thousands separator ( , ), and decimal point ( . html.) elements.
Any Tous les styles, s à l’exception de ne peuvent pas représenter un nombre hexadécimal.All styles, except s cannot represent a hexadecimal number.

Si l' NumberStyles.AllowHexSpecifier indicateur est utilisé, s doit être une valeur hexadécimale sans préfixe.If the NumberStyles.AllowHexSpecifier flag is used, s must be a hexadecimal value without a prefix. Par exemple, « C9AF3 » est analysé avec succès, mais pas « 0xC9AF3 ».For example, "C9AF3" parses successfully, but "0xC9AF3" does not. Les seuls autres indicateurs qui peuvent être combinés avec le s paramètre sont NumberStyles.AllowLeadingWhite et NumberStyles.AllowTrailingWhite.The only other flags that can be combined with the s parameter are NumberStyles.AllowLeadingWhite and NumberStyles.AllowTrailingWhite. (L' NumberStyles énumération comprend un style de nombre NumberStyles.HexNumbercomposite,, qui comprend les deux indicateurs d’espace blanc.)(The NumberStyles enumeration includes a composite number style, NumberStyles.HexNumber, that includes both white space flags.)

Le s paramètre est analysé à l’aide des informations de mise en NumberFormatInfo forme d’un objet initialisé pour la culture système en cours.The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. Pour spécifier la culture dont les informations de mise en forme sont utilisées pour l’opération d' Int64.Parse(String, NumberStyles, IFormatProvider) analyse, appelez la surcharge.To specify the culture whose formatting information is used for the parse operation, call the Int64.Parse(String, NumberStyles, IFormatProvider) overload.

Voir aussi

Parse(String) Parse(String) Parse(String) Parse(String)

Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier 64 bits signé.Converts the string representation of a number to its 64-bit signed integer equivalent.

public:
 static long Parse(System::String ^ s);
public static long Parse (string s);
static member Parse : string -> int64
Public Shared Function Parse (s As String) As Long

Paramètres

s
String String String String

Chaîne contenant un nombre à convertir.A string containing a number to convert.

Retours

Entier 64 bits signé équivalant au nombre contenu dans s.A 64-bit signed integer equivalent to the number contained in s.

Exceptions

Le format de s est incorrect.s is not in the correct format.

s représente un nombre inférieur à MinValue ou supérieur à MaxValue.s represents a number less than MinValue or greater than MaxValue.

Exemples

L’exemple suivant montre comment convertir une valeur de chaîne en valeur entière signée 64 bits à l’aide de Int64.Parse(String) la méthode.The following example demonstrates how to convert a string value into a 64-bit signed integer value using the Int64.Parse(String) method. Il affiche ensuite la valeur de l’entier long résultant.It then displays the resulting long integer value.

using System;

public class ParseInt64
{
   public static void Main()
   {
      Convert("  179042  ");
      Convert(" -2041326 ");
      Convert(" +8091522 ");
      Convert("   1064.0   ");
      Convert("  178.3");
      Convert(String.Empty);
      Convert(((decimal) Int64.MaxValue) + 1.ToString());
   }

   private static void Convert(string value)
   {
      try
      {
         long number = Int64.Parse(value);
         Console.WriteLine("Converted '{0}' to {1}.", value, number);
      }
      catch (FormatException)
      {
         Console.WriteLine("Unable to convert '{0}'.", value);
      }
      catch (OverflowException)
      {
         Console.WriteLine("'{0}' is out of range.", value);
      }
   }
}
// This example displays the following output to the console:
//       Converted '  179042  ' to 179042.
//       Converted ' -2041326 ' to -2041326.
//       Converted ' +8091522 ' to 8091522.
//       Unable to convert '   1064.0   '.
//       Unable to convert '  178.3'.
//       Unable to convert ''.
//       '92233720368547758071' is out of range.
Module ParseInt64
   Public Sub Main()
      Convert("  179032  ")
      Convert(" -2041326 ")
      Convert(" +8091522 ")
      Convert("   1064.0   ")
      Convert("  178.3")
      Convert(String.Empty)
      Convert((CDec(Int64.MaxValue) + 1).ToString())
   End Sub

   Private Sub Convert(value As String)
      Try
         Dim number As Long = Int64.Parse(value)
         Console.WriteLine("Converted '{0}' to {1}.", value, number)
      Catch e As FormatException
         Console.WriteLine("Unable to convert '{0}'.", value)
      Catch e As OverflowException
         Console.WriteLine("'{0}' is out of range.", value)      
      End Try
   End Sub
End Module
' This example displays the following output to the console:
'       Converted '  179032  ' to 179032.
'       Converted ' -2041326 ' to -2041326.
'       Converted ' +8091522 ' to 8091522.
'       Unable to convert '   1064.0   '.
'       Unable to convert '  178.3'.
'       Unable to convert ''.
'       '9223372036854775808' is out of range.

Remarques

Le s paramètre contient un nombre au format suivant :The s parameter contains a number of the form:

[ws][sign]digits[ws][ws][sign]digits[ws]

Les éléments entre crochets ([ et ]) sont facultatifs.Elements in square brackets ([ and ]) are optional. Le tableau suivant décrit chaque élément.The following table describes each element.

ÉlémentElement DescriptionDescription
wsws Espace blanc facultatif.Optional white space.
signsign Signe facultatif.An optional sign.
chiffresdigits Séquence de chiffres allant de 0 à 9.A sequence of digits ranging from 0 to 9.

Le s paramètre est interprété à l' NumberStyles.Integer aide du style.The s parameter is interpreted using the NumberStyles.Integer style. En plus des chiffres décimaux, seuls les espaces de début et de fin, ainsi qu’un signe de début, sont autorisés.In addition to decimal digits, only leading and trailing spaces together with a leading sign are allowed. Pour définir explicitement les éléments de style qui peuvent être présents sdans, utilisez la Int64.Parse(String, NumberStyles) Int64.Parse(String, NumberStyles, IFormatProvider) méthode ou.To explicitly define the style elements that can be present in s, use either the Int64.Parse(String, NumberStyles) or the Int64.Parse(String, NumberStyles, IFormatProvider) method.

Le s paramètre est analysé à l’aide des informations de mise en NumberFormatInfo forme d’un objet initialisé pour la culture système en cours.The s parameter is parsed using the formatting information in a NumberFormatInfo object that is initialized for the current system culture. Pour analyser une chaîne à l’aide des informations de mise en forme d’une autre Int64.Parse(String, NumberStyles, IFormatProvider) culture, utilisez la méthode.To parse a string using the formatting information of some other culture, use the Int64.Parse(String, NumberStyles, IFormatProvider) method.

Voir aussi

Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider) Parse(String, IFormatProvider)

Convertit la représentation d'un nombre sous forme de chaîne dans un format propre à une culture spécifié en entier 64 bits signé équivalent.Converts the string representation of a number in a specified culture-specific format to its 64-bit signed integer equivalent.

public:
 static long Parse(System::String ^ s, IFormatProvider ^ provider);
public static long Parse (string s, IFormatProvider provider);
static member Parse : string * IFormatProvider -> int64
Public Shared Function Parse (s As String, provider As IFormatProvider) As Long

Paramètres

s
String String String String

Chaîne contenant un nombre à convertir.A string containing a number to convert.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Objet qui fournit des informations de mise en forme propres à la culture sur s.An object that supplies culture-specific formatting information about s.

Retours

Entier 64 bits signé équivalant au nombre spécifié dans s.A 64-bit signed integer equivalent to the number specified in s.

Exceptions

Le format de s est incorrect.s is not in the correct format.

s représente un nombre inférieur à MinValue ou supérieur à MaxValue.s represents a number less than MinValue or greater than MaxValue.

Exemples

L’exemple suivant est le gestionnaire d’événements de clic de bouton d’un formulaire Web.The following example is the button click event handler of a Web form. Elle utilise le tableau retourné par la HttpRequest.UserLanguages propriété pour déterminer les paramètres régionaux de l’utilisateur.It uses the array returned by the HttpRequest.UserLanguages property to determine the user's locale. Il instancie ensuite un CultureInfo objet qui correspond à ces paramètres régionaux.It then instantiates a CultureInfo object that corresponds to that locale. L' NumberFormatInfo objet qui appartient à cet CultureInfo objet est ensuite transmis à la Parse(String, IFormatProvider) méthode Int64 pour convertir l’entrée de l’utilisateur en valeur.The NumberFormatInfo object that belongs to that CultureInfo object is then passed to the Parse(String, IFormatProvider) method to convert the user's input to an Int64 value.

protected void OkToLong_Click(object sender, EventArgs e)
{
   string locale;
   long number;
   CultureInfo culture;

   // Return if string is empty
   if (String.IsNullOrEmpty(this.inputNumber.Text))
      return;

   // Get locale of web request to determine possible format of number
   if (Request.UserLanguages.Length == 0)
      return;
   locale = Request.UserLanguages[0];
   if (String.IsNullOrEmpty(locale))
      return;

  // Instantiate CultureInfo object for the user's locale
   culture = new CultureInfo(locale);

   // Convert user input from a string to a number
   try
   {
      number = Int64.Parse(this.inputNumber.Text, culture.NumberFormat);
   }
   catch (FormatException)
   {
      return;
   }
   catch (Exception)
   {
      return;
   }
   // Output number to label on web form
   this.outputNumber.Text = "Number is " + number.ToString();
}
Protected Sub OkToLong_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles OkToLong.Click
   Dim locale As String
   Dim culture As CultureInfo
   Dim number As Long

   ' Return if string is empty
   If String.IsNullOrEmpty(Me.inputNumber.Text) Then Exit Sub

   ' Get locale of web request to determine possible format of number
   If Request.UserLanguages.Length = 0 Then Exit Sub
   locale = Request.UserLanguages(0)
   If String.IsNullOrEmpty(locale) Then Exit Sub

   ' Instantiate CultureInfo object for the user's locale
   culture = New CultureInfo(locale)

   ' Convert user input from a string to a number
   Try
      number = Int64.Parse(Me.inputNumber.Text, culture.NumberFormat)
   Catch ex As FormatException
      Exit Sub
   Catch ex As Exception
      Exit Sub
   End Try

   ' Output number to label on web form
   Me.outputNumber.Text = "Number is " & number.ToString()
End Sub

Remarques

Cette surcharge de la Parse(String, IFormatProvider) méthode est généralement utilisée pour convertir du texte qui peut être mis en forme de différentes façons en Int64 une valeur.This overload of the Parse(String, IFormatProvider) method is typically used to convert text that can be formatted in a variety of ways to an Int64 value. Par exemple, il peut être utilisé pour convertir le texte entré par un utilisateur dans une zone de texte HTML en une valeur numérique.For example, it can be used to convert the text entered by a user into an HTML text box to a numeric value.

Le s paramètre contient un nombre au format suivant :The s parameter contains a number of the form:

[ws][sign]digits[ws][ws][sign]digits[ws]

Les éléments entre crochets ([et]) sont facultatifs, et les autres éléments sont les suivants.Items in square brackets ([ and ]) are optional, and other items are as follows.

wsws
Espace blanc facultatif.An optional white space.

signsign
Signe facultatif.An optional sign.

chiffresdigits
Séquence de chiffres allant de 0 à 9.A sequence of digits ranging from 0 to 9.

Le s paramètre est interprété à l' NumberStyles.Integer aide du style.The s parameter is interpreted using the NumberStyles.Integer style. En plus des chiffres décimaux, seuls les espaces de début et de fin, ainsi qu’un signe de début, sont autorisés.In addition to decimal digits, only leading and trailing spaces together with a leading sign are allowed. Pour définir explicitement les éléments de style qui peuvent être présents sdans, utilisez Int64.Parse(String, NumberStyles, IFormatProvider) la méthode.To explicitly define the style elements that can be present in s, use the Int64.Parse(String, NumberStyles, IFormatProvider) method.

Le provider paramètre est une IFormatProvider implémentation, telle qu’un NumberFormatInfo objet CultureInfo ou.The provider parameter is an IFormatProvider implementation, such as a NumberFormatInfo or CultureInfo object. Le provider paramètre fournit des informations propres à la culture sur le sformat de.The provider parameter supplies culture-specific information about the format of s. Si provider est null, leNumberFormatInfo pour la culture actuelle est utilisé.If provider is null, the NumberFormatInfo for the current culture is used.

Voir aussi

S’applique à