• Article

XElement Explicit Conversion (XElement to Guid)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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)

Syntax

'Declaration
Public Shared Narrowing Operator CType ( _
    element As XElement _
) As Guid

public static explicit operator Guid (
    XElement element
)

Parameters

Return Value

Type: System.Guid
A Guid that contains the content of this XElement.

Exceptions

Exception Condition
FormatException

The element does not contain a valid Guid value.
ArgumentNullException

The element parameter is nulla null reference (Nothing in Visual Basic).

Examples

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

XElement root = new XElement("Root", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"));
Guid value = (Guid)root;

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.