Version.Parse Methode

Definition

Überlädt

Parse(ReadOnlySpan<Char>)

Konvertiert die angegebene schreibgeschützte Zeichenspanne, die eine Versionsnummer für ein entsprechendes Version-Objekt darstellt.Converts the specified read-only span of characters that represents a version number to an equivalent Version object.

Parse(String)

Konvertiert die Zeichenfolgendarstellung einer Versionsnummer in ein entsprechendes Version-Objekt.Converts the string representation of a version number to an equivalent Version object.

Parse(ReadOnlySpan<Char>)

Konvertiert die angegebene schreibgeschützte Zeichenspanne, die eine Versionsnummer für ein entsprechendes Version-Objekt darstellt.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

Parameter

input
ReadOnlySpan<Char>

Eine schreibgeschützte Spanne von Zeichen, die eine zu konvertierende Versionsnummer enthält.A read-only span of characters that contains a version number to convert.

Gibt zurück

Ein Objekt, das der im input-Parameter angegebenen Versionsnummer entspricht.An object that is equivalent to the version number specified in the input parameter.

Ausnahmen

input enthält weniger als zwei oder mehr als vier Versionskomponenten.input has fewer than two or more than four version components.

Mindestens eine Komponente in input ist kleiner als 0 (null).At least one component in input is less than zero.

Mindestens eine Komponente in input ist keine ganze Zahl.At least one component in input is not an integer.

Mindestens eine Komponente in input stellt eine Zahl größer als MaxValue dar.At least one component in input represents a number that is greater than MaxValue.

Hinweise

Der Parameter "input" muss folgendes Format aufweisen:The input parameter must have the following format:

major.minor[.build[.revision]]

Dabei sind major, minor, build und revision die Zeichen folgen Darstellungen der vier Komponenten der Versionsnummer: Hauptversionsnummer, neben Versionsnummer, Buildnummer und Revisionsnummer.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. Optionale Komponenten werden in eckigen Klammern ([und]) angezeigt.Optional components are shown in square brackets ([ and ]). Die Komponenten müssen in der angegebenen Reihenfolge angezeigt werden und müssen durch Zeiträume getrennt werden.The components must appear in the specified order and must be separated by periods.

Parse(String)

Konvertiert die Zeichenfolgendarstellung einer Versionsnummer in ein entsprechendes Version-Objekt.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

Parameter

input
String

Eine Zeichenfolge, die eine zu konvertierende Versionsnummer enthält.A string that contains a version number to convert.

Gibt zurück

Ein Objekt, das der im input-Parameter angegebenen Versionsnummer entspricht.An object that is equivalent to the version number specified in the input parameter.

Ausnahmen

input ist null.input is null.

input enthält weniger als zwei oder mehr als vier Versionskomponenten.input has fewer than two or more than four version components.

Mindestens eine Komponente in input ist kleiner als 0 (null).At least one component in input is less than zero.

Mindestens eine Komponente in input ist keine ganze Zahl.At least one component in input is not an integer.

Mindestens eine Komponente in input stellt eine Zahl größer als MaxValue dar.At least one component in input represents a number that is greater than MaxValue.

Beispiele

Im folgenden Beispiel wird die Parse-Methode verwendet, um eine Reihe von Zeichen folgen zu analysieren, die Versionsinformationen enthalten.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'.

Hinweise

Der Parameter "input" muss folgendes Format aufweisen:The input parameter must have the following format:

major.minor[.build[.revision]]

Dabei sind major, minor, build und revision die Zeichen folgen Darstellungen der vier Komponenten der Versionsnummer: Hauptversionsnummer, neben Versionsnummer, Buildnummer und Revisionsnummer.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. Optionale Komponenten werden in eckigen Klammern ([und]) angezeigt.Optional components are shown in square brackets ([ and ]). Die Komponenten müssen in der angegebenen Reihenfolge angezeigt werden und müssen durch Zeiträume getrennt werden.The components must appear in the specified order and must be separated by periods.

Wichtig

Da die Zeichen folgen Darstellung einer Versionsnummer einem erkannten Muster entsprechen muss, sollten Anwendungen immer die Ausnahmebehandlung verwenden, wenn Sie die Parse-Methode aufrufen, um Benutzereingaben zu analysieren.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. Alternativ können Sie die TryParse-Methode zum Analysieren der Zeichen folgen Darstellung einer Versionsnummer und zum Zurückgeben eines Werts, der angibt, ob der Analyse Vorgang erfolgreich war, abrufen.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.

Die Parse-Methode ist eine bequeme Methode. Dies entspricht dem Aufrufen des Version(String)-Konstruktors.The Parse method is a convenience method; it is equivalent to calling the Version(String) constructor.

Siehe auch

Gilt für: