Version.Parse Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Aşırı Yüklemeler

Parse(ReadOnlySpan<Char>)	Sürüm numarasını temsil eden karakterlerin belirtilen salt okunur aralığını eşdeğer Version bir nesneye dönüştürür.
Parse(String)	Sürüm numarasının dize gösterimini eşdeğer Version bir nesneye dönüştürür.

Parse(ReadOnlySpan<Char>)

Kaynak:

Version.cs

Sürüm numarasını temsil eden karakterlerin belirtilen salt okunur aralığını eşdeğer Version bir nesneye dönüştürür.

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

Parametreler

input

ReadOnlySpan<Char>

Dönüştürülecek sürüm numarasını içeren karakterlerin salt okunur yayılması.

Döndürülenler

Version

parametresinde input belirtilen sürüm numarasına eşdeğer bir nesne.

Özel durumlar

ArgumentException

input ikiden az veya dörtten fazla sürüm bileşenine sahiptir.

ArgumentOutOfRangeException

içindeki input en az bir bileşen sıfırdan küçüktür.

FormatException

içindeki input en az bir bileşen tamsayı değildir.

OverflowException

içindeki input en az bir bileşen , Int32.MaxValue değerinden büyük bir sayıyı temsil eder.

Açıklamalar

input parametresi aşağıdaki biçime sahip olmalıdır:

major.minor[.build[.revision]]

burada major, minor, buildve revision , sürüm numarasının dört bileşeninin dize temsilleridir: sırasıyla ana sürüm numarası, ikincil sürüm numarası, derleme numarası ve düzeltme numarası. İsteğe bağlı bileşenler köşeli ayraç ([ ve ]) içinde gösterilir. Bileşenler belirtilen sırada görünmelidir ve noktalarla ayrılmalıdır.

Parse(String)

Kaynak:

Version.cs

Sürüm numarasının dize gösterimini eşdeğer Version bir nesneye dönüştürür.

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

Parametreler

input

String

Dönüştürülecek sürüm numarasını içeren dize.

Döndürülenler

Version

parametresinde input belirtilen sürüm numarasına eşdeğer bir nesne.

Özel durumlar

ArgumentNullException

input, null değeridir.

ArgumentException

input ikiden az veya dörtten fazla sürüm bileşenine sahiptir.

ArgumentOutOfRangeException

içindeki input en az bir bileşen sıfırdan küçüktür.

FormatException

içindeki input en az bir bileşen tamsayı değildir.

OverflowException

içindeki input en az bir bileşen , Int32.MaxValue değerinden büyük bir sayıyı temsil eder.

Örnekler

Aşağıdaki örnek, sürüm bilgilerini içeren bir dizi dizeyi ayrıştırmak için yöntemini kullanır Parse .

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

Açıklamalar

input parametresi aşağıdaki biçime sahip olmalıdır:

major.minor[.build[.revision]]

burada major, minor, buildve revision , sürüm numarasının dört bileşeninin dize temsilleridir: sırasıyla ana sürüm numarası, ikincil sürüm numarası, derleme numarası ve düzeltme numarası. İsteğe bağlı bileşenler köşeli ayraç ([ ve ]) içinde gösterilir. Bileşenler belirtilen sırada görünmelidir ve noktalarla ayrılmalıdır.

Önemli

Sürüm numarasının dize gösterimi tanınan bir desene uyması gerektiğinden, uygulamalar kullanıcı girişini ayrıştırmak için yöntemini çağırırken Parse her zaman özel durum işlemeyi kullanmalıdır. Alternatif olarak, bir sürüm numarasının TryParse dize gösterimini ayrıştırmak ve ayrıştırma işleminin başarılı olup olmadığını gösteren bir değer döndürmek için yöntemini çağırabilirsiniz.

Parse yöntemi kullanışlı bir yöntemdir; oluşturucuyu çağırmaya Version(String) eşdeğerdir.

Ayrıca bkz.

• ToString
• TryParse(String, Version)