Bagikan melalui


Version.Parse Metode

Definisi

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

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

Pengecualian

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

Setidaknya satu komponen di input kurang dari nol.

Setidaknya satu komponen di input bukan bilangan bulat.

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.

Berlaku untuk

Parse(String)

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

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

Pengecualian

inputadalah null.

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

Setidaknya satu komponen di input kurang dari nol.

Setidaknya satu komponen di input bukan bilangan bulat.

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

Berlaku untuk