Version.Parse Methode

Definitie

Naamruimte:: System

Assembly's:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Overloads

Name	Description
Parse(ReadOnlySpan<Byte>)	Converteert de opgegeven alleen-lezen periode van UTF-8 tekens die een versienummer vertegenwoordigen naar een equivalent versieobject.
Parse(ReadOnlySpan<Char>)	Converteert de opgegeven alleen-lezen periode met tekens die een versienummer vertegenwoordigen naar een gelijkwaardig Version object.
Parse(String)	Converteert de tekenreeksweergave van een versienummer naar een equivalent Version object.

Parse(ReadOnlySpan<Byte>)

Bron:: Version.cs

Bron:: Version.cs

Converteert de opgegeven alleen-lezen periode van UTF-8 tekens die een versienummer vertegenwoordigen naar een equivalent versieobject.

public:
 static Version ^ Parse(ReadOnlySpan<System::Byte> utf8Text);

public static Version Parse(ReadOnlySpan<byte> utf8Text);

static member Parse : ReadOnlySpan<byte> -> Version

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte)) As Version

Parameters

utf8Text: ReadOnlySpan<Byte>

Een alleen-lezen periode van UTF-8 tekens die een versienummer bevat dat moet worden geconverteerd.

Retouren

Version

Een object dat gelijk is aan het versienummer dat is opgegeven in de utf8Text parameter.

Uitzonderingen

ArgumentException

utf8Text heeft minder dan twee of meer dan vier versieonderdelen.

ArgumentOutOfRangeException

Ten minste één onderdeel in utf8Text is kleiner dan nul.

FormatException

Ten minste één onderdeel is utf8Text geen geheel getal.

OverflowException

Ten minste één onderdeel in utf8Text vertegenwoordigt een getal dat groter is dan MaxValue.

Van toepassing op

Parse(ReadOnlySpan<Char>)

Bron:: Version.cs

Bron:: Version.cs

Bron:: Version.cs

Bron:: Version.cs

Bron:: Version.cs

Converteert de opgegeven alleen-lezen periode met tekens die een versienummer vertegenwoordigen naar een gelijkwaardig Version object.

public:
 static Version ^ Parse(ReadOnlySpan<char> input);

public static Version Parse(ReadOnlySpan<char> input);

static member Parse : ReadOnlySpan<char> -> Version

Public Shared Function Parse (input As ReadOnlySpan(Of Char)) As Version

Parameters

input: ReadOnlySpan<Char>

Een alleen-lezen reeks tekens met een versienummer dat moet worden geconverteerd.

Retouren

Version

Een object dat gelijk is aan het versienummer dat is opgegeven in de input parameter.

Uitzonderingen

ArgumentException

input heeft minder dan twee of meer dan vier versieonderdelen.

ArgumentOutOfRangeException

Ten minste één onderdeel in input is kleiner dan nul.

FormatException

Ten minste één onderdeel is input geen geheel getal.

OverflowException

Ten minste één onderdeel in input vertegenwoordigt een getal dat groter is dan Int32.MaxValue.

Opmerkingen

De input parameter moet de volgende indeling hebben:

major.minor[.build[.revision]]

waarbij major, minor, builden revision zijn de tekenreeksweergaven van de vier onderdelen van het versienummer: primaire versienummer, secundair versienummer, buildnummer en revisienummer, respectievelijk. Optionele onderdelen worden weergegeven tussen vierkante haken ([ en ]). De onderdelen moeten worden weergegeven in de opgegeven volgorde en moeten worden gescheiden door punten.

Van toepassing op

Parse(String)

Bron:: Version.cs

Bron:: Version.cs

Bron:: Version.cs

Bron:: Version.cs

Bron:: Version.cs

Converteert de tekenreeksweergave van een versienummer naar een equivalent Version object.

public:
 static Version ^ Parse(System::String ^ input);

public static Version Parse(string input);

static member Parse : string -> Version

Public Shared Function Parse (input As String) As Version

Parameters

input: String

Een tekenreeks die een versienummer bevat dat moet worden geconverteerd.

Retouren

Version

Een object dat gelijk is aan het versienummer dat is opgegeven in de input parameter.

Uitzonderingen

ArgumentNullException

input is null.

ArgumentException

input heeft minder dan twee of meer dan vier versieonderdelen.

ArgumentOutOfRangeException

Ten minste één onderdeel in input is kleiner dan nul.

FormatException

Ten minste één onderdeel is input geen geheel getal.

OverflowException

Ten minste één onderdeel in input vertegenwoordigt een getal dat groter is dan Int32.MaxValue.

Voorbeelden

In het volgende voorbeeld wordt de Parse methode gebruikt om een aantal tekenreeksen te parseren die versie-informatie bevatten.

using System;

public class Example
{
   public static void Main()
   {
      string input = "4.0";
      ParseVersion(input);
      
      input = "4.0.";
      ParseVersion(input);
      
      input = "1.1.2";
      ParseVersion(input);
      
      input = "1.1.2.01702";
      ParseVersion(input);
      
      input = "1.1.2.0702.119";
      ParseVersion(input);
      
      input =  "1.3.5.2150000000";
      ParseVersion(input);
   }
   
   private static void ParseVersion(string input)
   {
      try {
         Version ver = Version.Parse(input);
         Console.WriteLine("Converted '{0} to {1}.", input, ver);
      }
      catch (ArgumentNullException) {
         Console.WriteLine("Error: String to be parsed is null.");
      }
      catch (ArgumentOutOfRangeException) {
         Console.WriteLine("Error: Negative value in '{0}'.", input);
      }
      catch (ArgumentException) {
         Console.WriteLine("Error: Bad number of components in '{0}'.", 
                           input);
      }
      catch (FormatException) {
         Console.WriteLine("Error: Non-integer value in '{0}'.", input);
      }
      catch (OverflowException) {   
         Console.WriteLine("Error: Number out of range in '{0}'.", input);                  
      }   
   }
}
// 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'.

open System

let parseVersion (input: string) =
    try
        let ver = Version.Parse input
        printfn $"Converted '{input} to {ver}."
    with
    | :? ArgumentNullException ->
        printfn "Error: String to be parsed is null."
    | :? ArgumentOutOfRangeException ->
        printfn $"Error: Negative value in '{input}'."
    | :? ArgumentException ->
        printfn $"Error: Bad number of components in '{input}'."
    | :? FormatException ->
        printfn $"Error: Non-integer value in '{input}'."
    | :? OverflowException ->
        printfn $"Error: Number out of range in '{input}'."                  

[<EntryPoint>]
let main _ =
    let input = "4.0"
    parseVersion input
    
    let input = "4.0."
    parseVersion input
    
    let input = "1.1.2"
    parseVersion input
    
    let input = "1.1.2.01702"
    parseVersion input
    
    let input = "1.1.2.0702.119"
    parseVersion input
    
    let input =  "1.3.5.2150000000"
    parseVersion input
    0
// 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'.

Module Example
   Public Sub Main()
      Dim input As String = "4.0"
      ParseVersion(input)
      
      input = "4.0."
      ParseVersion(input)
      
      input = "1.1.2"
      ParseVersion(input)
      
      input = "1.1.2.01702"
      ParseVersion(input)
      
      input = "1.1.2.0702.119"
      ParseVersion(input)
      
      input =  "1.3.5.2150000000"
      ParseVersion(input)
   End Sub
   
   Private Sub ParseVersion(input As String)
      Try
         Dim ver As Version = Version.Parse(input)
         Console.WriteLine("Converted '{0} to {1}.", input, ver)
      Catch e As ArgumentNullException
         Console.WriteLine("Error: String to be parsed is null.")
      Catch e As ArgumentOutOfRangeException
         Console.WriteLine("Error: Negative value in '{0}'.", input)
      Catch e As ArgumentException
         Console.WriteLine("Error: Bad number of components in '{0}'.", 
                           input)
      Catch e As FormatException
         Console.WriteLine("Error: Non-integer value in '{0}'.", input)
      Catch e As OverflowException   
         Console.WriteLine("Error: Number out of range in '{0}'.", input)                  
      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'.

Opmerkingen

De input parameter moet de volgende indeling hebben:

major.minor[.build[.revision]]

Important

Omdat de tekenreeksweergave van een versienummer moet voldoen aan een herkend patroon, moeten toepassingen altijd uitzonderingsafhandeling gebruiken bij het aanroepen van de Parse methode om gebruikersinvoer te parseren. U kunt de TryParse methode ook aanroepen om de tekenreeksweergave van een versienummer te parseren en een waarde te retourneren die aangeeft of de parseringsbewerking is geslaagd.

De Parse methode is een handige methode; deze is gelijk aan het aanroepen van de Version(String) constructor.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?