Version.Parse Metoda

Reference

Definice

Obor názvů:: System

Sestavení:: System.Runtime.dll

Sestavení:: netstandard.dll

Sestavení:: mscorlib.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přetížení

Parse(ReadOnlySpan<Char>)	Převede zadaný rozsah znaků jen pro čtení, který představuje číslo verze, na ekvivalentní Version objekt.
Parse(String)	Převede řetězcovou reprezentaci čísla verze na ekvivalentní Version objekt.

Parse(ReadOnlySpan<Char>)

Zdroj:: Version.cs

Zdroj:: Version.cs

Zdroj:: Version.cs

Převede zadaný rozsah znaků jen pro čtení, který představuje číslo verze, na ekvivalentní 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

Parametry

input: ReadOnlySpan<Char>

Rozsah znaků jen pro čtení, který obsahuje číslo verze, která se má převést.

Návraty

Version

Objekt, který odpovídá číslu verze zadanému v parametru input .

Výjimky

ArgumentException

input má méně než dvě nebo více než čtyři komponenty verze.

ArgumentOutOfRangeException

Alespoň jedna komponenta v input souboru je menší než nula.

FormatException

Alespoň jedna komponenta v input souboru není celé číslo.

OverflowException

Alespoň jedna komponenta v input představuje číslo, které je větší než Int32.MaxValue.

Poznámky

Parametr input musí mít následující formát:

major.minor[.build[.revision]]

kde major, minor, builda revision jsou řetězcové vyjádření čtyř součástí čísla verze: číslo hlavní verze, číslo podverze, číslo buildu a číslo revize. Volitelné komponenty se zobrazují v hranatých závorkách ([ a ]). Součásti musí být uvedeny v zadaném pořadí a musí být oddělené tečkami.

Platí pro

Parse(String)

Zdroj:: Version.cs

Zdroj:: Version.cs

Zdroj:: Version.cs

Převede řetězcovou reprezentaci čísla verze na ekvivalentní 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

Parametry

input: String

Řetězec, který obsahuje číslo verze k převodu.

Návraty

Version

Objekt, který odpovídá číslu verze zadanému v parametru input .

Výjimky

ArgumentNullException

input je null.

ArgumentException

input má méně než dvě nebo více než čtyři komponenty verze.

ArgumentOutOfRangeException

Alespoň jedna komponenta v input souboru je menší než nula.

FormatException

Alespoň jedna komponenta v input souboru není celé číslo.

OverflowException

Alespoň jedna komponenta v input představuje číslo, které je větší než Int32.MaxValue.

Příklady

Následující příklad používá metodu Parse k analýze počtu řetězců, které obsahují informace o verzi.

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

Poznámky

Parametr input musí mít následující formát:

major.minor[.build[.revision]]

Důležité

Vzhledem k tomu, že řetězcové vyjádření čísla verze musí odpovídat rozpoznaného vzoru, měly by aplikace vždy používat zpracování výjimek při volání Parse metody k parsování vstupu uživatele. Alternativně můžete volat metodu TryParse , která parsuje řetězcovou reprezentaci čísla verze a vrátí hodnotu, která označuje, zda byla operace parsování úspěšná.

Metoda Parse je pohodlná metoda; je ekvivalentní volání konstruktoru Version(String) .

Viz také

Platí pro

Sdílet prostřednictvím

Version.Parse Metoda

Definice

Přetížení

Parse(ReadOnlySpan<Char>)

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Parse(String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály