XElement Narrowing Conversion (XElement to Nullable(Of DateTimeOffset))


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

equivalentCodeEntityop_Explicit(X Element element )

Cast the value of this XElement to a Nullable(Of T) of DateTimeOffset.

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 Nullable(Of DateTimeOffset)


Type: System.Xml.Linq.XElement

The XElement to cast to an Nullable(Of T) of DateTimeOffset.

Return Value

Type: System.Nullable(Of DateTimeOffset)

A Nullable(Of T) of DateTimeOffset that contains the content of this XElement.

Exception Condition

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(Of T) of DateTimeOffset to retrieve the value.

                Dim root As XElement = _
        <Child><%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %></Child>

Dim dt As Nullable(Of DateTimeOffset) = CType(root.<Child>(0), Nullable(Of DateTimeOffset))
Console.WriteLine("dt={0}", dt)

This example produces the following output:

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
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top