Version.Parse Version.Parse Version.Parse Version.Parse Method

定義

オーバーロード

Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>)
Parse(String) Parse(String) Parse(String) Parse(String)

バージョン番号の文字列形式を等価の Version オブジェクトに変換します。Converts the string representation of a version number to an equivalent Version object.

Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>) Parse(ReadOnlySpan<Char>)

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

パラメーター

戻り値

Parse(String) Parse(String) Parse(String) 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 String String String

変換するバージョン番号を含んだ文字列。A string that contains a version number to convert.

戻り値

input パラメーターで指定されているバージョン番号と等価のオブジェクト。An object that is equivalent to the version number specified in the input parameter.

例外

input のバージョン構成要素数が 2 未満であるか、4 を上回っています。input has fewer than two or more than four version components.

input 内の少なくとも 1 つの構成要素が 0 未満です。At least one component in input is less than zero.

input 内の少なくとも 1 つの構成要素が整数ではありません。At least one component in input is not an integer.

input の構成要素のうちの少なくとも 1 つが 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]]  

majorminorbuild、およびrevisionは、バージョン番号の4つのコンポーネント (メジャーバージョン番号、マイナーバージョン番号、ビルド番号、リビジョン番号) の文字列形式です。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. 省略可能なコンポーネントは、角かっこ ([および]) で示されています。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.

メソッドは便利なメソッドで、 Version(String)コンストラクターを呼び出すことと同じです。 ParseThe Parse method is a convenience method; it is equivalent to calling the Version(String) constructor.

こちらもご覧ください

適用対象