Guid::TryParse Method (String^, Guid%)
Converts the string representation of a GUID to the equivalent Guid structure.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- input
-
Type:
System::String^
The GUID to convert.
- result
-
Type:
System::Guid%
The structure that will contain the parsed value. If the method returns true, result contains a valid Guid. If the method returns false, result equals Guid::Empty.
This method is like the Parse method, except that instead of returning the parsed GUID, it returns false if input is null or not in a recognized format, and doesn't throw an exception. It trims any leading or trailing white space from input and converts strings in any of the five formats recognized by the ToString(String^) and ToString(String^, IFormatProvider^)methods, as shown in the following table.
Specifier | Description | Format |
|---|---|---|
N | 32 digits | 00000000000000000000000000000000 |
D | 32 digits separated by hyphens | 00000000-0000-0000-0000-000000000000 |
B | 32 digits separated by hyphens, enclosed in braces | {00000000-0000-0000-0000-000000000000} |
P | 32 digits separated by hyphens, enclosed in parentheses | (00000000-0000-0000-0000-000000000000) |
X | Four hexadecimal values enclosed in braces, where the fourth value is a subset of eight hexadecimal values that is also enclosed in braces | {0x00000000,0x0000,0x0000,{0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00}} |
The following example creates a new GUID, converts it to three separate string representations by calling the ToString(String^) method with the "B", "D", and "X" format specifiers, and then calls the TryParse method to convert the strings back to Guid values.
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 4.0
Windows Phone Silverlight
Available since 7.1
Windows Phone
Available since 8.1