Version.Parse Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Converts the string representation of a version number to an equivalent Version object.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- input
- Type: System.String
A string that contains a version number to convert.
Return Value
Type: System.VersionAn object that is equivalent to the version number specified in the input parameter.
| Exception | Condition |
|---|---|
| ArgumentNullException | input is Nothing. |
| ArgumentException | input has fewer than two or more than four version components. |
| ArgumentOutOfRangeException | At least one component in input is less than zero. |
| FormatException | At least one component in input is not an integer. |
| OverflowException | At least one component in input represents a number that is greater than Int32.MaxValue. |
The input parameter must have the following format:
major.minor[.build[.revision]]
where major, minor, build, and revision are the string representations of the version number's four components: major version number, minor version number, build number, and revision number. Optional components are shown in square brackets ([ and ]). The components must appear in the specified order, and must be separated by periods.
Important Note: |
|---|
Because the string representation of a version number must conform to a recognized pattern, applications should always use exception handling when calling the Parse method to parse user input. Alternatively, you can call the TryParse method to parse the string representation of a version number and return a value that indicates whether the parse operation succeeded. |
The Parse method is a convenience method; it is equivalent to calling the Version(String) constructor.
The following example uses the Parse method to parse a number of strings that contain version information.
Module Example Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock) Dim input As String = "4.0" ParseVersion(outputBlock, input) input = "4.0." ParseVersion(outputBlock, input) input = "1.1.2" ParseVersion(outputBlock, input) input = "1.1.2.01702" ParseVersion(outputBlock, input) input = "1.1.2.0702.119" ParseVersion(outputBlock, input) input = "1.3.5.2150000000" ParseVersion(outputBlock, input) End Sub Private Sub ParseVersion(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal input As String) Try Dim ver As Version = Version.Parse(input) outputBlock.Text += String.Format("Converted '{0} to {1}.", input, ver) & vbCrLf Catch e As ArgumentNullException outputBlock.Text &= "Error: String to be parsed is null." & vbCrLf Catch e As ArgumentOutOfRangeException outputBlock.Text += String.Format("Error: Negative value in '{0}'.", input) & vbCrLf Catch e As ArgumentException outputBlock.Text += String.Format("Error: Bad number of components in '{0}'.", _ input) & vbCrLf Catch e As FormatException outputBlock.Text += String.Format("Error: Non-integer value in '{0}'.", input) & vbCrLf Catch e As OverflowException outputBlock.Text += String.Format("Error: Number out of range in '{0}'.", input) & vbCrLf End Try End Sub End Module ' The example displays the following output: ' Converted '4.0 to 4.0. ' Error: Non-integer value in '4.0.'. ' Converted '1.1.2 to 1.1.2. ' Converted '1.1.2.01702 to 1.1.2.1702. ' Error: Bad number of components in '1.1.2.0702.119'. ' Error: Number out of range in '1.3.5.2150000000'.
Important Note: