Version.Parse Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestawy:: netstandard.dll, System.Runtime.dll

Zestaw:: System.Runtime.dll

Zestaw:: netstandard.dll

Zestawy:: mscorlib.dll, System.Runtime.dll

Zestaw:: mscorlib.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

Parse(ReadOnlySpan<Byte>)
Parse(ReadOnlySpan<Char>)	Konwertuje określony zakres znaków tylko do odczytu, który reprezentuje numer wersji do równoważnego Version obiektu.
Parse(String)	Konwertuje reprezentację ciągu numeru wersji na równoważny Version obiekt.

Parse(ReadOnlySpan<Byte>)

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

Parametry

utf8Text: ReadOnlySpan<Byte>

Zwraca

Version

Dotyczy

.NET 10

Produkt	Wersje
.NET	10

Parse(ReadOnlySpan<Char>)

Źródło:: Version.cs

Źródło:: Version.cs

Źródło:: Version.cs

Konwertuje określony zakres znaków tylko do odczytu, który reprezentuje numer wersji do równoważnego Version obiektu.

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

Parametry

input: ReadOnlySpan<Char>

Zakres znaków tylko do odczytu zawierający numer wersji do konwersji.

Zwraca

Version

Obiekt, który jest odpowiednikiem numeru wersji określonego w parametrze input .

Wyjątki

ArgumentException

input ma mniej niż dwa lub więcej niż cztery składniki wersji.

ArgumentOutOfRangeException

Co najmniej jeden składnik w input elemencie jest mniejszy niż zero.

FormatException

Co najmniej jeden składnik w input elemencie nie jest liczbą całkowitą.

OverflowException

Co najmniej jeden składnik w input elemencie reprezentuje liczbę większą niż Int32.MaxValue.

Uwagi

Parametr input musi mieć następujący format:

major.minor[.build[.revision]]

gdzie major, , buildminori revision są reprezentacją ciągów czterech składników numeru wersji: numer wersji głównej, numer wersji pomocniczej, numer kompilacji i numer poprawki, odpowiednio. Opcjonalne składniki są wyświetlane w nawiasach kwadratowych ([ i ]). Składniki muszą być wyświetlane w określonej kolejności i muszą być oddzielone kropkami.

Dotyczy

.NET 10 i inne wersje

Produkt	Wersje
.NET	Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard	2.1

Parse(String)

Źródło:: Version.cs

Źródło:: Version.cs

Źródło:: Version.cs

Konwertuje reprezentację ciągu numeru wersji na równoważny Version obiekt.

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

Parametry

input: String

Ciąg zawierający numer wersji do przekonwertowania.

Zwraca

Version

Obiekt, który jest odpowiednikiem numeru wersji określonego w parametrze input .

Wyjątki

ArgumentNullException

input to null.

ArgumentException

input ma mniej niż dwa lub więcej niż cztery składniki wersji.

ArgumentOutOfRangeException

Co najmniej jeden składnik w input elemencie jest mniejszy niż zero.

FormatException

Co najmniej jeden składnik w input elemencie nie jest liczbą całkowitą.

OverflowException

Co najmniej jeden składnik w input elemencie reprezentuje liczbę większą niż Int32.MaxValue.

Przykłady

W poniższym przykładzie Parse użyto metody , aby przeanalizować liczbę ciągów zawierających informacje o wersji.

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

Uwagi

Parametr input musi mieć następujący format:

major.minor[.build[.revision]]

Ważne

Ponieważ reprezentacja ciągu numeru wersji musi być zgodna z rozpoznanym wzorcem, aplikacje powinny zawsze używać obsługi wyjątków podczas wywoływania Parse metody do analizowania danych wejściowych użytkownika. Alternatywnie można wywołać TryParse metodę, aby przeanalizować reprezentację ciągu numeru wersji i zwrócić wartość wskazującą, czy operacja analizy zakończyła się pomyślnie.

Metoda Parse jest metodą wygodną. Jest to odpowiednik wywoływania konstruktora Version(String) .

Zobacz też

Dotyczy

.NET 10 i inne wersje

Produkt	Wersje
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

AI Skills Fest

Udostępnij za pośrednictwem

Version.Parse Metoda

Definicja

Przeciążenia

Parse(ReadOnlySpan<Byte>)

Parametry

Zwraca

Dotyczy

Parse(ReadOnlySpan<Char>)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Parse(String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby