XElement Explicit Conversion (XElement to Nullable<DateTimeOffset>)

 
equivalentCodeEntityop_Explicit(X Element element )

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

This API is not CLS-compliant.

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

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

Parameters

element
Type: System.Xml.Linq.XElement

The XElement to cast to an Nullable<T> of DateTimeOffset.

Return Value

Type: System.Nullable<DateTimeOffset>

A Nullable<T> of DateTimeOffset that contains the content of this XElement.

Exception Condition
FormatException

The element does not contain a valid DateTimeOffset value.

This conversion operator uses the XmlConvert class to do the conversion.

The following example creates an element with date and time content. It then casts to Nullable<T> of DateTimeOffset to retrieve the value.


                XElement root = new XElement("Root",
    new XElement("Child", new DateTimeOffset(new DateTime(2006, 10, 6, 12, 30, 0)))
);
Console.WriteLine(root);

DateTimeOffset? dt = (DateTimeOffset?)root.Element("Child");
Console.WriteLine("dt={0}", dt);

This example produces the following output:


                <Root>
  <Child>2006-10-06T12:30:00-07:00</Child>
</Root>
dt=10/6/2006 12:30:00 PM -07:00

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: