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.Converts the specified read-only span of characters that represents a version number to an equivalent Version object.

Parse(String)

Convertit la représentation sous forme de chaîne d'un numéro de version en un objet Version équivalent.Converts the string representation of a version number to an equivalent Version object.

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.Converts the specified read-only span of characters that represents a version number to an equivalent Version object.

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.A read-only span of characters that contains a version number to convert.

Retours

Objet équivalent au numéro de version spécifié dans le paramètre input.An object that is equivalent to the version number specified in the input parameter.

Exceptions

input est constitué de moins de deux ou de plus de quatre composants de version.input has fewer than two or more than four version components.

Au moins un composant dans input est inférieur à zéro.At least one component in input is less than zero.

Au moins un composant dans input n'est pas un entier.At least one component in input is not an integer.

Au moins un composant dans input représente un nombre qui est supérieur à MaxValue.At least one component in input represents a number that is greater than MaxValue.

Remarques

Le paramètre input doit avoir le format suivant :The input parameter must have the following format:

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.where major, minor, build, and revision are the string representations of the version number's four components: major version number, minor version number, build number, and revision number, respectively. Les composants facultatifs sont indiqués entre crochets ([et]).Optional components are shown in square brackets ([ and ]). Les composants doivent apparaître dans l’ordre spécifié et doivent être séparés par des points.The components must appear in the specified order and must be separated by periods.

Parse(String)

Convertit la représentation sous forme de chaîne d'un numéro de version en un objet Version équivalent.Converts the string representation of a version number to an equivalent Version object.

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.A string that contains a version number to convert.

Retours

Objet équivalent au numéro de version spécifié dans le paramètre input.An object that is equivalent to the version number specified in the input parameter.

Exceptions

input a la valeur null.input is null.

input est constitué de moins de deux ou de plus de quatre composants de version.input has fewer than two or more than four version components.

Au moins un composant dans input est inférieur à zéro.At least one component in input is less than zero.

Au moins un composant dans input n'est pas un entier.At least one component in input is not an integer.

Au moins un composant dans input représente un nombre qui est supérieur à MaxValue.At least one component in input represents a number that is greater than MaxValue.

Exemples

L’exemple suivant utilise la méthode Parse pour analyser plusieurs chaînes qui contiennent des informations de version.The following example uses the Parse method to parse a number of strings that contain version information.

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 paramètre input doit avoir le format suivant :The input parameter must have the following format:

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.where major, minor, build, and revision are the string representations of the version number's four components: major version number, minor version number, build number, and revision number, respectively. Les composants facultatifs sont indiqués entre crochets ([et]).Optional components are shown in square brackets ([ and ]). Les composants doivent apparaître dans l’ordre spécifié et doivent être séparés par des points.The components must appear in the specified order and must be separated by periods.

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 Parse pour analyser l’entrée utilisateur.Because the string representation of a version number must conform to a recognized pattern, applications should always use exception handling when calling the Parse method to parse user input. Vous pouvez également appeler la méthode TryParse 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.Alternatively, you can call the TryParse method to parse the string representation of a version number and return a value that indicates whether the parse operation succeeded.

La méthode Parse est une méthode pratique ; Cela équivaut à appeler le constructeur Version(String).The Parse method is a convenience method; it is equivalent to calling the Version(String) constructor.

Voir aussi

S’applique à