XElement Narrowing Conversion (XElement to Guid)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

equivalentCodeEntity

Cast the value of this XElement to a Guid.

This API is not CLS-compliant.

Namespace:   System.Xml.Linq
Assembly:  System.Xml.Linq (in System.Xml.Linq.dll)

Public Shared Narrowing Operator CType (
	element As XElement
) As Guid

Parameters

element
Type: System.Xml.Linq.XElement

The XElement to cast to Guid.

Return Value

Type: System.Guid

A Guid that contains the content of this XElement.

Exception Condition
FormatException

The element does not contain a valid Guid value.

ArgumentNullException

The element parameter is null.

The following example creates an element with a guid as content. It then retrieves the value by casting to Guid.


                Dim root As XElement = <Root><%= New Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730") %></Root>
Dim value As Guid = CType(root, Guid)
Console.WriteLine("value={0}", value)

This example produces the following output:


value=3c1cc55b-baff-4b7a-9d17-077af3aa5730

Universal Windows Platform
Available since 8
.NET Framework
Available since 3.5
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
Return to top
Show: