Version.Parse Metoda

Definicja

Przeciążenia

Parse(ReadOnlySpan<Char>)

Konwertuje określony zakres tylko do odczytu znaków reprezentujący numer wersji do obiektu równoważnego Version .Converts the specified read-only span of characters that represents a version number to an equivalent Version object.

Parse(String)

Konwertuje ciąg reprezentujący numer wersji na odpowiedni Version obiekt.Converts the string representation of a version number to an equivalent Version object.

Parse(ReadOnlySpan<Char>)

Konwertuje określony zakres tylko do odczytu znaków reprezentujący numer wersji do obiektu równoważnego Version .Converts the specified read-only span of characters that represents a version number to an equivalent Version object.

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

Parametry

input
ReadOnlySpan<Char>

Zakres znaków tylko do odczytu, który zawiera numer wersji do przekonwertowania.A read-only span of characters that contains a version number to convert.

Zwraca

Version

Obiekt, który jest odpowiednikiem numeru wersji określonej w input parametrze.An object that is equivalent to the version number specified in the input parameter.

Wyjątki

input ma mniej niż dwa lub więcej niż cztery składniki wersji.input has fewer than two or more than four version components.

Co najmniej jeden składnik w input jest mniejszy od zera.At least one component in input is less than zero.

Co najmniej jeden składnik w input nie jest liczbą całkowitą.At least one component in input is not an integer.

Co najmniej jeden składnik w programie input reprezentuje liczbę, która jest większa niż MaxValue .At least one component in input represents a number that is greater than MaxValue.

Uwagi

inputParametr musi mieć następujący format:The input parameter must have the following format:

major.minor[.build[.revision]]

gdzie major , minor , build i revision to ciąg reprezentujący cztery składniki numeru wersji: główny numer wersji, numer wersji pomocniczej, numer kompilacji i numer poprawki.where major, minor, build, and revision are the string representations of the version number's four components: major version number, minor version number, build number, and revision number, respectively. Składniki opcjonalne są wyświetlane w nawiasach kwadratowych ([i]).Optional components are shown in square brackets ([ and ]). Składniki muszą znajdować się w określonej kolejności i muszą być oddzielone kropkami.The components must appear in the specified order and must be separated by periods.

Dotyczy

Parse(String)

Konwertuje ciąg reprezentujący numer wersji na odpowiedni Version obiekt.Converts the string representation of a version number to an equivalent Version object.

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

Parametry

input
String

Ciąg, który zawiera numer wersji do przekonwertowania.A string that contains a version number to convert.

Zwraca

Version

Obiekt, który jest odpowiednikiem numeru wersji określonej w input parametrze.An object that is equivalent to the version number specified in the input parameter.

Wyjątki

input to null.input is null.

input ma mniej niż dwa lub więcej niż cztery składniki wersji.input has fewer than two or more than four version components.

Co najmniej jeden składnik w input jest mniejszy od zera.At least one component in input is less than zero.

Co najmniej jeden składnik w input nie jest liczbą całkowitą.At least one component in input is not an integer.

Co najmniej jeden składnik w programie input reprezentuje liczbę, która jest większa niż MaxValue .At least one component in input represents a number that is greater than MaxValue.

Przykłady

W poniższym przykładzie zastosowano Parse metodę w celu przeanalizowania szeregu ciągów zawierających informacje o wersji.The following example uses the Parse method to parse a number of strings that contain version information.

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

Uwagi

inputParametr musi mieć następujący format:The input parameter must have the following format:

major.minor[.build[.revision]]

gdzie major , minor , build i revision to ciąg reprezentujący cztery składniki numeru wersji: główny numer wersji, numer wersji pomocniczej, numer kompilacji i numer poprawki.where major, minor, build, and revision are the string representations of the version number's four components: major version number, minor version number, build number, and revision number, respectively. Składniki opcjonalne są wyświetlane w nawiasach kwadratowych ([i]).Optional components are shown in square brackets ([ and ]). Składniki muszą znajdować się w określonej kolejności i muszą być oddzielone kropkami.The components must appear in the specified order and must be separated by periods.

Ważne

Ponieważ ciąg reprezentujący numer wersji musi być zgodny ze rozpoznanym wzorcem, aplikacje powinny zawsze używać obsługi wyjątków podczas wywoływania Parse metody w celu przeanalizowania danych wejściowych użytkownika.Because the string representation of a version number must conform to a recognized pattern, applications should always use exception handling when calling the Parse method to parse user input. Alternatywnie można wywołać TryParse metodę, aby przeanalizować ciąg reprezentujący numer wersji i zwrócić wartość wskazującą, czy operacja analizy zakończyła się pomyślnie.Alternatively, you can call the TryParse method to parse the string representation of a version number and return a value that indicates whether the parse operation succeeded.

ParseMetoda jest wygodną metodą; jest równoważna wywołaniu Version(String) konstruktora.The Parse method is a convenience method; it is equivalent to calling the Version(String) constructor.

Zobacz też

Dotyczy