Version.Parse Metodo

Definizione

Spazio dei nomi:: System

Assembly:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

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

Nome	Descrizione
Parse(ReadOnlySpan<Byte>)	Converte l'intervallo di sola lettura specificato di caratteri UTF-8 che rappresenta un numero di versione in un oggetto Version equivalente.
Parse(ReadOnlySpan<Char>)	Converte l'intervallo di caratteri di sola lettura specificato che rappresenta un numero di versione in un oggetto equivalente Version .
Parse(String)	Converte la rappresentazione di stringa di un numero di versione in un oggetto equivalente Version .

Parse(ReadOnlySpan<Byte>)

Origine:: Version.cs

Origine:: Version.cs

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

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

Parametri

utf8Text: ReadOnlySpan<Byte>

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

Valori restituiti

Version

Oggetto equivalente al numero di versione specificato nel utf8Text parametro .

Eccezioni

ArgumentException

utf8Text ha meno di due o più di quattro componenti della versione.

ArgumentOutOfRangeException

Almeno un componente in utf8Text è minore di zero.

FormatException

Almeno un componente in utf8Text non è un numero intero.

OverflowException

Almeno un componente in utf8Text rappresenta un numero maggiore di MaxValue.

Si applica a

Parse(ReadOnlySpan<Char>)

Origine:: Version.cs

Origine:: Version.cs

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 equivalente Version .

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.

Valori restituiti

Version

Oggetto equivalente al numero di versione specificato nel input parametro .

Eccezioni

ArgumentException

input ha meno di due o più di quattro componenti della versione.

ArgumentOutOfRangeException

Almeno un componente in input è minore di zero.

FormatException

Almeno un componente in input non è un numero intero.

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, minorbuild, e revision sono le rappresentazioni di stringa dei quattro componenti del numero di versione: numero di versione principale, numero di versione secondaria, numero di build e numero di revisione, rispettivamente. I componenti facoltativi sono visualizzati tra parentesi quadre ([ e ]). I componenti devono essere visualizzati nell'ordine specificato e devono essere separati da punti.

Si applica a

Parse(String)

Origine:: Version.cs

Origine:: Version.cs

Origine:: Version.cs

Origine:: Version.cs

Origine:: Version.cs

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

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 contenente un numero di versione da convertire.

Valori restituiti

Version

Oggetto equivalente al numero di versione specificato nel input parametro .

Eccezioni

ArgumentNullException

input è null.

ArgumentException

input ha meno di due o più di quattro componenti della versione.

ArgumentOutOfRangeException

Almeno un componente in input è minore di zero.

FormatException

Almeno un componente in input non è un numero intero.

OverflowException

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

Esempio

Nell'esempio seguente viene utilizzato 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 di stringa di un numero di versione deve essere conforme a un modello riconosciuto, le applicazioni devono usare sempre la gestione delle eccezioni quando si chiama il metodo per analizzare l'input Parse dell'utente. In alternativa, è possibile chiamare il TryParse metodo per analizzare la rappresentazione di stringa di un numero di versione e restituire un valore che indica se l'operazione di analisi è riuscita.

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

Vedi anche

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?