Guid Constructor (String)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Initializes a new instance of the Guid class using the value represented by the specified string.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

Public Sub New ( _
    g As String _
)
public Guid(
    string g
)

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 zeroes 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.

Exceptions

Exception Condition
ArgumentNullException

g is nullNothingnullptra null reference (Nothing in Visual Basic).

FormatException

The format of g is invalid.

OverflowException

The format of g is invalid.

Exception

An internal type conversion error occurred.

Remarks

The alphabetic hexadecimal digits in the g parameter can be upper or lower case.

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}}"

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

Guid Structure

Guid Overload

System Namespace