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

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

Version

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 qui est supérieur à MaxValue.

Remarques

Le input paramètre doit avoir le format suivant :

major.minor[.build[.revision]]

major , minor , build et revision sont les représentations sous forme de chaîne des quatre composants du numéro de version : le numéro de version principale, le numéro de version mineure, le numéro de build et le numéro de révision, respectivement. Les composants facultatifs sont indiqué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)

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

Version

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 qui est supérieur à MaxValue.

Exemples

L’exemple suivant utilise la Parse méthode pour analyser plusieurs 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'.
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]]

major , minor , build et revision sont les représentations sous forme de chaîne des quatre composants du numéro de version : le numéro de version principale, le numéro de version mineure, le numéro de build et le numéro de révision, respectivement. Les composants facultatifs sont indiqué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 d’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 à