Guid.TryParseExact 方法

  • 参考

定义

命名空间:
System
程序集:
System.Runtime.dll
程序集:
netstandard.dll
程序集:
mscorlib.dll

重载

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid)

如果字符串采用指定格式，则将表示 GUID 的字符范围转换为等效的 Guid 结构。
TryParseExact(String, String, Guid)

将 GUID 的字符串表示形式转换为等效的 Guid 结构，前提是该字符串采用的是指定格式。

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, Guid)

Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs

如果字符串采用指定格式，则将表示 GUID 的字符范围转换为等效的 Guid 结构。

public:
 static bool TryParseExact(ReadOnlySpan<char> input, ReadOnlySpan<char> format, [Runtime::InteropServices::Out] Guid % result);
public static bool TryParseExact (ReadOnlySpan<char> input, ReadOnlySpan<char> format, out Guid result);
static member TryParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> * Guid -> bool
Public Shared Function TryParseExact (input As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char), ByRef result As Guid) As Boolean

参数

input
ReadOnlySpan<Char>

包含表示要转换的 GUID 的字符的只读范围。

format
ReadOnlySpan<Char>

包含表示以下某个说明符的字符的只读范围，指示解释 input 时要使用的确切格式：“N”、“D”、“B”、“P”或“X”。

result
Guid

在此方法返回时，包含已解析的值。 如果此方法返回 true，result 将包含有效的 Guid。 如果 result 等于 Empty，则此方法将返回 false。

返回

Boolean

如果分析操作成功，则为 true；否则为 false。

适用于

TryParseExact(String, String, Guid)

Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs

将 GUID 的字符串表示形式转换为等效的 Guid 结构，前提是该字符串采用的是指定格式。

public:
 static bool TryParseExact(System::String ^ input, System::String ^ format, [Runtime::InteropServices::Out] Guid % result);
public static bool TryParseExact (string input, string format, out Guid result);
public static bool TryParseExact (string? input, string? format, out Guid result);
static member TryParseExact : string * string * Guid -> bool
Public Shared Function TryParseExact (input As String, format As String, ByRef result As Guid) As Boolean

参数

input
String

要转换的 GUID。

format
String

下列说明符之一，指示当解释 input 时要使用的确切格式：“N”、“D”、“B”、“P”或“X”。

result
Guid

在此方法返回时，包含已解析的值。 如果此方法返回 true，result 将包含有效的 Guid。 如果 result 等于 Empty，则此方法将返回 false。

返回

Boolean

如果分析操作成功，则为 true；否则为 false。

示例

以下示例使用每个支持的格式说明符调用 ToString(String) 方法，以生成表示单个 GUID 的字符串数组。 然后将这些传递给 TryParseExact 方法，该方法成功分析符合“B”格式说明符的字符串。

// Define an array of all format specifiers.
string[] formats = { "N", "D", "B", "P", "X" };
Guid guid = Guid.NewGuid();
// Create an array of valid Guid string representations.
var stringGuids = new string[formats.Length];
for (int ctr = 0; ctr < formats.Length; ctr++)
    stringGuids[ctr] = guid.ToString(formats[ctr]);

// Parse the strings in the array using the "B" format specifier.
foreach (var stringGuid in stringGuids)
{
    if (Guid.TryParseExact(stringGuid, "B", out var newGuid))
        Console.WriteLine($"Successfully parsed {stringGuid}");
    else
        Console.WriteLine($"Unable to parse '{stringGuid}'");
}

// The example displays output similar to the following:
//
//    Unable to parse 'c0fb150f6bf344df984a3a0611ae5e4a'
//    Unable to parse 'c0fb150f-6bf3-44df-984a-3a0611ae5e4a'
//    Successfully parsed {c0fb150f-6bf3-44df-984a-3a0611ae5e4a}
//    Unable to parse '(c0fb150f-6bf3-44df-984a-3a0611ae5e4a)'
//    Unable to parse '{0xc0fb150f,0x6bf3,0x44df,{0x98,0x4a,0x3a,0x06,0x11,0xae,0x5e,0x4a}}'

open System

// Define an array of all format specifiers.
let formats = [| "N"; "D"; "B"; "P"; "X" |]

let guid = Guid.NewGuid()

// Create an array of valid Guid string representations.
let stringGuids = 
    Array.map guid.ToString formats

// Parse the strings in the array using the "B" format specifier.
for stringGuid in stringGuids do
    match Guid.TryParseExact(stringGuid, "B") with
    | true, newGuid ->
        printfn $"Successfully parsed {stringGuid}"
    | _ ->
        printfn $"Unable to parse '{stringGuid}'"

// The example displays output similar to the following:
//
//    Unable to parse 'c0fb150f6bf344df984a3a0611ae5e4a'
//    Unable to parse 'c0fb150f-6bf3-44df-984a-3a0611ae5e4a'
//    Successfully parsed {c0fb150f-6bf3-44df-984a-3a0611ae5e4a}
//    Unable to parse '(c0fb150f-6bf3-44df-984a-3a0611ae5e4a)'
//    Unable to parse '{0xc0fb150f,0x6bf3,0x44df,{0x98,0x4a,0x3a,0x06,0x11,0xae,0x5e,0x4a}}'

Module Example
   Public Sub Main()
      ' Define an array of all format specifiers.
      Dim formats() As String = { "N", "D", "B", "P", "X" }
      Dim guid As Guid = Guid.NewGuid()
      ' Create an array of valid Guid string representations.
      Dim stringGuids(formats.Length - 1) As String
      For ctr As Integer = 0 To formats.Length - 1
         stringGuids(ctr) = guid.ToString(formats(ctr))
      Next

      ' Try to parse the strings in the array using the "B" format specifier.
      For Each stringGuid In stringGuids
         Dim newGuid As Guid
         If Guid.TryParseExact(stringGuid, "B", newGuid) Then
            Console.WriteLine("Successfully parsed {0}", stringGuid)
         Else
            Console.WriteLine("Unable to parse '{0}'", stringGuid)
         End If   
      Next      
   End Sub
End Module
' The example displays the following output:
'    Unable to parse 'c0fb150f6bf344df984a3a0611ae5e4a'
'    Unable to parse 'c0fb150f-6bf3-44df-984a-3a0611ae5e4a'
'    Successfully parsed {c0fb150f-6bf3-44df-984a-3a0611ae5e4a}
'    Unable to parse '(c0fb150f-6bf3-44df-984a-3a0611ae5e4a)'
'    Unable to parse '{0xc0fb150f,0x6bf3,0x44df,{0x98,0x4a,0x3a,0x06,0x11,0xae,0x5e,0x4a}}'

注解

此方法要求在删除前导空格和尾随空格字符后，将字符串转换为完全采用 format 参数指定的格式。 如果 input 为 null 或 未采用 指定的format格式，则返回 false ，并且不会引发异常。

下表显示了 参数的接受格式说明符 format 。 “0”表示数字;将显示 (“-”) 、大括号 (“{”、“}”) 和括号 (“ (”、“) ”) 。

说明符 input参数的格式
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 四个十六进制值括在大括号中，其中第四个值是八个十六进制值的子集，这些值也括在大括号中：

{0x00000000，0x0000，0x0000，{0x00，0x00，0x00，0x00，0x00，0x00，0x00，0x00}}

另请参阅

适用于