Version.TryParse 方法

參考

定義

命名空間:: System

組件:: System.Runtime.dll

組件:: mscorlib.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

TryParse(String, Version)	嘗試將版本號碼的字串表示轉換為對等的 Version 物件，並傳回表示轉換是否成功的值。
TryParse(ReadOnlySpan<Char>, Version)	嘗試轉換代表相當於 Version 物件版本號碼的指定唯讀字元延伸，且傳回指出轉換是否成功的值。

TryParse(String, Version)

來源:: Version.cs

來源:: Version.cs

來源:: Version.cs

嘗試將版本號碼的字串表示轉換為對等的 Version 物件，並傳回表示轉換是否成功的值。

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

參數

input: String

字串，包含要轉換的版本號碼。

result: Version

當這個方法傳回時，如果轉換成功，則會包含 Version，相當於 input 所包含的數字。如果 input 是 null，則為 Empty；如果轉換失敗，當方法傳回時，result 則為 null。

傳回

Boolean

如果 true 參數轉換成功，則為 input，否則為 false。

範例

下列範例會 TryParse 使用方法來剖析包含版本資訊的數個字串。

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

備註

方法 TryParse 類似于 Parse 方法，但轉換失敗時不會擲回例外狀況。相反地，它會傳回如果 input 是 null ，則傳回 false 的元件少於兩個或四個以上的元件、至少有一個元件不是整數、至少有一個小於零的元件，或至少有一個大於 Int32.MaxValue 的元件。

若要讓剖析作業成功， input 參數的格式必須如下：

major.minor[.build[.revision]]

其中 major 、 minorbuild 和 revision 是版本號碼四個元件的字串標記法：主要版本號碼、次要版本號碼、組建編號和修訂編號。選擇性元件會顯示在方括弧中， ([ 和 ]) 。元件必須依序顯示，而且必須以句號分隔。

另請參閱

適用於

TryParse(ReadOnlySpan<Char>, Version)

來源:: Version.cs

來源:: Version.cs

來源:: Version.cs

嘗試轉換代表相當於 Version 物件版本號碼的指定唯讀字元延伸，且傳回指出轉換是否成功的值。

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

參數

input: ReadOnlySpan<Char>

包含欲轉換版本號碼的字元唯讀延伸。

result: Version

傳回