Partager via


Version.Parse Méthode

Définition

Surcharges

Parse(ReadOnlySpan<Char>)

Convertit l’étendue de caractères en lecture seule spécifiée représentant un numéro de version en objet Version équivalent.

Parse(String)

Convertit la représentation sous forme de chaîne d'un numéro de version en un objet Version équivalent.

Parse(ReadOnlySpan<Char>)

Source:
Version.cs
Source:
Version.cs
Source:
Version.cs

Convertit l’étendue de caractères en lecture seule spécifiée représentant un numéro de version en objet Version équivalent.

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

Paramètres

input
ReadOnlySpan<Char>

Étendue de caractères en lecture seule qui contient un numéro de version à convertir.

Retours

Objet équivalent au numéro de version spécifié dans le paramètre input.

Exceptions

input est constitué de moins de deux ou de plus de quatre composants de version.

Au moins un composant dans input est inférieur à zéro.

Au moins un composant dans input n'est pas un entier.

Au moins un composant dans input représente un nombre supérieur à Int32.MaxValue.

Remarques

Le input format du paramètre doit être le suivant :

major.minor[.build[.revision]]

major, minor, buildet revision sont les représentations sous forme de chaîne des quatre composants du numéro de version : numéro de version principale, numéro de version secondaire, numéro de build et numéro de révision, respectivement. Les composants facultatifs sont affichés entre crochets ([ et ]). Les composants doivent apparaître dans l’ordre spécifié et doivent être séparés par des points.

S’applique à

Parse(String)

Source:
Version.cs
Source:
Version.cs
Source:
Version.cs

Convertit la représentation sous forme de chaîne d'un numéro de version en un objet Version équivalent.

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

Paramètres

input
String

Chaîne contenant un numéro de version à convertir.

Retours

Objet équivalent au numéro de version spécifié dans le paramètre input.

Exceptions

input a la valeur null.

input est constitué de moins de deux ou de plus de quatre composants de version.

Au moins un composant dans input est inférieur à zéro.

Au moins un composant dans input n'est pas un entier.

Au moins un composant dans input représente un nombre supérieur à Int32.MaxValue.

Exemples

L’exemple suivant utilise la Parse méthode pour analyser un certain nombre de chaînes qui contiennent des informations de version.

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

Remarques

Le input format du paramètre doit être le suivant :

major.minor[.build[.revision]]

major, minor, buildet revision sont les représentations sous forme de chaîne des quatre composants du numéro de version : numéro de version principale, numéro de version secondaire, numéro de build et numéro de révision, respectivement. Les composants facultatifs sont affichés entre crochets ([ et ]). Les composants doivent apparaître dans l’ordre spécifié et doivent être séparés par des points.

Important

Étant donné que la représentation sous forme de chaîne d’un numéro de version doit être conforme à un modèle reconnu, les applications doivent toujours utiliser la gestion des exceptions lors de l’appel de la Parse méthode pour analyser l’entrée utilisateur. Vous pouvez également appeler la méthode pour analyser la TryParse représentation sous forme de chaîne d’un numéro de version et retourner une valeur qui indique si l’opération d’analyse a réussi.

La Parse méthode est une méthode pratique ; elle équivaut à appeler le Version(String) constructeur.

Voir aussi

S’applique à