Freigeben über


Version.TryParse Methode

Definition

Überlädt

TryParse(String, Version)

Versucht, die Zeichenfolgendarstellung einer Versionsnummer in ein entsprechendes Version-Objekt zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich durchgeführt wurde.

TryParse(ReadOnlySpan<Char>, Version)

Versucht, die angegebene schreibgeschützte Zeichenspanne einer Versionsnummer in ein entsprechendes Version-Objekt zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich durchgeführt wurde

TryParse(String, Version)

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

Versucht, die Zeichenfolgendarstellung einer Versionsnummer in ein entsprechendes Version-Objekt zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich durchgeführt wurde.

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] Version ^ % result);
public static bool TryParse (string input, out Version result);
public static bool TryParse (string? input, out Version? result);
static member TryParse : string * Version -> bool
Public Shared Function TryParse (input As String, ByRef result As Version) As Boolean

Parameter

input
String

Eine Zeichenfolge, die eine zu konvertierende Versionsnummer enthält.

result
Version

Enthält nach dem Beenden dieser Methode die Version-Entsprechung der Zahl in input, wenn die Konvertierung erfolgreich war. Wenn inputnull oder Empty ist oder, wenn bei der Konvertierung ein Fehler auftritt, dann ist resultnull, wenn die Methode zurückgegeben wird.

Gibt zurück

true, wenn der input-Parameter erfolgreich konvertiert wurde, andernfalls false.

Beispiele

Im folgenden Beispiel wird die TryParse -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)
   {
      Version ver = null;
      if (Version.TryParse(input, out ver))
         Console.WriteLine("Converted '{0} to {1}.", input, ver);
      else
         Console.WriteLine("Unable to determine the version from '{0}'.",
                           input);
   }
}
// The example displays the following output:
//       Converted '4.0 to 4.0.
//       Unable to determine the version from '4.0.'.
//       Converted '1.1.2 to 1.1.2.
//       Converted '1.1.2.01702 to 1.1.2.1702.
//       Unable to determine the version from '1.1.2.0702.119'.
//       Unable to determine the version from '1.3.5.2150000000'.
open System

let parseVersion (input: string) =
    match Version.TryParse input with
    | true, ver ->
        printfn $"Converted '{input} to {ver}."
    | _ ->
        printfn $"Unable to determine the version from '{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.
//       Unable to determine the version from '4.0.'.
//       Converted '1.1.2 to 1.1.2.
//       Converted '1.1.2.01702 to 1.1.2.1702.
//       Unable to determine the version from '1.1.2.0702.119'.
//       Unable to determine the version from '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)
      Dim ver As Version = Nothing
      If Version.TryParse(input, ver) Then
         Console.WriteLine("Converted '{0} to {1}.", input, ver)
      Else
         Console.WriteLine("Unable to determine the version from '{0}'.",
                           input)
      End If
   End Sub
End Module
' The example displays the following output:
'       Converted '4.0 to 4.0.
'       Unable to determine the version from '4.0.'.
'       Converted '1.1.2 to 1.1.2.
'       Converted '1.1.2.01702 to 1.1.2.1702.
'       Unable to determine the version from '1.1.2.0702.119'.
'       Unable to determine the version from '1.3.5.2150000000'.

Hinweise

Die TryParse Methode ähnelt der -Methode, mit dem Parse Unterschied, dass sie keine Ausnahme auslöst, wenn die Konvertierung fehlschlägt. Stattdessen wird zurückgegebenfalse, wenn nullinput ist , hat weniger als zwei oder mehr als vier Komponenten, hat mindestens eine Komponente, die keine ganze Zahl ist, mindestens eine Komponente hat, die kleiner als 0 ist, oder mindestens eine Komponente, die größer als Int32.MaxValueist.

Damit der Analysevorgang erfolgreich ist, muss der input Parameter 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 richtigen Reihenfolge angezeigt werden und durch Punkte getrennt sein.

Weitere Informationen

Gilt für:

TryParse(ReadOnlySpan<Char>, Version)

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

Versucht, die angegebene schreibgeschützte Zeichenspanne einer Versionsnummer in ein entsprechendes Version-Objekt zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich durchgeführt wurde

public:
 static bool TryParse(ReadOnlySpan<char> input, [Runtime::InteropServices::Out] Version ^ % result);
public static bool TryParse (ReadOnlySpan<char> input, out Version? result);
public static bool TryParse (ReadOnlySpan<char> input, out Version result);
static member TryParse : ReadOnlySpan<char> * Version -> bool
Public Shared Function TryParse (input As ReadOnlySpan(Of Char), ByRef result As Version) As Boolean

Parameter

input
ReadOnlySpan<Char>

Eine schreibgeschützte Spanne von Zeichen, die eine zu konvertierende Versionsnummer enthält

result
Version

Enthält nach dem Beenden dieser Methode die Version-Entsprechung der Zahl in input, wenn die Konvertierung erfolgreich war. Wenn inputnull oder Empty ist oder, wenn bei der Konvertierung ein Fehler auftritt, dann ist resultnull, wenn die Methode zurückgegeben wird.

Gibt zurück

true, wenn der input-Parameter erfolgreich konvertiert wurde, andernfalls false.

Hinweise

Die TryParse Methode ähnelt der -Methode, mit dem Parse Unterschied, dass sie keine Ausnahme auslöst, wenn die Konvertierung fehlschlägt. Stattdessen wird zurückgegebenfalse, wenn nullinput ist , hat weniger als zwei oder mehr als vier Komponenten, hat mindestens eine Komponente, die keine ganze Zahl ist, mindestens eine Komponente hat, die kleiner als 0 ist, oder mindestens eine Komponente, die größer als Int32.MaxValueist.

Damit der Analysevorgang erfolgreich ist, muss der input Parameter 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 richtigen Reihenfolge angezeigt werden und durch Punkte getrennt sein.

Gilt für: