Guid.Parse メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

オーバーロード

Parse(String, IFormatProvider)	文字列を値に解析します。
Parse(ReadOnlySpan<Char>, IFormatProvider)	文字のスパンを値に解析します。
Parse(String)	GUID の文字列形式を等価の Guid 構造体に変換します。
Parse(ReadOnlySpan<Char>)	GUID を表す読み取り専用の文字スパンを等価の Guid 構造体に変換します。

Parse(String, IFormatProvider)

ソース:

Guid.cs

文字列を値に解析します。

C#

public static Guid Parse (string s, IFormatProvider? provider);

パラメーター

s

String

解析する文字列。

provider

IFormatProvider

sに関するカルチャ固有の書式設定情報を提供するオブジェクト。

戻り値

Guid

s解析の結果。

実装

Parse(String, IFormatProvider)

Parse(ReadOnlySpan<Char>, IFormatProvider)

ソース:

Guid.cs

文字のスパンを値に解析します。

C#

public static Guid Parse (ReadOnlySpan<char> s, IFormatProvider? provider);

パラメーター

s

ReadOnlySpan<Char>

解析する文字のスパン。

provider

IFormatProvider

sに関するカルチャ固有の書式設定情報を提供するオブジェクト。

戻り値

Guid

s解析の結果。

実装

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parse(String)

ソース:

Guid.cs

GUID の文字列形式を等価の Guid 構造体に変換します。

C#

public static Guid Parse (string input);

パラメーター

input

String

変換する文字列。

戻り値

Guid

解析された値を含む構造体。

例外

ArgumentNullException

input は nullです。

FormatException

input が認識された形式ではありません。

例

次の例では、新しい GUID を作成し、"B"、"D"、および "X" 書式指定子を使用して ToString(String) メソッドを呼び出して 3 つの個別の文字列表現に変換した後、Parse メソッドを呼び出して文字列を Guid 値に変換します。

C#

var originalGuid = Guid.NewGuid();
// Create an array of string representations of the GUID.
string[] stringGuids = { originalGuid.ToString("B"),
                         originalGuid.ToString("D"),
                         originalGuid.ToString("X") };

// Parse each string representation.
foreach (var stringGuid in stringGuids)
{
    try
    {
        Guid newGuid = Guid.Parse(stringGuid);
        Console.WriteLine($"Converted {stringGuid} to a Guid");
    }
    catch (ArgumentNullException)
    {
        Console.WriteLine("The string to be parsed is null.");
    }
    catch (FormatException)
    {
        Console.WriteLine($"Bad format: {stringGuid}");
    }
}

// The example displays output similar to the following:
//
//    Converted {81a130d2-502f-4cf1-a376-63edeb000e9f} to a Guid
//    Converted 81a130d2-502f-4cf1-a376-63edeb000e9f to a Guid
//    Converted {0x81a130d2,0x502f,0x4cf1,{0xa3,0x76,0x63,0xed,0xeb,0x00,0x0e,0x9f}} to a Guid

注釈

Parse メソッドは、先頭または末尾の空白を input からトリミングし、GUID の文字列形式を Guid 値に変換します。 このメソッドは、次の表に示すように、ToString(String) メソッドと ToString(String, IFormatProvider) メソッドによって生成された 5 つの形式のいずれかで文字列を変換できます。

指定	形容	形式
N	32 桁の 16 進数	00000000000000000000000000000000
D	ハイフンで区切られた 32 桁の 16 進数	00000000-0000-0000-0000-000000000000
B	ハイフンで区切られた 32 桁の 16 進数(中かっこで囲む)	{00000000-0000-0000-0000-000000000000}
P	かっこで囲まれたハイフンで区切られた 32 桁の 16 進数	(00000000-0000-0000-0000-000000000000)
X	中かっこで囲まれた 4 つの 16 進値。4 番目の値は、中かっこで囲まれた 8 つの 16 進値のサブセットです	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

このメソッドは、文字列を正常に解析できない場合に FormatException をスローします。 この問題が発生する理由には、次のようなものがあります。

• input には、16 進文字セットに含まれていない文字が含まれています。

• input の文字数が多すぎるか、少なすぎます。

• input は、ToString メソッドによって認識され、前の表に示した形式の 1 つではありません。

TryParse メソッドを使用して、失敗した解析操作をキャッチし、例外を処理する必要はありません。

こちらもご覧ください

• TryParse(String, Guid)
• ToString()

Parse(ReadOnlySpan<Char>)

ソース:

Guid.cs

GUID を表す読み取り専用の文字スパンを等価の Guid 構造体に変換します。

C#

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

パラメーター

input

ReadOnlySpan<Char>

GUID を表すバイトを含む読み取り専用スパン。

戻り値

Guid

解析された値を含む構造体。

例外

FormatException

input が認識された形式ではありません。

-又は-

トリミング後、読み取り専用文字スパンの長さは 0 になります。

注釈

Parse メソッドは、先頭または末尾の空白文字を input からトリミングし、input の残りの文字を Guid 値に変換します。 このメソッドは、次の表に示すように、ToString メソッドによって生成される 5 つの形式のいずれかを表す文字スパンを変換できます。

指定	形容	形式
N	32 桁の 16 進数	00000000000000000000000000000000
D	ハイフンで区切られた 32 桁の 16 進数	00000000-0000-0000-0000-000000000000
B	ハイフンで区切られた 32 桁の 16 進数(中かっこで囲む)	{00000000-0000-0000-0000-000000000000}
P	かっこで囲まれたハイフンで区切られた 32 桁の 16 進数	(00000000-0000-0000-0000-000000000000)
X	中かっこで囲まれた 4 つの 16 進値。4 番目の値は、中かっこで囲まれた 8 つの 16 進値のサブセットです	{0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}}

このメソッドは、文字列を正常に解析できない場合に FormatException をスローします。 この問題が発生する理由には、次のようなものがあります。

• input には、16 進文字セットに含まれていない文字が含まれています。

• input の文字数が多すぎるか、少なすぎます。

• input は、ToString メソッドによって認識され、前の表に示した形式の 1 つではありません。

TryParse メソッドを使用して、失敗した解析操作をキャッチし、例外を処理する必要はありません。