Version.Parse Metódus

Definíció

Névtér:: System

Szerelvények:: netstandard.dll, System.Runtime.dll

Szerelvény:: System.Runtime.dll

Szerelvény:: netstandard.dll

Szerelvények:: mscorlib.dll, System.Runtime.dll

Szerelvény:: mscorlib.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Túlterhelések

Név	Description
Parse(ReadOnlySpan<Byte>)	Az UTF-8 karakterek megadott írásvédett tartományát alakítja át, amely a verziószámot egy egyenértékű Verzió objektummá alakítja.
Parse(ReadOnlySpan<Char>)	A megadott írásvédett karaktereket konvertálja, amelyek egy verziószámot jelölnek, egyenértékű Version objektummá.
Parse(String)	Egy verziószám sztringképét egyenértékű Version objektummá alakítja.

Parse(ReadOnlySpan<Byte>)

Forrás:: Version.cs

Forrás:: Version.cs

Az UTF-8 karakterek megadott írásvédett tartományát alakítja át, amely a verziószámot egy egyenértékű Verzió objektummá alakítja.

public:
 static Version ^ Parse(ReadOnlySpan<System::Byte> utf8Text);

public static Version Parse(ReadOnlySpan<byte> utf8Text);

static member Parse : ReadOnlySpan<byte> -> Version

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte)) As Version

Paraméterek

utf8Text: ReadOnlySpan<Byte>

Az átalakítandó verziószámot tartalmazó UTF-8 karakter írásvédett tartománya.

Válaszok

Version

A paraméterben utf8Text megadott verziószámmal egyenértékű objektum.

Kivételek

ArgumentException

utf8Text kevesebb mint két vagy négy verzióösszetevőt tartalmaz.

ArgumentOutOfRangeException

Legalább egy összetevő utf8Text nullánál kisebb.

FormatException

Legalább egy összetevő utf8Text nem egész szám.

OverflowException

Legalább egy összetevő olyan utf8Text számot jelöl, amely nagyobb, mint MaxValue.

A következőre érvényes:

Parse(ReadOnlySpan<Char>)

Forrás:: Version.cs

Forrás:: Version.cs

Forrás:: Version.cs

Forrás:: Version.cs

Forrás:: Version.cs

A megadott írásvédett karaktereket konvertálja, amelyek egy verziószámot jelölnek, egyenértékű Version objektummá.

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

Paraméterek

input: ReadOnlySpan<Char>

A konvertálni kívánt verziószámot tartalmazó karakterek írásvédett száma.

Válaszok

Version

A paraméterben input megadott verziószámmal egyenértékű objektum.

Kivételek

ArgumentException

input kevesebb mint két vagy négy verzióösszetevőt tartalmaz.

ArgumentOutOfRangeException

Legalább egy összetevő input nullánál kisebb.

FormatException

Legalább egy összetevő input nem egész szám.

OverflowException

Legalább egy összetevő olyan input számot jelöl, amely nagyobb, mint az Int32.MaxValue.

Megjegyzések

A input paraméternek a következő formátummal kell rendelkeznie:

major.minor[.build[.revision]]

ahol major, minor, buildés revision a verziószám négy összetevőjének sztring-ábrázolásai: főverziószám, alverziószám, buildszám és változatszám. A választható összetevők szögletes zárójelben ([ és ]) jelennek meg. Az összetevőknek a megadott sorrendben kell megjelennie, és pontokkal kell elválasztani.

A következőre érvényes:

Parse(String)

Forrás:: Version.cs

Forrás:: Version.cs

Forrás:: Version.cs

Forrás:: Version.cs

Forrás:: Version.cs

Egy verziószám sztringképét egyenértékű Version objektummá alakítja.

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

Paraméterek

input: String

Egy konvertálni kívánt verziószámot tartalmazó sztring.

Válaszok

Version

A paraméterben input megadott verziószámmal egyenértékű objektum.

Kivételek

ArgumentNullException

input az null.

ArgumentException

input kevesebb mint két vagy négy verzióösszetevőt tartalmaz.

ArgumentOutOfRangeException

Legalább egy összetevő input nullánál kisebb.

FormatException

Legalább egy összetevő input nem egész szám.

OverflowException

Legalább egy összetevő olyan input számot jelöl, amely nagyobb, mint az Int32.MaxValue.

Példák

Az alábbi példa a Parse metódussal elemzi a verzióinformációkat tartalmazó sztringeket.

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

Megjegyzések

A input paraméternek a következő formátummal kell rendelkeznie:

major.minor[.build[.revision]]

Important

Mivel egy verziószám sztring-ábrázolásának meg kell felelnie egy felismert mintának, az alkalmazásoknak mindig kivételkezelést kell használniuk, amikor meghívják a metódust a Parse felhasználói bemenet elemzéséhez. Másik lehetőségként meghívhatja a TryParse metódust, hogy elemezze egy verziószám sztringképét, és visszaadjon egy értéket, amely jelzi, hogy az elemzési művelet sikeres volt-e.

A Parse módszer egy egyszerű módszer; egyenértékű a konstruktor meghívásával Version(String) .

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?