Version.Parse Metodo

Definizione

Overload

Parse(ReadOnlySpan<Char>)

Converte l'intervallo di caratteri di sola lettura specificato che rappresenta un numero di versione in un oggetto Version equivalente.

Parse(String)

Converte la rappresentazione in forma di stringa di un numero di versione nell'oggetto Version equivalente.

Parse(ReadOnlySpan<Char>)

Origine:
Version.cs
Origine:
Version.cs
Origine:
Version.cs

Converte l'intervallo di caratteri di sola lettura specificato che rappresenta un numero di versione in un oggetto Version equivalente.

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

Parametri

input
ReadOnlySpan<Char>

Intervallo di caratteri di sola lettura che contiene un numero di versione da convertire.

Restituisce

Oggetto equivalente al numero di versione specificato nel parametro input.

Eccezioni

input è composto da meno di due componenti o da più di quattro componenti della versione.

Almeno un componente di input è minore di zero.

Almeno un componente di input non è un Integer.

Almeno un componente in input rappresenta un numero maggiore di Int32.MaxValue.

Commenti

Il input parametro deve avere il formato seguente:

major.minor[.build[.revision]]

dove major, minor, builde revision sono le rappresentazioni stringa dei quattro componenti del numero di versione: numero di versione principale, numero di versione secondaria, numero di compilazione e numero di revisione rispettivamente. I componenti facoltativi vengono visualizzati tra parentesi quadre ([ e ]). I componenti devono essere visualizzati nell'ordine specificato e devono essere separati da periodi.

Si applica a

Parse(String)

Origine:
Version.cs
Origine:
Version.cs
Origine:
Version.cs

Converte la rappresentazione in forma di stringa di un numero di versione nell'oggetto Version equivalente.

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

Parametri

input
String

Stringa che contiene un numero di versione da convertire.

Restituisce

Oggetto equivalente al numero di versione specificato nel parametro input.

Eccezioni

input è null.

input è composto da meno di due componenti o da più di quattro componenti della versione.

Almeno un componente di input è minore di zero.

Almeno un componente di input non è un Integer.

Almeno un componente in input rappresenta un numero maggiore di Int32.MaxValue.

Esempio

Nell'esempio seguente viene usato il Parse metodo per analizzare una serie di stringhe che contengono informazioni sulla versione.

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

Commenti

Il input parametro deve avere il formato seguente:

major.minor[.build[.revision]]

dove major, minor, builde revision sono le rappresentazioni stringa dei quattro componenti del numero di versione: numero di versione principale, numero di versione secondaria, numero di compilazione e numero di revisione rispettivamente. I componenti facoltativi vengono visualizzati tra parentesi quadre ([ e ]). I componenti devono essere visualizzati nell'ordine specificato e devono essere separati da periodi.

Importante

Poiché la rappresentazione stringa di un numero di versione deve essere conforme a un modello riconosciuto, le applicazioni devono sempre usare la gestione delle eccezioni quando si chiama il metodo per analizzare l'input Parse utente. In alternativa, è possibile chiamare il TryParse metodo per analizzare la rappresentazione stringa di un numero di versione e restituire un valore che indica se l'operazione di analisi ha avuto esito positivo.

Il Parse metodo è un metodo pratico. Equivale a chiamare il Version(String) costruttore.

Vedi anche

Si applica a