Int64.TryParse Method (String, Int64)
Converts the string representation of a number to its 64-bit signed integer equivalent. A return value indicates whether the conversion succeeded or failed.
Assembly: mscorlib (in mscorlib.dll)
A string containing a number to convert.
When this method returns, contains the 64-bit signed integer value equivalent of the number contained in s, if the conversion succeeded, or zero if the conversion failed. The conversion fails if the s parameter is null or String.Empty, is not of the correct format, or represents a number less than Int64.MinValue or greater than Int64.MaxValue. This parameter is passed uninitialized; any value originally supplied in result will be overwritten.
Return ValueType: System.Boolean
true if s was converted successfully; otherwise, false.
The Parse method, except the method does not throw an exception if the conversion fails. It eliminates the need to use exception handling to test for a FormatException in the event that s is invalid and cannot be successfully parsed.method is like the
The s parameter contains a number of the form:
Elements in square brackets ([ and ]) are optional. The following table describes each element.
An optional white space.
An optional sign.
A sequence of digits ranging from 0 to 9.
The s parameter is interpreted using the NumberStyles.Integer style. In addition to the decimal digits, only leading and trailing spaces together with a leading sign are allowed. To explicitly define the style elements together with the culture-specific formatting information that can be present in s, use the TryParse(String, NumberStyles, IFormatProvider, Int64) method.
This overload of the TryParse method interprets all digits in the s parameter as decimal digits. To parse the string representation of a hexadecimal number, call the TryParse(String, NumberStyles, IFormatProvider, Int64) overload.
The following example calls themethod with a number of different string values.
Some of the strings that themethod is unable to convert in this example are:
"9432.0". The conversion fails because the string cannot contain a decimal separator; it must contain integral digits only.
"16,667". The conversion fails because the string cannot contain group separators; it must contain integral digits only.
"(100)". The conversion fails because the string cannot contain a negative sign other than the one defined by the current culture's NumberFormatInfo.NegativeSign and NumberFormatInfo.NumberNegativePattern properties.
"01FA". The conversion fails because the string cannot contain hexadecimal digits; it must contain decimal digits only.
Available since 8
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Available since 8.1