Guid.ParseExact 方法

  • 参考

定义

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

重载

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

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

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

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>)

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

public:
 static Guid ParseExact(ReadOnlySpan<char> input, ReadOnlySpan<char> format);
public static Guid ParseExact (ReadOnlySpan<char> input, ReadOnlySpan<char> format);
static member ParseExact : ReadOnlySpan<char> * ReadOnlySpan<char> -> Guid
Public Shared Function ParseExact (input As ReadOnlySpan(Of Char), format As ReadOnlySpan(Of Char)) As Guid

参数

input
ReadOnlySpan<Char>

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

format
ReadOnlySpan<Char>

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

返回

Guid

一个包含已分析的值的结构。

注解

该方法 ParseExact 要求只读字符跨度转换为完全采用参数指定的 format 格式，在删除前导字符和尾随空格字符后。 下表显示了参数的接受格式说明符 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}}

适用于

ParseExact(String, String)

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

public:
 static Guid ParseExact(System::String ^ input, System::String ^ format);
public static Guid ParseExact (string input, string format);
static member ParseExact : string * string -> Guid
Public Shared Function ParseExact (input As String, format As String) As Guid

参数

input
String

要转换的 GUID。

format
String

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

返回

Guid

一个包含已分析的值的结构。

例外

ArgumentNullException

input 或 format 为 null。

FormatException

input 未采用 format 指定的格式。

示例

以下示例使用每个受支持的格式说明符调用 ToString(String) 该方法，以生成表示单个 GUID 的字符串数组。 然后，这些方法将传递给 ParseExact 该方法，该方法仅分析符合“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)
{
    try
    {
        Guid newGuid = Guid.ParseExact(stringGuid, "B");
        Console.WriteLine($"Successfully parsed {stringGuid}");
    }
    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:
//
//    Bad Format: eb5c8c7d187a44e68afb81e854c39457
//    Bad Format: eb5c8c7d-187a-44e6-8afb-81e854c39457
//    Successfully parsed {eb5c8c7d-187a-44e6-8afb-81e854c39457}
//    Bad Format: (eb5c8c7d-187a-44e6-8afb-81e854c39457)
//    Bad Format: {0xeb5c8c7d,0x187a,0x44e6,{0x8a,0xfb,0x81,0xe8,0x54,0xc3,0x94,0x57}}

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
    try
        let newGuid = Guid.ParseExact(stringGuid, "B")
        printfn $"Successfully parsed {stringGuid}"
    with
    | :? ArgumentNullException ->
        printfn "The string to be parsed is null."
    | :? FormatException ->
        printfn $"Bad Format: {stringGuid}"

// The example displays output similar to the following:
//
//    Bad Format: eb5c8c7d187a44e68afb81e854c39457
//    Bad Format: eb5c8c7d-187a-44e6-8afb-81e854c39457
//    Successfully parsed {eb5c8c7d-187a-44e6-8afb-81e854c39457}
//    Bad Format: (eb5c8c7d-187a-44e6-8afb-81e854c39457)
//    Bad Format: {0xeb5c8c7d,0x187a,0x44e6,{0x8a,0xfb,0x81,0xe8,0x54,0xc3,0x94,0x57}}

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

      ' Parse the strings in the array using the "B" format specifier.
      For Each stringGuid In stringGuids
         Try
            Dim newGuid As Guid = Guid.ParseExact(stringGuid, "B")
            Console.WriteLine("Successfully parsed {0}", 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:
'    Bad Format: 3351d3f0006747089ff928b5179b2051
'    Bad Format: 3351d3f0-0067-4708-9ff9-28b5179b2051
'    Successfully parsed {3351d3f0-0067-4708-9ff9-28b5179b2051}
'    Bad Format: (3351d3f0-0067-4708-9ff9-28b5179b2051)
'    Bad Format: {0x3351d3f0,0x0067,0x4708,{0x9f,0xf9,0x28,0xb5,0x17,0x9b,0x20,0x51}}

注解

该方法 ParseExact 要求字符串在删除前导字符和尾随空格字符后，以完全按参数指定的 format 格式进行转换。 下表显示了参数的接受格式说明符 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}}

另请参阅

适用于