Version.Parse 메서드

정의

오버로드

Parse(ReadOnlySpan<Char>)

동등한 Version 개체에 대해 버전 번호를 나타내는 문자의 지정된 읽기 전용 범위를 변환합니다.Converts the specified read-only span of characters that represents a version number to an equivalent Version object.

Parse(String)

버전 번호의 문자열 표현을 해당하는 Version 개체로 변환합니다.Converts the string representation of a version number to an equivalent Version object.

Parse(ReadOnlySpan<Char>)

동등한 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);
public static Version Parse (ReadOnlySpan<char> input);
static member Parse : ReadOnlySpan<char> -> Version
Public Shared Function Parse (input As ReadOnlySpan(Of Char)) As Version

매개 변수

input
ReadOnlySpan<Char>

변환할 버전 번호가 포함된 문자의 읽기 전용 범위입니다.A read-only span of characters that contains a version number to convert.

반환

Version

input 매개 변수에 지정된 버전 번호에 해당하는 개체입니다.An object that is equivalent to the version number specified in the input parameter.

예외

input에 하나 이하 또는 다섯 개 이상의 버전 구성 요소가 있는 경우input has fewer than two or more than four version components.

input의 구성 요소 하나 이상이 0보다 작은 경우At least one component in input is less than zero.

input의 구성 요소 하나 이상이 정수가 아닌 경우At least one component in input is not an integer.

input의 구성 요소 하나 이상이 MaxValue보다 큰 수를 나타내는 경우At least one component in input represents a number that is greater than MaxValue.

설명

input매개 변수의 형식은 다음과 같아야 합니다.The input parameter must have the following format:

major.minor[.build[.revision]]

여기서 major , minor , buildrevision 는 각각 주 버전 번호, 부 버전 번호, 빌드 번호 및 수정 번호의 네 가지 구성 요소에 대 한 문자열 표현입니다.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. 선택적 구성 요소는 대괄호 ([및])로 표시 됩니다.Optional components are shown in square brackets ([ and ]). 구성 요소는 지정 된 순서 대로 표시 되어야 하며 마침표로 구분 되어야 합니다.The components must appear in the specified order and must be separated by periods.

적용 대상

Parse(String)

버전 번호의 문자열 표현을 해당하는 Version 개체로 변환합니다.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

매개 변수

input
String

변환할 버전 번호가 들어 있는 문자열입니다.A string that contains a version number to convert.

반환

Version

input 매개 변수에 지정된 버전 번호에 해당하는 개체입니다.An object that is equivalent to the version number specified in the input parameter.

예외

input이(가) null인 경우input is null.

input에 하나 이하 또는 다섯 개 이상의 버전 구성 요소가 있는 경우input has fewer than two or more than four version components.

input의 구성 요소 하나 이상이 0보다 작은 경우At least one component in input is less than zero.

input의 구성 요소 하나 이상이 정수가 아닌 경우At least one component in input is not an integer.

input의 구성 요소 하나 이상이 MaxValue보다 큰 수를 나타내는 경우At least one component in input represents a number that is greater than MaxValue.

예제

다음 예제에서는 메서드를 사용 하 여 Parse 버전 정보가 포함 된 여러 문자열을 구문 분석 합니다.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'.

설명

input매개 변수의 형식은 다음과 같아야 합니다.The input parameter must have the following format:

major.minor[.build[.revision]]

여기서 major , minor , buildrevision 는 각각 주 버전 번호, 부 버전 번호, 빌드 번호 및 수정 번호의 네 가지 구성 요소에 대 한 문자열 표현입니다.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. 선택적 구성 요소는 대괄호 ([및])로 표시 됩니다.Optional components are shown in square brackets ([ and ]). 구성 요소는 지정 된 순서 대로 표시 되어야 하며 마침표로 구분 되어야 합니다.The components must appear in the specified order and must be separated by periods.

중요

버전 번호의 문자열 표현을 인식 가능한 패턴을 따라야 하므로 애플리케이션 해야 항상 사용 하 여 예외 처리를 호출할 때를 Parse 사용자 입력을 구문 분석 하는 방법입니다.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. 또는 메서드를 호출 하 여 TryParse 버전 번호의 문자열 표현을 구문 분석 하 고 구문 분석 작업이 성공 했는지 여부를 나타내는 값을 반환할 수 있습니다.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.

Parse메서드는 편리한 메서드입니다. 생성자를 호출 하는 것과 같습니다 Version(String) .The Parse method is a convenience method; it is equivalent to calling the Version(String) constructor.

추가 정보

적용 대상