Guid.Parse メソッド

リファレンス

定義

名前空間:: System

アセンブリ:: System.Runtime.dll

アセンブリ:: netstandard.dll

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

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

Parse(String, IFormatProvider)

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: Guid.cs

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

public:
 static Guid Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<Guid>::Parse;

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

static member Parse : string * IFormatProvider -> Guid

Public Shared Function Parse (s As String, provider As IFormatProvider) As Guid

パラメーター

s: String

解析する文字列。

provider: IFormatProvider

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

戻り値

Guid

を解析した s結果。

実装

Parse(String, IFormatProvider)

適用対象

Parse(ReadOnlySpan<Char>, IFormatProvider)

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: Guid.cs

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

public:
 static Guid Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<Guid>::Parse;

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

static member Parse : ReadOnlySpan<char> * IFormatProvider -> Guid

Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As Guid

パラメーター

s: ReadOnlySpan<Char>

解析する文字のスパン。

provider: IFormatProvider

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

戻り値

Guid

を解析した s結果。

実装

Parse(ReadOnlySpan<Char>, IFormatProvider)

適用対象

Parse(ReadOnlySpan<Char>)

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: Guid.cs

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

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

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

static member Parse : ReadOnlySpan<char> -> Guid

Public Shared Function Parse (input As ReadOnlySpan(Of Char)) As Guid

パラメーター

input: ReadOnlySpan<Char>

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

戻り値

Guid

解析された値を格納する構造体。

例外

FormatException

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

または

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

注釈

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

指定子	説明	Format
`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 処理することなく、失敗した解析操作をキャッチするには、メソッドを使用します。

適用対象

Parse(String)

ソース:: Guid.cs

ソース:: Guid.cs

ソース:: Guid.cs

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

public:
 static Guid Parse(System::String ^ input);

public static Guid Parse (string input);

static member Parse : string -> Guid

Public Shared Function Parse (input As String) As Guid

パラメーター

input: String

変換する文字列。

戻り値

Guid

解析された値を格納する構造体。

例外

ArgumentNullException

input が nullです。

FormatException

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

例

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

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

open System

let originalGuid = Guid.NewGuid()
// Create an array of string representations of the GUID.
let stringGuids =
    [| originalGuid.ToString "B"
       originalGuid.ToString "D"
       originalGuid.ToString "X" |]

// Parse each string representation.
for stringGuid in stringGuids do
    try
        let newGuid = Guid.Parse stringGuid
        printfn $"Converted {stringGuid} to a Guid"
    with
    | :? ArgumentNullException ->
        printfn "The string to be parsed is null."
    | :? FormatException ->
        printfn $"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

Module Example
   Public Sub Main()
      Dim originalGuid As Guid = Guid.NewGuid()
      ' Create an array of string representations of the GUID.
      Dim stringGuids() As String = { originalGuid.ToString("B"),
                                      originalGuid.ToString("D"),
                                      originalGuid.ToString("X") }
      
      ' Parse each string representation.
      For Each stringGuid In stringGuids
         Try 
            Dim newGuid As Guid = Guid.Parse(stringGuid) 
            Console.WriteLine("Converted {0} to a Guid", stringGuid)
         Catch e As ArgumentNullException
            Console.WriteLine("The string to be parsed is null.")   
         Catch e As FormatException
            Console.WriteLine("Bad format: {0}", stringGuid)
         End Try     
      Next                                      
   End Sub
End Module
' The example displays the following output:
'    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, IFormatProvider) メソッドによってToString(String)生成される 5 つの形式のいずれかで文字列を変換できます。

指定子	説明	Format
`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 処理することなく、失敗した解析操作をキャッチするには、メソッドを使用します。

こちらもご覧ください

適用対象

Guid.Parse メソッド

定義

オーバーロード

Parse(String, IFormatProvider)

パラメーター

戻り値

実装

適用対象

Parse(ReadOnlySpan<Char>, IFormatProvider)

パラメーター

戻り値

実装

適用対象

Parse(ReadOnlySpan<Char>)

パラメーター

戻り値

例外

注釈

適用対象

Parse(String)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース