Guid Constructor (String)
Initializes a new instance of the Guid structure by using the value represented by the specified string.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- g
-
Type:
System.String
A string that contains a GUID in one of the following formats ("d" represents a hexadecimal digit whose case is ignored):
32 contiguous digits:
dddddddddddddddddddddddddddddddd
-or-
Groups of 8, 4, 4, 4, and 12 digits with hyphens between the groups. The entire GUID can optionally be enclosed in matching braces or parentheses:
dddddddd-dddd-dddd-dddd-dddddddddddd
-or-
{dddddddd-dddd-dddd-dddd-dddddddddddd}
-or-
(dddddddd-dddd-dddd-dddd-dddddddddddd)
-or-
Groups of 8, 4, and 4 digits, and a subset of eight groups of 2 digits, with each group prefixed by "0x" or "0X", and separated by commas. The entire GUID, as well as the subset, is enclosed in matching braces:
{0xdddddddd, 0xdddd, 0xdddd,{0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd}}
All braces, commas, and "0x" prefixes are required. All embedded spaces are ignored. All leading zeros in a group are ignored.
The digits shown in a group are the maximum number of meaningful digits that can appear in that group. You can specify from 1 to the number of digits shown for a group. The specified digits are assumed to be the low-order digits of the group.
| Exception | Condition |
|---|---|
| ArgumentNullException | g is null. |
| FormatException | The format of g is invalid. |
| OverflowException | The format of g is invalid. |
The alphabetic hexadecimal digits in the g parameter can be uppercase or lowercase. For example, the following strings represent the same GUID:
"ca761232ed4211cebacd00aa0057b223"
"CA761232-ED42-11CE-BACD-00AA0057B223"
"{CA761232-ED42-11CE-BACD-00AA0057B223}"
"(CA761232-ED42-11CE-BACD-00AA0057B223)"
"{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}"
The following example passes each string listed in the Remarks section to the Guid(String) constructor.
using System; public class Example { public static void Main() { string[] guidStrings = { "ca761232ed4211cebacd00aa0057b223", "CA761232-ED42-11CE-BACD-00AA0057B223", "{CA761232-ED42-11CE-BACD-00AA0057B223}", "(CA761232-ED42-11CE-BACD-00AA0057B223)", "{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}" }; foreach (var guidString in guidStrings) { Guid guid = new Guid(guidString); Console.WriteLine("Original string: {0}", guidString); Console.WriteLine("Guid: {0}", guid); Console.WriteLine(); } } } // The example displays the following output: // Original string: ca761232ed4211cebacd00aa0057b223 // Guid: ca761232-ed42-11ce-bacd-00aa0057b223 // // Original string: CA761232-ED42-11CE-BACD-00AA0057B223 // Guid: ca761232-ed42-11ce-bacd-00aa0057b223 // // Original string: {CA761232-ED42-11CE-BACD-00AA0057B223} // Guid: ca761232-ed42-11ce-bacd-00aa0057b223 // // Original string: (CA761232-ED42-11CE-BACD-00AA0057B223) // Guid: ca761232-ed42-11ce-bacd-00aa0057b223 // // Original string: {0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}} // Guid: ca761232-ed42-11ce-bacd-00aa0057b223
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1