This topic has not yet been rated - Rate this topic

Convert.ToInt64 Method (String)

.NET Framework 3.5

Other Versions

Converts the specified string representation of a number to an equivalent 64-bit signed integer.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

C++

JScript

public static function ToInt64(
	value : String
) : long

Parameters

value: Type: System.String
A string that contains a number to convert.

Return Value

Type: System.Int64
A 64-bit signed integer that is equivalent to the number in value, or 0 (zero) if value is a null reference (Nothing in Visual Basic).

Exceptions

Exception	Condition
FormatException	value does not consist of an optional sign followed by a sequence of digits (0 through 9).
OverflowException	value represents a number that is less than Int64.MinValue or greater than Int64.MaxValue.

Remarks

The result of invoking the Int64.Parse method on value.

Examples

The following example attempts to convert each element in an array of numeric strings to a long integer.

JScript

No code example is currently available or this language may not be supported.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Reference

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD