Version.Parse Metod

Definition

Namnområde:: System

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Runtime.dll

Sammansättning:: netstandard.dll

Sammansättningar:: mscorlib.dll, System.Runtime.dll

Sammansättning:: mscorlib.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Överlagringar

Name	Description
Parse(ReadOnlySpan<Byte>)	Konverterar det angivna skrivskyddade intervallet med UTF-8 tecken som representerar ett versionsnummer till ett motsvarande versionsobjekt.
Parse(ReadOnlySpan<Char>)	Konverterar det angivna skrivskyddade intervallet med tecken som representerar ett versionsnummer till ett motsvarande Version objekt.
Parse(String)	Konverterar strängrepresentationen av ett versionsnummer till ett motsvarande Version objekt.

Parse(ReadOnlySpan<Byte>)

Källa:: Version.cs

Källa:: Version.cs

Konverterar det angivna skrivskyddade intervallet med UTF-8 tecken som representerar ett versionsnummer till ett motsvarande versionsobjekt.

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

Parametrar

utf8Text: ReadOnlySpan<Byte>

Ett skrivskyddat intervall med UTF-8 tecken som innehåller ett versionsnummer som ska konverteras.

Returer

Version

Ett objekt som motsvarar det versionsnummer som anges i parametern utf8Text .

Undantag

ArgumentException

utf8Text har färre än två eller fler än fyra versionskomponenter.

ArgumentOutOfRangeException

Minst en komponent i utf8Text är mindre än noll.

FormatException

Minst en komponent i utf8Text är inte ett heltal.

OverflowException

Minst en komponent i utf8Text representerar ett tal som är större än MaxValue.

Gäller för

Parse(ReadOnlySpan<Char>)

Källa:: Version.cs

Källa:: Version.cs

Källa:: Version.cs

Källa:: Version.cs

Källa:: Version.cs

Konverterar det angivna skrivskyddade intervallet med tecken som representerar ett versionsnummer till ett motsvarande Version objekt.

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

Parametrar

input: ReadOnlySpan<Char>

Ett skrivskyddat intervall med tecken som innehåller ett versionsnummer som ska konverteras.

Returer

Version

Ett objekt som motsvarar det versionsnummer som anges i parametern input .

Undantag

ArgumentException

input har färre än två eller fler än fyra versionskomponenter.

ArgumentOutOfRangeException

Minst en komponent i input är mindre än noll.

FormatException

Minst en komponent i input är inte ett heltal.

OverflowException

Minst en komponent i input representerar ett tal som är större än Int32.MaxValue.

Kommentarer

Parametern input måste ha följande format:

major.minor[.build[.revision]]

där major, minor, buildoch revision är strängrepresentationer av versionsnumrets fyra komponenter: huvudversionsnummer, delversionsnummer, versionsnummer respektive revisionsnummer. Valfria komponenter visas inom hakparenteser ([ och ]). Komponenterna måste visas i den angivna ordningen och måste avgränsas med perioder.

Gäller för

Parse(String)

Källa:: Version.cs

Källa:: Version.cs

Källa:: Version.cs

Källa:: Version.cs

Källa:: Version.cs

Konverterar strängrepresentationen av ett versionsnummer till ett motsvarande Version objekt.

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

Parametrar

input: String

En sträng som innehåller ett versionsnummer som ska konverteras.

Returer

Version

Ett objekt som motsvarar det versionsnummer som anges i parametern input .

Undantag

ArgumentNullException

input är null.

ArgumentException

input har färre än två eller fler än fyra versionskomponenter.

ArgumentOutOfRangeException

Minst en komponent i input är mindre än noll.

FormatException

Minst en komponent i input är inte ett heltal.

OverflowException

Minst en komponent i input representerar ett tal som är större än Int32.MaxValue.

Exempel

I följande exempel används Parse metoden för att parsa ett antal strängar som innehåller versionsinformation.

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'.

Kommentarer

Parametern input måste ha följande format:

major.minor[.build[.revision]]

Important

Eftersom strängrepresentationen av ett versionsnummer måste överensstämma med ett igenkänt mönster bör program alltid använda undantagshantering när de Parse anropar metoden för att parsa användarindata. Du kan också anropa TryParse metoden för att parsa strängrepresentationen av ett versionsnummer och returnera ett värde som anger om parsningsåtgärden lyckades.

Metoden är en bekvämlighetsmetod. Den Parse motsvarar att anropa Version(String) konstruktorn.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?