Version.Parse Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ü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

Version

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

Ausnahmen

ArgumentException

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

ArgumentOutOfRangeException

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

FormatException

Mindestens eine Komponente in input ist keine ganze Zahl.

OverflowException

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

Version

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

Ausnahmen

ArgumentNullException

input ist null.

ArgumentException

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

ArgumentOutOfRangeException

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

FormatException

Mindestens eine Komponente in input ist keine ganze Zahl.

OverflowException

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

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:

Freigeben über

Version.Parse Methode

Definition

Überlädt

Parse(ReadOnlySpan<Char>)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Parse(String)

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen