Version.Parse Méthode

Définition

Espace de noms:: System

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assemblys:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
Parse(ReadOnlySpan<Byte>)	Convertit l’étendue en lecture seule spécifiée de caractères UTF-8 qui représente un numéro de version en objet Version équivalent.
Parse(ReadOnlySpan<Char>)	Convertit l’étendue de caractères en lecture seule spécifiée qui représente un numéro de version en objet équivalent Version .
Parse(String)	Convertit la représentation sous forme de chaîne d’un numéro de version en objet équivalent Version .

Parse(ReadOnlySpan<Byte>)

Source:: Version.cs

Source:: Version.cs

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

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

Paramètres

utf8Text: ReadOnlySpan<Byte>

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

Retours

Version

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

Exceptions

ArgumentException

utf8Text comporte moins de deux ou plus de quatre composants de version.

ArgumentOutOfRangeException

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

FormatException

Au moins un composant n’est utf8Text pas un entier.

OverflowException

Au moins un composant utf8Text représente un nombre supérieur à MaxValue.

S’applique à

Parse(ReadOnlySpan<Char>)

Source:: Version.cs

Source:: Version.cs

Source:: Version.cs

Source:: Version.cs

Source:: Version.cs

Convertit l’étendue de caractères en lecture seule spécifiée qui représente un numéro de version en objet équivalent 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

Paramètres

input: ReadOnlySpan<Char>

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

Retours

Version

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

Exceptions

ArgumentException

input comporte moins de deux ou plus de quatre composants de version.

ArgumentOutOfRangeException

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

FormatException

Au moins un composant n’est input pas un entier.

OverflowException

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

Remarques

Le input paramètre doit avoir le format suivant :

major.minor[.build[.revision]]

où major, , minorbuildrevision et sont les représentations sous forme de chaîne des quatre composants du numéro de version : numéro de version principal, 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

Source:: Version.cs

Source:: Version.cs

Convertit la représentation sous forme de chaîne d’un numéro de version en objet équivalent 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

Paramètres

input: String

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

Retours

Version

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

Exceptions

ArgumentNullException

input a la valeur null.

ArgumentException

input comporte moins de deux ou plus de quatre composants de version.

ArgumentOutOfRangeException

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

FormatException

Au moins un composant n’est input pas un entier.

OverflowException

Au moins un composant 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 paramètre doit avoir le format suivant :

major.minor[.build[.revision]]

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 méthode pour analyser l’entrée Parse utilisateur. Vous pouvez également appeler la TryParse méthode pour analyser la 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 à

Commentaires

Cette page a-t-elle été utile ?