Freigeben über


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.

Parse(String)

Konvertiert die Zeichenfolgendarstellung einer Versionsnummer in ein entsprechendes Version-Objekt.

Parse(ReadOnlySpan<Char>)

Quelle:
Version.cs
Quelle:
Version.cs
Quelle:
Version.cs

Konvertiert die angegebene schreibgeschützte Zeichenspanne, die eine Versionsnummer für ein entsprechendes Version-Objekt darstellt.

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

Gibt zurück

Ein Objekt, das der im input-Parameter angegebenen Versionsnummer entspricht.

Ausnahmen

input enthält weniger als zwei oder mehr als vier Versionskomponenten.

Mindestens eine Komponente in input ist kleiner als 0 (null).

Mindestens eine Komponente in input ist keine ganze Zahl.

Mindestens eine Komponente in input stellt eine Zahl dar, die größer als Int32.MaxValue ist.

Hinweise

Der input Parameter muss das folgende Format aufweisen:

major.minor[.build[.revision]]

dabei majorsind , minor, buildund revision die Zeichenfolgendarstellungen der vier Komponenten der Versionsnummer: Hauptversionsnummer, Nebenversionsnummer, Buildnummer und Revisionsnummer. Optionale Komponenten werden in eckigen Klammern ([ und ]) angezeigt. Die Komponenten müssen in der angegebenen Reihenfolge angezeigt und durch Punkte getrennt sein.

Gilt für:

Parse(String)

Quelle:
Version.cs
Quelle:
Version.cs
Quelle:
Version.cs

Konvertiert die Zeichenfolgendarstellung einer Versionsnummer in ein entsprechendes Version-Objekt.

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.

Gibt zurück

Ein Objekt, das der im input-Parameter angegebenen Versionsnummer entspricht.

Ausnahmen

input ist null.

input enthält weniger als zwei oder mehr als vier Versionskomponenten.

Mindestens eine Komponente in input ist kleiner als 0 (null).

Mindestens eine Komponente in input ist keine ganze Zahl.

Mindestens eine Komponente in input stellt eine Zahl dar, die größer als Int32.MaxValue ist.

Beispiele

Im folgenden Beispiel wird die Parse -Methode verwendet, um eine Reihe von Zeichenfolgen zu analysieren, die Versionsinformationen enthalten.

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

Hinweise

Der input Parameter muss das folgende Format aufweisen:

major.minor[.build[.revision]]

dabei majorsind , minor, buildund revision die Zeichenfolgendarstellungen der vier Komponenten der Versionsnummer: Hauptversionsnummer, Nebenversionsnummer, Buildnummer und Revisionsnummer. Optionale Komponenten werden in eckigen Klammern ([ und ]) angezeigt. Die Komponenten müssen in der angegebenen Reihenfolge angezeigt und durch Punkte getrennt sein.

Wichtig

Da die Zeichenfolgendarstellung einer Versionsnummer einem erkannten Muster entsprechen muss, sollten Anwendungen beim Aufrufen der Methode immer Ausnahmebehandlung verwenden, um Benutzereingaben Parse zu analysieren. Alternativ können Sie die TryParse -Methode aufrufen, um die Zeichenfolgendarstellung einer Versionsnummer zu analysieren und einen Wert zurückzugeben, der angibt, ob der Analysevorgang erfolgreich war.

Die Parse -Methode ist eine Convenience-Methode. Sie entspricht dem Aufrufen des Version(String) Konstruktors.

Weitere Informationen

Gilt für: