Export (0) Print
Expand All

XElement Explicit Conversion (XElement to Nullable<Guid>)

Cast the value of this XElement to a Nullable<T> of Guid.

This API is not CLS-compliant. 

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

public static explicit operator Nullable<Guid> (
	XElement element
)

Parameters

element
Type: System.Xml.Linq.XElement

The XElement to cast to Nullable<T> of Guid.

Return Value

Type: System.Nullable<Guid>
A Nullable<T> of Guid that contains the content of this XElement.

ExceptionCondition
FormatException

The element does not contain a valid Guid value.

The following example creates an element with guid content. It then retrieves the value by casting to Nullable<T> of Guid.

XElement root = new XElement("Root",
    new XElement("Value", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"))
);
Guid? value = (Guid?)root.Element("Value");
Console.WriteLine("Nullable Guid: value={0}", value == null ? "null" : value.ToString());

This example produces the following output:

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft