Version.Parse Metodo

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

Version

Oggetto equivalente al numero di versione specificato nel parametro input.

Eccezioni

ArgumentException

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

ArgumentOutOfRangeException

Almeno un componente di input è minore di zero.

FormatException

Almeno un componente di input non è un Integer.

OverflowException

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

Version

Oggetto equivalente al numero di versione specificato nel parametro input.

Eccezioni

ArgumentNullException

input è null.

ArgumentException

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

ArgumentOutOfRangeException

Almeno un componente di input è minore di zero.

FormatException

Almeno un componente di input non è un Integer.

OverflowException

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]]

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

Version.Parse Metodo

Definizione

Overload

Parse(ReadOnlySpan<Char>)

Parametri

Restituisce

Eccezioni

Commenti

Si applica a

Parse(String)

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti

Risorse aggiuntive