Version.Parse Methode

Definition

Namespace:: System

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assemblys:: mscorlib.dll, System.Runtime.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

Name	Beschreibung
Parse(ReadOnlySpan<Byte>)	Konvertiert die angegebene schreibgeschützte Spanne von UTF-8-Zeichen, die eine Versionsnummer in ein entsprechendes Version -Objekt darstellt.
Parse(ReadOnlySpan<Char>)	Konvertiert den angegebenen schreibgeschützten Bereich von Zeichen, die eine Versionsnummer darstellen, in ein entsprechendes Version Objekt.
Parse(String)	Konvertiert die Zeichenfolgendarstellung einer Versionsnummer in ein entsprechendes Version Objekt.

Parse(ReadOnlySpan<Byte>)

Quelle:: Version.cs

Quelle:: Version.cs

Konvertiert die angegebene schreibgeschützte Spanne von UTF-8-Zeichen, die eine Versionsnummer in ein entsprechendes Version -Objekt darstellt.

public:
 static Version ^ Parse(ReadOnlySpan<System::Byte> utf8Text);

public static Version Parse(ReadOnlySpan<byte> utf8Text);

static member Parse : ReadOnlySpan<byte> -> Version

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte)) As Version

Parameter

utf8Text: ReadOnlySpan<Byte>

Eine schreibgeschützte Spanne von UTF-8 Zeichen, die eine Versionsnummer enthalten, die konvertiert werden soll.

Gibt zurück

Version

Ein Objekt, das der im utf8Text Parameter angegebenen Versionsnummer entspricht.

Ausnahmen

ArgumentException

utf8Text verfügt über weniger als zwei oder mehr als vier Versionskomponenten.

ArgumentOutOfRangeException

Mindestens eine Komponente in utf8Text ist kleiner als 0.

FormatException

Mindestens eine Komponente in utf8Text ist keine ganze Zahl.

OverflowException

Mindestens eine Komponente in utf8Text stellt eine Zahl dar, die größer als MaxValueist.

Gilt für:

Parse(ReadOnlySpan<Char>)

Quelle:: Version.cs

Quelle:: Version.cs

Quelle:: Version.cs

Quelle:: Version.cs

Quelle:: Version.cs

Konvertiert den angegebenen schreibgeschützten Bereich von Zeichen, die eine Versionsnummer darstellen, in ein entsprechendes Version Objekt.

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 Versionsnummer enthalten, die konvertiert werden soll.

Gibt zurück

Version

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

Ausnahmen

ArgumentException

input verfügt über weniger als zwei oder mehr als vier Versionskomponenten.

ArgumentOutOfRangeException

Mindestens eine Komponente in input ist kleiner als 0.

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

wobei major, minor, buildund revision sind 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 werden und müssen durch Punkte getrennt werden.

Gilt für:

Parse(String)

Quelle:: Version.cs

Quelle:: Version.cs

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 versionsnummer enthält, die konvertiert werden soll.

Gibt zurück

Version

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

Ausnahmen

ArgumentNullException

input ist null.

ArgumentException

input verfügt über weniger als zwei oder mehr als vier Versionskomponenten.

ArgumentOutOfRangeException

Mindestens eine Komponente in input ist kleiner als 0.

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

Important

Da die Zeichenfolgendarstellung einer Versionsnummer einem erkannten Muster entsprechen muss, sollten Anwendungen beim Aufrufen der Methode immer eine 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 Komfortmethode. Sie entspricht dem Aufrufen des Version(String) Konstruktors.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?