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

 
equivalentCodeEntity

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

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 Long)

Parameters

element
Type: System.Xml.Linq.XElement

The XElement to cast to Nullable(Of T) of Int64.

Return Value

Type: System.Nullable(Of Int64)

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

Exception Condition
FormatException

The element does not contain a valid Int64 value.

The following example creates an element with long integer content. It then retrieves the value by casting to Nullable(Of T) of Int64.


                Dim root As XElement = _ 
        <Root>
            <Value>9223372036854775807</Value>
        </Root>
Dim value As Nullable(Of ULong) = CType(root.Element("Value"), Nullable(Of ULong))
Console.WriteLine("Nullable ulong: value={0}", IIf(value.HasValue, value.ToString(), "null"))

This example produces the following output:

Nullable ulong: value=9223372036854775807

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: