Version.Parse Yöntem

Tanım

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
Kaynak:
Version.cs
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

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

Özel durumlar

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

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

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

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.

Şunlara uygulanır

Parse(String)

Kaynak:
Version.cs
Kaynak:
Version.cs
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

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

Özel durumlar

input, null değeridir.

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

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

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

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.

Şunlara uygulanır