英語で読む

次の方法で共有


Version.Parse メソッド

定義

オーバーロード

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

バージョン番号を表す文字の指定した読み取り専用のスパンを、等価の Version オブジェクトに変換します。

Parse(String)

バージョン番号の文字列形式を等価の Version オブジェクトに変換します。

Parse(ReadOnlySpan<Byte>)

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

パラメーター

utf8Text
ReadOnlySpan<Byte>

戻り値

適用対象

.NET 10
製品 バージョン
.NET 10

Parse(ReadOnlySpan<Char>)

ソース:
Version.cs
ソース:
Version.cs
ソース:
Version.cs

バージョン番号を表す文字の指定した読み取り専用のスパンを、等価の Version オブジェクトに変換します。

public static Version Parse(ReadOnlySpan<char> input);

パラメーター

input
ReadOnlySpan<Char>

変換するバージョン番号を含む文字の読み取り専用のスパン。

戻り値

input パラメーターで指定されているバージョン番号と等価のオブジェクト。

例外

input のバージョン構成要素数が 2 未満であるか、4 を上回っています。

input 内の少なくとも 1 つの構成要素が 0 未満です。

input 内の少なくとも 1 つの構成要素が整数ではありません。

内の input 少なくとも 1 つのコンポーネントは、 Int32.MaxValue より大きい数値を表します。

注釈

パラメーターの形式は input 次のとおりです。

major.minor[.build[.revision]]

ここで majorminor、、 buildおよび revision は、バージョン番号の 4 つのコンポーネント (メジャー バージョン番号、マイナー バージョン番号、ビルド番号、リビジョン番号) の文字列表現です。 オプションのコンポーネントは角かっこ ([ と ]) で示されます。 コンポーネントは、指定した順序で表示する必要があり、期間で区切る必要があります。

適用対象

.NET 10 およびその他のバージョン
製品 バージョン
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard 2.1

Parse(String)

ソース:
Version.cs
ソース:
Version.cs
ソース:
Version.cs

バージョン番号の文字列形式を等価の Version オブジェクトに変換します。

public static Version Parse(string input);

パラメーター

input
String

変換するバージョン番号を含んだ文字列。

戻り値

input パラメーターで指定されているバージョン番号と等価のオブジェクト。

例外

inputnullです。

input のバージョン構成要素数が 2 未満であるか、4 を上回っています。

input 内の少なくとも 1 つの構成要素が 0 未満です。

input 内の少なくとも 1 つの構成要素が整数ではありません。

内の input 少なくとも 1 つのコンポーネントは、 Int32.MaxValue より大きい数値を表します。

次の例では、 メソッドを Parse 使用して、バージョン情報を含む複数の文字列を解析します。

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

注釈

パラメーターの形式は input 次のとおりです。

major.minor[.build[.revision]]

ここで majorminor、、 buildおよび revision は、バージョン番号の 4 つのコンポーネント (メジャー バージョン番号、マイナー バージョン番号、ビルド番号、リビジョン番号) の文字列表現です。 オプションのコンポーネントは角かっこ ([ と ]) で示されます。 コンポーネントは、指定した順序で表示する必要があり、期間で区切る必要があります。

重要

バージョン番号の文字列表現は認識されたパターンに準拠している必要があるため、アプリケーションはメソッドを呼び出してユーザー入力を解析するときに常に例外処理を Parse 使用する必要があります。 または、 メソッドを TryParse 呼び出してバージョン番号の文字列表現を解析し、解析操作が成功したかどうかを示す値を返すこともできます。

メソッドは Parse 便利なメソッドであり、コンストラクターを呼び出すことと Version(String) 同じです。

こちらもご覧ください

適用対象

.NET 10 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0