Version.Parse Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Overload

Parse(ReadOnlySpan<Char>)	Mengonversi rentang karakter baca-saja yang ditentukan yang mewakili nomor versi menjadi objek yang setara Version .
Parse(String)	Mengonversi representasi string dari nomor versi menjadi objek yang setara Version .

Parse(ReadOnlySpan<Char>)

Sumber:

Version.cs

Mengonversi rentang karakter baca-saja yang ditentukan yang mewakili nomor versi menjadi objek yang setara Version .

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>

Rentang karakter baca-saja yang berisi nomor versi untuk dikonversi.

Mengembalikan

Version

Objek yang setara dengan nomor versi yang ditentukan dalam input parameter .

Pengecualian

ArgumentException

input memiliki kurang dari dua atau lebih dari empat komponen versi.

ArgumentOutOfRangeException

Setidaknya satu komponen di input kurang dari nol.

FormatException

Setidaknya satu komponen di input bukan bilangan bulat.

OverflowException

Setidaknya satu komponen dalam input mewakili angka yang lebih besar dari Int32.MaxValue.

Keterangan

Parameter input harus memiliki format berikut:

major.minor[.build[.revision]]

di mana major, minor, build, dan revision adalah representasi string dari empat komponen nomor versi: nomor versi utama, nomor versi minor, nomor build, dan nomor revisi, masing-masing. Komponen opsional ditampilkan dalam tanda kurung siku ([ dan ]). Komponen harus muncul dalam urutan yang ditentukan dan harus dipisahkan oleh titik.

Parse(String)

Sumber:

Version.cs

Mengonversi representasi string dari nomor versi menjadi objek yang setara Version .

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

String yang berisi nomor versi untuk dikonversi.

Mengembalikan

Version

Objek yang setara dengan nomor versi yang ditentukan dalam input parameter .

Pengecualian

ArgumentNullException

inputadalah null.

ArgumentException

input memiliki kurang dari dua atau lebih dari empat komponen versi.

ArgumentOutOfRangeException

Setidaknya satu komponen di input kurang dari nol.

FormatException

Setidaknya satu komponen di input bukan bilangan bulat.

OverflowException

Setidaknya satu komponen dalam input mewakili angka yang lebih besar dari Int32.MaxValue.

Contoh

Contoh berikut menggunakan Parse metode untuk mengurai sejumlah string yang berisi informasi versi.

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

Keterangan

Parameter input harus memiliki format berikut:

major.minor[.build[.revision]]

di mana major, minor, build, dan revision adalah representasi string dari empat komponen nomor versi: nomor versi utama, nomor versi minor, nomor build, dan nomor revisi, masing-masing. Komponen opsional ditampilkan dalam tanda kurung siku ([ dan ]). Komponen harus muncul dalam urutan yang ditentukan dan harus dipisahkan oleh titik.

Penting

Karena representasi string dari nomor versi harus sesuai dengan pola yang dikenali, aplikasi harus selalu menggunakan penanganan pengecualian saat memanggil Parse metode untuk mengurai input pengguna. Atau, Anda dapat memanggil TryParse metode untuk mengurai representasi string dari nomor versi dan mengembalikan nilai yang menunjukkan apakah operasi penguraian berhasil.

Metode Parse ini adalah metode kenyamanan; setara dengan memanggil Version(String) konstruktor.

Lihat juga

• ToString
• TryParse(String, Version)