Guid.TryParse メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

オーバーロード

TryParse(ReadOnlySpan<Char>, Guid)	GUID の表現を含む文字の指定した読み取り専用スパンを等価の Guid 構造体に変換します。
TryParse(String, Guid)	GUID の文字列形式を等価の Guid 構造体に変換します。
TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)	文字のスパンを値に解析しようとします。
TryParse(String, IFormatProvider, Guid)	文字列を値に解析しようとします。

TryParse(ReadOnlySpan<Char>, Guid)

ソース:

Guid.cs

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

public:
 static bool TryParse(ReadOnlySpan<char> input, [Runtime::InteropServices::Out] Guid % result);

public static bool TryParse (ReadOnlySpan<char> input, out Guid result);

static member TryParse : ReadOnlySpan<char> * Guid -> bool

Public Shared Function TryParse (input As ReadOnlySpan(Of Char), ByRef result As Guid) As Boolean

パラメーター

input

ReadOnlySpan<Char>

変換する GUID を表す文字を含むスパン。

result

Guid

このメソッドから制御が戻るときに、解析された値が格納されます。 メソッドが trueを返す場合、有効な Guidresult 含まれています。 メソッドが falseを返す場合、result は Emptyと等しくなります。

戻り値

Boolean

解析操作が成功したかどうかを true します。それ以外の場合は、falseします。

TryParse(String, Guid)

ソース:

Guid.cs

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

public:
 static bool TryParse(System::String ^ input, [Runtime::InteropServices::Out] Guid % result);

public static bool TryParse (string? input, out Guid result);

static member TryParse : string * Guid -> bool

Public Shared Function TryParse (input As String, ByRef result As Guid) As Boolean

パラメーター

input

String

変換する GUID を含む文字列。

result

Guid

このメソッドから制御が戻るときに、解析された値が格納されます。 メソッドが trueを返す場合、有効な Guidresult 含まれています。 メソッドが falseを返す場合、result は Emptyと等しくなります。

戻り値

Boolean

解析操作が成功したかどうかを true します。それ以外の場合は、falseします。

例

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

Guid 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)
{
    if (Guid.TryParse(stringGuid, out var newGuid))
        Console.WriteLine($"Converted {stringGuid} to a Guid");
    else
        Console.WriteLine($"Unable to convert {stringGuid} to a Guid");
}

// 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
    match Guid.TryParse stringGuid with
    | true, newGuid ->
        printfn $"Converted {stringGuid} to a Guid"
    | _ ->
        printfn $"Unable to convert {stringGuid} to a Guid"

// 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.
      Dim newGuid As Guid
      For Each stringGuid In stringGuids
         If Guid.TryParse(stringGuid, newGuid) Then
            Console.WriteLine("Converted {0} to a Guid", stringGuid)
         Else
            Console.WriteLine("Unable to convert {0} to a Guid", 
                              stringGuid)
         End If     
      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 メソッドに似ていますが、解析された GUID を返す代わりに、input が認識された形式で null または認識されていない場合に false を返し、例外をスローしない点が異なります。 次の表に示すように、input から先頭または末尾の空白をトリミングし、ToString(String) および ToString(String, IFormatProvider) メソッドで認識される 5 つの形式のいずれかで文字列を変換します。

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

こちらもご覧ください

• Parse(String)

TryParse(ReadOnlySpan<Char>, IFormatProvider, Guid)

ソース:

Guid.cs

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

public:
 static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = ISpanParsable<Guid>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out Guid result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * Guid -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As Guid) As Boolean

パラメーター

s

ReadOnlySpan<Char>

解析する文字のスパン。

provider

IFormatProvider

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

result

Guid

このメソッドから制御が戻るときに、sが正常に解析された結果、または失敗した場合は未定義の値が格納されます。

戻り値

Boolean

s が正常に解析されたかどうかを true します。それ以外の場合は、falseします。

TryParse(String, IFormatProvider, Guid)

ソース:

Guid.cs

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

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] Guid % result) = IParsable<Guid>::TryParse;

public static bool TryParse (string? s, IFormatProvider? provider, out Guid result);

static member TryParse : string * IFormatProvider * Guid -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As Guid) As Boolean

パラメーター

s

String

解析する文字列。

provider

IFormatProvider

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

result

Guid

このメソッドから制御が戻るときに、正常に s 解析された結果または失敗した場合の未定義の値が格納されます。

戻り値

Boolean

s が正常に解析されたかどうかを true します。それ以外の場合は、falseします。