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

 
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.

equivalentCodeEntityop_Explicit(XAttribute attribute)

Cast the value of this XAttribute 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 (
	attribute As XAttribute
) As Nullable(Of DateTimeOffset)

Parameters

attribute
Type: System.Xml.Linq.XAttribute

The XAttribute to cast to a Nullable(Of T) of DateTimeOffset.

Return Value

Type: System.Nullable(Of DateTimeOffset)

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

Exception Condition
FormatException

The attribute does not contain a valid DateTimeOffset value.

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

The following example creates an attribute with a date and time as content. It then retrieves the value by casting to Nullable(Of T) of DateTimeOffset.


                Dim root As XElement = _
    <Root
        Att=<%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %>/>
Dim value As Nullable(Of DateTimeOffset) = CType(root.Attribute("Att"), Nullable(Of DateTimeOffset))
Console.WriteLine("Nullable DateTimeOffset: value={0}", IIf(value.HasValue, value.ToString(), "null"))

This example produces the following output:


Nullable DateTimeOffset: value=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: