Version.Parse Metoda

Definice

Obor názvů:: System

Sestavení:: netstandard.dll, System.Runtime.dll

Sestavení:: System.Runtime.dll

Sestavení:: netstandard.dll

Sestavení:: mscorlib.dll, System.Runtime.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í

Name	Description
Parse(ReadOnlySpan<Byte>)	Převede zadaný rozsah jen pro čtení znaků UTF-8, který představuje číslo verze na ekvivalentní objekt Verze.
Parse(ReadOnlySpan<Char>)	Převede zadané rozsahy znaků jen pro čtení, které představují číslo verze na ekvivalentní Version objekt.
Parse(String)	Převede řetězcovou reprezentaci čísla verze na ekvivalentní Version objekt.

Parse(ReadOnlySpan<Byte>)

Zdroj:: Version.cs

Zdroj:: Version.cs

Převede zadaný rozsah jen pro čtení znaků UTF-8, který představuje číslo verze na ekvivalentní objekt Verze.

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>

Rozsah jen pro čtení znaků UTF-8 obsahující číslo verze, které se má převést.

Návraty

Version

Objekt, který je ekvivalentní číslu verze zadané v parametru utf8Text .

Výjimky

ArgumentException

utf8Text má méně než dvě nebo více než čtyři součásti verze.

ArgumentOutOfRangeException

Nejméně jedna komponenta utf8Text je menší než nula.

FormatException

Nejméně jedna komponenta utf8Text není celé číslo.

OverflowException

Nejméně jedna součást utf8Text představuje číslo, které je větší než MaxValue.

Platí pro

Parse(ReadOnlySpan<Char>)

Zdroj:: Version.cs

Zdroj:: Version.cs

Zdroj:: Version.cs

Zdroj:: Version.cs

Zdroj:: Version.cs

Převede zadané rozsahy znaků jen pro čtení, které představují čí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 jen pro čtení znaků, který obsahuje číslo verze, které se má převést.

Návraty

Version

Objekt, který je ekvivalentní číslu verze zadané v parametru input .

Výjimky

ArgumentException

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

ArgumentOutOfRangeException

Nejméně jedna komponenta input je menší než nula.

FormatException

Nejméně jedna komponenta input není celé číslo.

OverflowException

Nejméně jedna součást 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, , minorbuilda jsou revision řetězcové reprezentace čtyř součástí číslo verze: číslo hlavní verze, číslo podverze, číslo buildu a číslo revize, v uvedeném pořadí. Volitelné součásti jsou uvedeny v hranatých závorkách ([ a ]). Součásti musí být uvedeny v zadaném pořadí a musí být odděleny tečkami.

Platí pro

Parse(String)

Zdroj:: Version.cs

Zdroj:: Version.cs

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 pro převod.

Návraty

Version

Objekt, který je ekvivalentní číslu verze zadané v parametru input .

Výjimky

ArgumentNullException

input je null.

ArgumentException

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

ArgumentOutOfRangeException

Nejméně jedna komponenta input je menší než nula.

FormatException

Nejméně jedna komponenta input není celé číslo.

OverflowException

Nejméně jedna součást 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 řady ř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]]

Important

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

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

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?