XElement.Explicit XElement.Explicit XElement.Explicit XElement.Explicit Operator

定義

オーバーロード

Explicit(XElement to Nullable<Int64>) Explicit(XElement to Nullable<Int64>) Explicit(XElement to Nullable<Int64>) Explicit(XElement to Nullable<Int64>)

この XElement の値を Int64Nullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Int64.

Explicit(XElement to Nullable<Single>) Explicit(XElement to Nullable<Single>) Explicit(XElement to Nullable<Single>) Explicit(XElement to Nullable<Single>)

この XElement の値を SingleNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Single.

Explicit(XElement to Nullable<TimeSpan>) Explicit(XElement to Nullable<TimeSpan>) Explicit(XElement to Nullable<TimeSpan>) Explicit(XElement to Nullable<TimeSpan>)

この XElement の値を TimeSpanNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of TimeSpan.

Explicit(XElement to Nullable<UInt32>) Explicit(XElement to Nullable<UInt32>) Explicit(XElement to Nullable<UInt32>) Explicit(XElement to Nullable<UInt32>)

この XElement の値を UInt32Nullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of UInt32.

Explicit(XElement to Nullable<UInt64>) Explicit(XElement to Nullable<UInt64>) Explicit(XElement to Nullable<UInt64>) Explicit(XElement to Nullable<UInt64>)

この XElement の値を UInt64Nullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of UInt64.

Explicit(XElement to UInt32) Explicit(XElement to UInt32) Explicit(XElement to UInt32) Explicit(XElement to UInt32)

この XElement の値を UInt32 にキャストします。Cast the value of this XElement to a UInt32.

Explicit(XElement to String) Explicit(XElement to String) Explicit(XElement to String) Explicit(XElement to String)

この XElement の値を String にキャストします。Cast the value of this XElement to a String.

Explicit(XElement to TimeSpan) Explicit(XElement to TimeSpan) Explicit(XElement to TimeSpan) Explicit(XElement to TimeSpan)

この XElement の値を TimeSpan にキャストします。Cast the value of this XElement to a TimeSpan.

Explicit(XElement to UInt64) Explicit(XElement to UInt64) Explicit(XElement to UInt64) Explicit(XElement to UInt64)

この XElement の値を UInt64 にキャストします。Cast the value of this XElement to a UInt64.

Explicit(XElement to Nullable<Int32>) Explicit(XElement to Nullable<Int32>) Explicit(XElement to Nullable<Int32>) Explicit(XElement to Nullable<Int32>)

この XElement の値を Int32Nullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Int32.

Explicit(XElement to Single) Explicit(XElement to Single) Explicit(XElement to Single) Explicit(XElement to Single)

この XElement の値を Single にキャストします。Cast the value of this XElement to a Single.

Explicit(XElement to Nullable<Guid>) Explicit(XElement to Nullable<Guid>) Explicit(XElement to Nullable<Guid>) Explicit(XElement to Nullable<Guid>)

この XElement の値を GuidNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Guid.

Explicit(XElement to Nullable<Boolean>) Explicit(XElement to Nullable<Boolean>) Explicit(XElement to Nullable<Boolean>) Explicit(XElement to Nullable<Boolean>)

この XElement の値を BooleanNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Boolean.

Explicit(XElement to Nullable<Decimal>) Explicit(XElement to Nullable<Decimal>) Explicit(XElement to Nullable<Decimal>) Explicit(XElement to Nullable<Decimal>)

この XElement の値を DecimalNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Decimal.

Explicit(XElement to Boolean) Explicit(XElement to Boolean) Explicit(XElement to Boolean) Explicit(XElement to Boolean)

この XElement の値を Boolean にキャストします。Cast the value of this XElement to a Boolean.

Explicit(XElement to DateTime) Explicit(XElement to DateTime) Explicit(XElement to DateTime) Explicit(XElement to DateTime)

この XElement の値を DateTime にキャストします。Cast the value of this XElement to a DateTime.

Explicit(XElement to DateTimeOffset) Explicit(XElement to DateTimeOffset) Explicit(XElement to DateTimeOffset) Explicit(XElement to DateTimeOffset)

この XAttribute の値を DateTimeOffset にキャストします。Cast the value of this XAttribute to a DateTimeOffset.

Explicit(XElement to Double) Explicit(XElement to Double) Explicit(XElement to Double) Explicit(XElement to Double)

この XElement の値を Double にキャストします。Cast the value of this XElement to a Double.

Explicit(XElement to Guid) Explicit(XElement to Guid) Explicit(XElement to Guid) Explicit(XElement to Guid)

この XElement の値を Guid にキャストします。Cast the value of this XElement to a Guid.

Explicit(XElement to Decimal) Explicit(XElement to Decimal) Explicit(XElement to Decimal) Explicit(XElement to Decimal)

この XElement の値を Decimal にキャストします。Cast the value of this XElement to a Decimal.

Explicit(XElement to Int64) Explicit(XElement to Int64) Explicit(XElement to Int64) Explicit(XElement to Int64)

この XElement の値を Int64 にキャストします。Cast the value of this XElement to an Int64.

Explicit(XElement to Nullable<Double>) Explicit(XElement to Nullable<Double>) Explicit(XElement to Nullable<Double>) Explicit(XElement to Nullable<Double>)

この XElement の値を DoubleNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Double.

Explicit(XElement to Nullable<DateTime>) Explicit(XElement to Nullable<DateTime>) Explicit(XElement to Nullable<DateTime>) Explicit(XElement to Nullable<DateTime>)

この XElement の値を DateTimeNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of DateTime.

Explicit(XElement to Nullable<DateTimeOffset>) Explicit(XElement to Nullable<DateTimeOffset>) Explicit(XElement to Nullable<DateTimeOffset>) Explicit(XElement to Nullable<DateTimeOffset>)

この XElement の値を DateTimeOffsetNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of DateTimeOffset.

Explicit(XElement to Int32) Explicit(XElement to Int32) Explicit(XElement to Int32) Explicit(XElement to Int32)

この XElement の値を Int32 にキャストします。Cast the value of this XElement to an Int32.

Explicit(XElement to Nullable<Int64>) Explicit(XElement to Nullable<Int64>) Explicit(XElement to Nullable<Int64>) Explicit(XElement to Nullable<Int64>)

重要

この API は CLS 準拠ではありません。

この XElement の値を Int64Nullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Int64.

public:
 static explicit operator Nullable<long>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<long> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<int64>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Long)

パラメーター

element
XElement XElement XElement XElement

Int64Nullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of Int64.

戻り値

この XElement の内容を格納している Int64Nullable<T>A Nullable<T> of Int64 that contains the content of this XElement.

例外

要素が null ではなく、有効な Int64 値を含んでいません。The element is not null and does not contain a valid Int64 value.

次の例では、長い整数のコンテンツを含む要素を作成します。The following example creates an element with long integer content. 次に、のNullable<T> Int64にキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of Int64.

XElement root = new XElement("Root",    
    new XElement("Value", 9223372036854775807)  
);  
ulong? value = (ulong?)root.Element("Value");  
Console.WriteLine("Nullable ulong: value={0}", value == null ? "null" : value.ToString());  
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  
こちらもご覧ください

Explicit(XElement to Nullable<Single>) Explicit(XElement to Nullable<Single>) Explicit(XElement to Nullable<Single>) Explicit(XElement to Nullable<Single>)

重要

この API は CLS 準拠ではありません。

この XElement の値を SingleNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Single.

public:
 static explicit operator Nullable<float>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<float> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<single>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Single)

パラメーター

element
XElement XElement XElement XElement

SingleNullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of Single.

戻り値

この XElement の内容を格納している SingleNullable<T>A Nullable<T> of Single that contains the content of this XElement.

例外

要素が null ではなく、有効な Single 値を含んでいません。The element is not null and does not contain a valid Single value.

次の例では、単精度浮動小数点のコンテンツを持つ要素を作成します。The following example creates an element with single precision floating point content. 次に、のNullable<T> Singleにキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of Single.

XElement root = new XElement("Root",   
    new XElement("Value", 3.402823e38)  
);  
float? value = (float?)root.Element("Value");  
Console.WriteLine("Nullable Single: value={0}", value == null ? "null" : value.ToString());  
Dim root As XElement = _   
        <Root>  
            <Value>3.402823e38</Value>  
        </Root>  
Dim value As Nullable(Of Single) = CType(root.Element("Value"), Nullable(Of Single))  
Console.WriteLine("Nullable Single: value={0}", IIf(value.HasValue, value.ToString(), "null"))  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Nullable Single: value=3.402823E+38  
こちらもご覧ください

Explicit(XElement to Nullable<TimeSpan>) Explicit(XElement to Nullable<TimeSpan>) Explicit(XElement to Nullable<TimeSpan>) Explicit(XElement to Nullable<TimeSpan>)

重要

この API は CLS 準拠ではありません。

この XElement の値を TimeSpanNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of TimeSpan.

public:
 static explicit operator Nullable<TimeSpan>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<TimeSpan> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<TimeSpan>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of TimeSpan)

パラメーター

element
XElement XElement XElement XElement

TimeSpanNullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of TimeSpan.

戻り値

この XElement の内容を格納している TimeSpanNullable<T>A Nullable<T> of TimeSpan that contains the content of this XElement.

例外

要素が null ではなく、有効な TimeSpan 値を含んでいません。The element is not null and does not contain a valid TimeSpan value.

次の例では、タイムスパンコンテンツを持つ要素を作成します。The following example creates an element with time span content. 次に、のNullable<T> TimeSpanにキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of TimeSpan.

XElement root = new XElement("Root",  
    new XElement("Value", new TimeSpan(1, 5, 30))  
);  
TimeSpan? value = (TimeSpan?)root.Element("Value");  
Console.WriteLine("Nullable TimeSpan: value={0}", value == null ? "null" : value.ToString());  
Dim root As XElement = _  
    <Root>  
        <Value><%= New TimeSpan(1, 5, 30) %></Value>  
    </Root>  
Dim value As Nullable(Of TimeSpan) = CType(root.Element("Value"), Nullable(Of TimeSpan))  
Console.WriteLine("Nullable TimeSpan: value={0}", IIf(value.HasValue, value.ToString(), "null"))  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Nullable TimeSpan: value=01:05:30  

注釈

タイムスパンコンテンツを格納する属性または要素の値空間は、ISO 8601 で説明されているように、duration コンテンツと密接に関連しています。The value space of an attribute or element that contains time span content is closely related to duration content as described in ISO 8601. 期間のコンテンツを含む属性または要素を作成する場合、属性または要素の値は W3C 仕様に従って書式設定されます。When creating an attribute or element that contains time span content, the attribute or element values are formatted per the W3C specification. 詳細については、W3C の仕様を参照してください。Please see the W3C specification for more details.

属性または要素からのNullable<T> TimeSpanにキャストする場合、動作は厳密ではありません。Behavior is lax when casting to a Nullable<T> of TimeSpan from an attribute or element. 属性または要素の値が W3C 仕様に従って正確に書式設定されていない場合でNullable<T>TimeSpan、値はのに適切に変換されます。Even if the attribute or element value is not formatted exactly per the W3C specification, the value is appropriately converted to a Nullable<T> of TimeSpan.

こちらもご覧ください

Explicit(XElement to Nullable<UInt32>) Explicit(XElement to Nullable<UInt32>) Explicit(XElement to Nullable<UInt32>) Explicit(XElement to Nullable<UInt32>)

重要

この API は CLS 準拠ではありません。

この XElement の値を UInt32Nullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of UInt32.

public:
 static explicit operator Nullable<System::UInt32>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<uint> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<uint32>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of UInteger)

パラメーター

element
XElement XElement XElement XElement

UInt32Nullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of UInt32.

戻り値

この XElement の内容を格納している UInt32Nullable<T>A Nullable<T> of UInt32 that contains the content of this XElement.

例外

要素が null ではなく、有効な UInt32 値を含んでいません。The element is not null and does not contain a valid UInt32 value.

次の例では、符号なし整数コンテンツを含む要素を作成します。The following example creates an element with unsigned integer content. 次に、のNullable<T> UInt32にキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of UInt32.

XElement root = new XElement("Root",   
    new XElement("Value", 4294967295)  
);  
uint? value = (uint?)root.Element("Value");  
Console.WriteLine("Nullable uint: value={0}", value == null ? "null" : value.ToString());  
Dim root As XElement = _   
        <Root>  
            <Value>4294967295</Value>  
        </Root>  
Dim value As Nullable(Of UInteger) = CType(root.Element("Value"), Nullable(Of UInteger))  
Console.WriteLine("Nullable uint: value={0}", IIf(value.HasValue, value.ToString(), "null"))  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Nullable uint: value=4294967295  
こちらもご覧ください

Explicit(XElement to Nullable<UInt64>) Explicit(XElement to Nullable<UInt64>) Explicit(XElement to Nullable<UInt64>) Explicit(XElement to Nullable<UInt64>)

重要

この API は CLS 準拠ではありません。

この XElement の値を UInt64Nullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of UInt64.

public:
 static explicit operator Nullable<System::UInt64>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<ulong> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<uint64>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of ULong)

パラメーター

element
XElement XElement XElement XElement

UInt64Nullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of UInt64.

戻り値

この XElement の内容を格納している UInt64Nullable<T>A Nullable<T> of UInt64 that contains the content of this XElement.

例外

要素が null ではなく、有効な UInt64 値を含んでいません。The element is not null and does not contain a valid UInt64 value.

次の例では、符号なし長整数のコンテンツを含む要素を作成します。The following example creates an element with unsigned long integer content. 次に、のNullable<T> UInt64にキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of UInt64.

XElement root = new XElement("Root",   
    new XElement("Value", 9223372036854775807)  
);  
ulong? value = (ulong?)root.Element("Value");  
Console.WriteLine("Nullable ulong: value={0}", value == null ? "null" : value.ToString());  
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  
こちらもご覧ください

Explicit(XElement to UInt32) Explicit(XElement to UInt32) Explicit(XElement to UInt32) Explicit(XElement to UInt32)

重要

この API は CLS 準拠ではありません。

この XElement の値を UInt32 にキャストします。Cast the value of this XElement to a UInt32.

public:
 static explicit operator System::UInt32(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator uint (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> uint32
Public Shared Narrowing Operator CType (element As XElement) As UInteger

パラメーター

element
XElement XElement XElement XElement

UInt32 にキャストする XElementThe XElement to cast to UInt32.

戻り値

この XElement の内容を格納している UInt32A UInt32 that contains the content of this XElement.

例外

要素が、有効な UInt32 値を格納していません。The element does not contain a valid UInt32 value.

element パラメーターが null です。The element parameter is null.

次の例では、符号なし整数コンテンツを含む要素を作成します。The following example creates an element with unsigned integer content. 次に、にUInt32キャストして値を取得します。It then retrieves the value by casting to UInt32.

XElement root = new XElement("Root", 4294967295);  
uint value = (uint)root;  
Console.WriteLine("value={0}", value);  
Dim root As XElement = <Root>4294967295</Root>  
Dim value As UInteger = CUInt(root)  
Console.WriteLine("value={0}", value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

value=4294967295  
こちらもご覧ください

Explicit(XElement to String) Explicit(XElement to String) Explicit(XElement to String) Explicit(XElement to String)

重要

この API は CLS 準拠ではありません。

この XElement の値を String にキャストします。Cast the value of this XElement to a String.

public:
 static explicit operator System::String ^(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator string (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> string
Public Shared Narrowing Operator CType (element As XElement) As String

パラメーター

element
XElement XElement XElement XElement

String にキャストする XElementThe XElement to cast to String.

戻り値

この XElement の内容を格納している StringA String that contains the content of this XElement.

次の例では、文字列コンテンツを含む要素を作成します。The following example creates an element with string content. 次に、にStringキャストして値を取得します。It then retrieves the value by casting to String.

XElement root = XElement.Parse("<Root>abc <b>def </b>ghi</Root>");  
Console.WriteLine("(string)root={0}", (string)root);  
Dim root As XElement = <Root>abc <b>def </b>ghi</Root>  
Console.WriteLine("(string)root={0}", root.Value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

(string)root=abc def ghi  

注釈

XElement子がある場合は、すべての要素のテキストと子孫のテキストの連結された文字列値が返されます。If the XElement has children, the concatenated string value of all of the element's text and descendant's text is returned.

こちらもご覧ください

Explicit(XElement to TimeSpan) Explicit(XElement to TimeSpan) Explicit(XElement to TimeSpan) Explicit(XElement to TimeSpan)

重要

この API は CLS 準拠ではありません。

この XElement の値を TimeSpan にキャストします。Cast the value of this XElement to a TimeSpan.

public:
 static explicit operator TimeSpan(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator TimeSpan (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> TimeSpan
Public Shared Narrowing Operator CType (element As XElement) As TimeSpan

パラメーター

element
XElement XElement XElement XElement

TimeSpan にキャストする XElementThe XElement to cast to TimeSpan.

戻り値

この XElement の内容を格納している TimeSpanA TimeSpan that contains the content of this XElement.

例外

要素が、有効な TimeSpan 値を格納していません。The element does not contain a valid TimeSpan value.

element パラメーターが null です。The element parameter is null.

次の例では、タイムスパンコンテンツを持つ要素を作成します。The following example creates an element with time span content. 次に、にTimeSpanキャストして値を取得します。It then retrieves the value by casting to TimeSpan.

XElement root = new XElement("Root", new TimeSpan(1, 5, 30));  
TimeSpan value = (TimeSpan)root;  
Console.WriteLine("value={0}", value);  
Dim root As XElement = <Root><%= New TimeSpan(1, 5, 30) %></Root>  
Dim value As TimeSpan = CType(root, TimeSpan)  
Console.WriteLine("value={0}", value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

value=01:05:30  

注釈

タイムスパンコンテンツを格納する属性または要素の値空間は、ISO 8601 で説明されているように、duration コンテンツと密接に関連しています。The value space of an attribute or element that contains time span content is closely related to duration content as described in ISO 8601. 期間のコンテンツを含む属性または要素を作成する場合、属性または要素の値は W3C 仕様に従って書式設定されます。When creating an attribute or element that contains time span content, the attribute or element values are formatted per the W3C specification. 詳細については、W3C の仕様を参照してください。Please see the W3C specification for more details.

属性または要素からにキャストTimeSpanする場合、動作は厳密ではありません。Behavior is lax when casting to a TimeSpan from an attribute or element. 属性または要素の値が W3C 仕様に従って正確に書式設定されていない場合でTimeSpanも、値はに適切に変換されます。Even if the attribute or element value is not formatted exactly per the W3C specification, the value is appropriately converted to a TimeSpan.

こちらもご覧ください

Explicit(XElement to UInt64) Explicit(XElement to UInt64) Explicit(XElement to UInt64) Explicit(XElement to UInt64)

重要

この API は CLS 準拠ではありません。

この XElement の値を UInt64 にキャストします。Cast the value of this XElement to a UInt64.

public:
 static explicit operator System::UInt64(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator ulong (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> uint64
Public Shared Narrowing Operator CType (element As XElement) As ULong

パラメーター

element
XElement XElement XElement XElement

UInt64 にキャストする XElementThe XElement to cast to UInt64.

戻り値

この XElement の内容を格納している UInt64A UInt64 that contains the content of this XElement.

例外

要素が、有効な UInt64 値を格納していません。The element does not contain a valid UInt64 value.

element パラメーターが null です。The element parameter is null.

次の例では、符号なし長整数のコンテンツを含む要素を作成します。The following example creates an element with unsigned long integer content. 次に、にUInt64キャストして値を取得します。It then retrieves the value by casting to UInt64.

XElement root = new XElement("Root", 18446744073709551615);  
ulong value = (ulong)root;  
Console.WriteLine("value={0}", value);  
Dim root As XElement = <Root>18446744073709551615</Root>  
Dim value As ULong = CULng(root)  
Console.WriteLine("value={0}", value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

value=18446744073709551615  
こちらもご覧ください

Explicit(XElement to Nullable<Int32>) Explicit(XElement to Nullable<Int32>) Explicit(XElement to Nullable<Int32>) Explicit(XElement to Nullable<Int32>)

重要

この API は CLS 準拠ではありません。

この XElement の値を Int32Nullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Int32.

public:
 static explicit operator Nullable<int>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<int> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<int>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Integer)

パラメーター

element
XElement XElement XElement XElement

Int32Nullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of Int32.

戻り値

この XElement の内容を格納している Int32Nullable<T>A Nullable<T> of Int32 that contains the content of this XElement.

例外

要素が null ではなく、有効な Int32 値を含んでいません。The element is not null and does not contain a valid Int32 value.

次の例では、符号なし整数コンテンツを含む要素を作成します。The following example creates an element with unsigned integer content. 次に、のNullable<T> Int32にキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of Int32.

XElement root = new XElement("Root",   
    new XElement("Value", 2147483647)  
);  
int? value = (int?)root.Element("Value");  
Console.WriteLine("Nullable integer: value={0}", value == null ? "null" : value.ToString());  
Dim root As XElement = _   
        <Root>  
            <Value>2147483647</Value>  
        </Root>  
Dim value As Nullable(Of Integer) = CType(root.Element("Value"), Nullable(Of Integer))  
Console.WriteLine("Nullable integer: value={0}", IIf(value.HasValue, value.ToString(), "null"))  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Nullable integer: value=2147483647  
こちらもご覧ください

Explicit(XElement to Single) Explicit(XElement to Single) Explicit(XElement to Single) Explicit(XElement to Single)

重要

この API は CLS 準拠ではありません。

この XElement の値を Single にキャストします。Cast the value of this XElement to a Single.

public:
 static explicit operator float(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator float (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> single
Public Shared Narrowing Operator CType (element As XElement) As Single

パラメーター

element
XElement XElement XElement XElement

Single にキャストする XElementThe XElement to cast to Single.

戻り値

この XElement の内容を格納している SingleA Single that contains the content of this XElement.

例外

要素が、有効な Single 値を格納していません。The element does not contain a valid Single value.

element パラメーターが null です。The element parameter is null.

次の例では、単精度浮動小数点のコンテンツを持つ要素を作成します。The following example creates an element with single precision floating point content. 次に、にSingleキャストして値を取得します。It then retrieves the value by casting to Single.

XElement root = new XElement("Root", 3.402823e38);  
float value = (float)root;  
Console.WriteLine("value={0}", value);  
Dim root As XElement = <Root>3.402823E+38</Root>  
Dim value As Single = CSng(root)  
Console.WriteLine("value={0}", value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

value=3.402823E+38  
こちらもご覧ください

Explicit(XElement to Nullable<Guid>) Explicit(XElement to Nullable<Guid>) Explicit(XElement to Nullable<Guid>) Explicit(XElement to Nullable<Guid>)

重要

この API は CLS 準拠ではありません。

この XElement の値を GuidNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Guid.

public:
 static explicit operator Nullable<Guid>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<Guid> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<Guid>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Guid)

パラメーター

element
XElement XElement XElement XElement

GuidNullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of Guid.

戻り値

この XElement の内容を格納している GuidNullable<T>A Nullable<T> of Guid that contains the content of this XElement.

例外

要素が null ではなく、有効な Guid 値を含んでいません。The element is not null and does not contain a valid Guid value.

次の例では、guid コンテンツを含む要素を作成します。The following example creates an element with guid content. 次に、のNullable<T> Guidにキャストして値を取得します。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());  
Dim root As XElement = _   
    <Root>  
        <Value><%= New Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730") %></Value>  
    </Root>  
Dim value As Nullable(Of Guid) = CType(root.Element("Value"), Nullable(Of Guid))  
Console.WriteLine("Nullable Guid: value={0}", IIf(value.HasValue, value.ToString(), "null"))  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Nullable Guid: value=3c1cc55b-baff-4b7a-9d17-077af3aa5730  
こちらもご覧ください

Explicit(XElement to Nullable<Boolean>) Explicit(XElement to Nullable<Boolean>) Explicit(XElement to Nullable<Boolean>) Explicit(XElement to Nullable<Boolean>)

重要

この API は CLS 準拠ではありません。

この XElement の値を BooleanNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Boolean.

public:
 static explicit operator Nullable<bool>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<bool> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<bool>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Boolean)

パラメーター

element
XElement XElement XElement XElement

BooleanNullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of Boolean.

戻り値

この XElement の内容を格納している BooleanNullable<T>A Nullable<T> of Boolean that contains the content of this XElement.

例外

要素が null ではなく、有効な Boolean 値を含んでいません。The element is not null and does not contain a valid Boolean value.

次の例では、ブール型のコンテンツを含む要素を作成します。The following example creates an element with boolean content. 次に、のNullable<T> Booleanにキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of Boolean.

XElement root = new XElement("Root",   
    new XElement("BoolValue1", true),  
    new XElement("BoolValue2", false));  
bool? bool1 = (bool?)root.Element("BoolValue1");  
bool? bool2 = (bool?)root.Element("BoolValue2");  
Console.WriteLine("Nullable Boolean: value1={0}", bool1);  
Console.WriteLine("Nullable Boolean: value2={0}", bool2);  
Dim root As XElement = _   
        <Root>  
            <BoolValue1>true</BoolValue1>  
            <BoolValue2>false</BoolValue2>  
        </Root>  

Dim value1 As Nullable(Of Boolean) = CType(root.Element("BoolValue1"), Nullable(Of Boolean))  
Dim value2 As Nullable(Of Boolean) = CType(root.Element("BoolValue2"), Nullable(Of Boolean))  
Console.WriteLine("Nullable Boolean: value1={0}", IIf(value1.HasValue, value1.ToString(), "null"))  
Console.WriteLine("Nullable Boolean: value2={0}", IIf(value2.HasValue, value2.ToString(), "null"))  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Nullable Boolean: value1=True  
Nullable Boolean: value2=False  

注釈

属性またはNullable<T>要素Booleanからのへの変換では、使用可能な値は "0"、"1"、および "true" または "false" を生成する任意の文字列 (トリミング後に小文字に変換した後) です。When converting to Nullable<T> of Boolean from an attribute or element, allowed values are "0", "1", and any string that produces "true" or "false" after trimming and conversion to lower case.

こちらもご覧ください

Explicit(XElement to Nullable<Decimal>) Explicit(XElement to Nullable<Decimal>) Explicit(XElement to Nullable<Decimal>) Explicit(XElement to Nullable<Decimal>)

重要

この API は CLS 準拠ではありません。

この XElement の値を DecimalNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Decimal.

public:
 static explicit operator Nullable<System::Decimal>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<decimal> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<decimal>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Decimal)

パラメーター

element
XElement XElement XElement XElement

DecimalNullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of Decimal.

戻り値

この XElement の内容を格納している DecimalNullable<T>A Nullable<T> of Decimal that contains the content of this XElement.

例外

要素が null ではなく、有効な Decimal 値を含んでいません。The element is not null and does not contain a valid Decimal value.

次の例では、10進数のコンテンツを含む要素を作成します。The following example creates an element with decimal content. 次に、のNullable<T> Decimalにキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of Decimal.

XElement root = new XElement("Root",  
    new XElement("Value", "79228162514264337593543950335")  
);  
decimal? value = (decimal?)root.Element("Value");  
Console.WriteLine("Nullable decimal: value={0}", value == null ? "null" : value.ToString());  
Dim root As XElement = _   
    <Root>  
        <Value>79228162514264337593543950335</Value>  
    </Root>  
Dim value As Nullable(Of Decimal) = CType(root.Element("Value"), Nullable(Of Decimal))  
Console.WriteLine("Nullable decimal: value={0}", IIf(value.HasValue, value.ToString(), "null"))  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Nullable decimal: value=79228162514264337593543950335  
こちらもご覧ください

Explicit(XElement to Boolean) Explicit(XElement to Boolean) Explicit(XElement to Boolean) Explicit(XElement to Boolean)

重要

この API は CLS 準拠ではありません。

この XElement の値を Boolean にキャストします。Cast the value of this XElement to a Boolean.

public:
 static explicit operator bool(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator bool (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> bool
Public Shared Narrowing Operator CType (element As XElement) As Boolean

パラメーター

element
XElement XElement XElement XElement

Boolean にキャストする XElementThe XElement to cast to Boolean.

戻り値

この XElement の内容を格納している BooleanA Boolean that contains the content of this XElement.

例外

要素が、有効な Boolean 値を格納していません。The element does not contain a valid Boolean value.

element パラメーターが null です。The element parameter is null.

次の例では、ブール値を持つ要素をいくつか作成します。The following example creates some elements with boolean values. 次に、それをBooleanにキャストします。It then casts them to Boolean.

XElement root = new XElement("Root",   
    new XElement("BoolValue1", true),  
    new XElement("BoolValue2", false)  
);  
bool bool1 = (bool)root.Element("BoolValue1");  
bool bool2 = (bool)root.Element("BoolValue2");  
Console.WriteLine("(bool)BoolValue1={0}", bool1);  
Console.WriteLine("(bool)BoolValue2={0}", bool2);  
Dim root As XElement = _   
        <Root>  
            <BoolValue1>true</BoolValue1>  
            <BoolValue2>false</BoolValue2>  
        </Root>  
Dim bool1 As Boolean = CBool(root.Element("BoolValue1"))  
Dim bool2 As Boolean = CBool(root.Element("BoolValue2"))  
Console.WriteLine("(bool)BoolValue1={0}", bool1)  
Console.WriteLine("(bool)BoolValue2={0}", bool2)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

(bool)BoolValue1=True  
(bool)BoolValue2=False  

注釈

属性またはBoolean要素からへの変換では、使用可能な値は "0"、"1"、および "true" または "false" を生成する任意の文字列 (トリミング後に小文字に変換した後) です。When converting to Boolean from an attribute or element, allowed values are "0", "1", and any string that produces "true" or "false" after trimming and conversion to lower case.

こちらもご覧ください

Explicit(XElement to DateTime) Explicit(XElement to DateTime) Explicit(XElement to DateTime) Explicit(XElement to DateTime)

重要

この API は CLS 準拠ではありません。

この XElement の値を DateTime にキャストします。Cast the value of this XElement to a DateTime.

public:
 static explicit operator DateTime(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator DateTime (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> DateTime
Public Shared Narrowing Operator CType (element As XElement) As DateTime

パラメーター

element
XElement XElement XElement XElement

DateTime にキャストする XElementThe XElement to cast to DateTime.

戻り値

この XElement の内容を格納している DateTimeA DateTime that contains the content of this XElement.

例外

要素が、有効な DateTime 値を格納していません。The element does not contain a valid DateTime value.

element パラメーターが null です。The element parameter is null.

次の例では、日付と時刻の内容を含む要素を作成します。The following example creates an element with date and time content. 次に、それをDateTimeにキャストして値を取得します。It then casts it to DateTime to retrieve the value.

// Behavior is strict when formatting an XML element or attribute from a DateTime,  
// but behavior is lax when casting to a DateTime from an element or attribute.  
XElement root = new XElement("Root", new DateTime(2006, 10, 6, 12, 30, 0));  
Console.WriteLine(root);  

// Cast from a strictly formatted XML element.  
DateTime dt = (DateTime)root;  
Console.WriteLine("dt={0}", dt);  
Console.WriteLine("-----");  

// If root is formatted in some different way:  
XElement dtElement = new XElement("OrderDate", "October 6, 2006");  
Console.WriteLine(dtElement);  
DateTime orderDate = (DateTime)dtElement;  
Console.WriteLine("orderDate={0:d}", orderDate);  
' Behavior is strict when formatting an XML element or attribute from a DateTime,  
' but behavior is lax when casting to a DateTime from an element or attribute.  
Dim root As XElement = <Root><%= New DateTime(2006, 10, 6, 12, 30, 0) %></Root>  
Console.WriteLine(root)  

' Cast from a strictly formatted XML element.  
Dim dt As DateTime = CType(root, DateTime)  
Console.WriteLine("dt={0}", dt)  
Console.WriteLine("-----")  

' If root is formatted in some different way:  
Dim dtElement As XElement = <OrderDate>October 6, 2006</OrderDate>  
Console.WriteLine(dtElement)  
Dim orderDate As DateTime = CType(dtElement, DateTime)  
Console.WriteLine("orderDate={0:d}", orderDate)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

<Root>2006-10-06T12:30:00</Root>  
dt=10/6/2006 12:30:00 PM  
-----  
<OrderDate>October 6, 2006</OrderDate>  
orderDate=10/6/2006  

注釈

日付と時刻の内容を含む属性または要素の値空間は、ISO 8601 で説明されている日付と時刻に密接に関連しています。The value space of an attribute or element that contains date and time content is closely related to the dates and times described in ISO 8601. 日付と時刻の内容を含む属性または要素を作成する場合、属性または要素の値は W3C 仕様に従って書式設定されます。When creating an attribute or element that contains date and time content, the attribute or element values are formatted per the W3C specification. 詳細については、W3C の仕様を参照してください。See the W3C specification for more details.

属性または要素からにキャストDateTimeする場合、動作は厳密ではありません。Behavior is lax when casting to a DateTime from an attribute or element. 属性または要素の値が W3C 仕様に従って正確に書式設定されていない場合でDateTimeも、値はに適切に変換されます。Even if the attribute or element value is not formatted exactly per the W3C specification, the value is appropriately converted to a DateTime.

この変換演算子はCultureInfo.InvariantCultureDateTimeを使用してから変換します。This conversion operator uses CultureInfo.InvariantCulture to convert from a DateTime.

こちらもご覧ください

Explicit(XElement to DateTimeOffset) Explicit(XElement to DateTimeOffset) Explicit(XElement to DateTimeOffset) Explicit(XElement to DateTimeOffset)

重要

この API は CLS 準拠ではありません。

この XAttribute の値を DateTimeOffset にキャストします。Cast the value of this XAttribute to a DateTimeOffset.

public:
 static explicit operator DateTimeOffset(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator DateTimeOffset (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> DateTimeOffset
Public Shared Narrowing Operator CType (element As XElement) As DateTimeOffset

パラメーター

element
XElement XElement XElement XElement

DateTimeOffset にキャストする XElementThe XElement to cast to DateTimeOffset.

戻り値

この XElement の内容を格納している DateTimeOffsetA DateTimeOffset that contains the content of this XElement.

例外

要素が、有効な DateTimeOffset 値を格納していません。The element does not contain a valid DateTimeOffset value.

element パラメーターが null です。The element parameter is null.

次の例では、日付と時刻の内容を含む要素を作成します。The following example creates an element with date and time content. 次に、をDateTimeOffsetにキャストして値を取得します。It then casts to 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);  
Dim root As XElement = _  
    <Root>  
        <Child><%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %></Child>  
    </Root>  
Console.WriteLine(root)  

Dim dt As DateTimeOffset = CType(root.<Child>(0), DateTimeOffset)  
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  

注釈

この変換演算子は、 XmlConvertクラスを使用して変換を実行します。This conversion operator uses the XmlConvert class to do the conversion.

こちらもご覧ください

Explicit(XElement to Double) Explicit(XElement to Double) Explicit(XElement to Double) Explicit(XElement to Double)

重要

この API は CLS 準拠ではありません。

この XElement の値を Double にキャストします。Cast the value of this XElement to a Double.

public:
 static explicit operator double(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator double (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> double
Public Shared Narrowing Operator CType (element As XElement) As Double

パラメーター

element
XElement XElement XElement XElement

Double にキャストする XElementThe XElement to cast to Double.

戻り値

この XElement の内容を格納している DoubleA Double that contains the content of this XElement.

例外

要素が、有効な Double 値を格納していません。The element does not contain a valid Double value.

element パラメーターが null です。The element parameter is null.

次の例では、コンテンツdoubleを含む属性を作成します。The following example creates an attribute with double content. 次に、にDoubleキャストして値を取得します。It then retrieves the value by casting to Double.

XElement root = new XElement("Root", 1.79769313486231e308);  
double value = (double)root;  
Console.WriteLine("value={0}", value);  
Dim root As XElement = <Root>1.79769313486231E+308</Root>  
Dim value As Double = CDbl(root)  
Console.WriteLine("value={0}", value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

value=1.79769313486231E+308  
こちらもご覧ください

Explicit(XElement to Guid) Explicit(XElement to Guid) Explicit(XElement to Guid) Explicit(XElement to Guid)

重要

この API は CLS 準拠ではありません。

この XElement の値を Guid にキャストします。Cast the value of this XElement to a Guid.

public:
 static explicit operator Guid(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Guid (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Guid
Public Shared Narrowing Operator CType (element As XElement) As Guid

パラメーター

element
XElement XElement XElement XElement

Guid にキャストする XElementThe XElement to cast to Guid.

戻り値

この XElement の内容を格納している GuidA Guid that contains the content of this XElement.

例外

要素が、有効な Guid 値を格納していません。The element does not contain a valid Guid value.

element パラメーターが null です。The element parameter is null.

次の例では、guid をコンテンツとして持つ要素を作成します。The following example creates an element with a guid as content. 次に、にGuidキャストして値を取得します。It then retrieves the value by casting to Guid.

XElement root = new XElement("Root", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"));  
Guid value = (Guid)root;  
Console.WriteLine("value={0}", value);  
Dim root As XElement = <Root><%= New Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730") %></Root>  
Dim value As Guid = CType(root, Guid)  
Console.WriteLine("value={0}", value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

value=3c1cc55b-baff-4b7a-9d17-077af3aa5730  
こちらもご覧ください

Explicit(XElement to Decimal) Explicit(XElement to Decimal) Explicit(XElement to Decimal) Explicit(XElement to Decimal)

重要

この API は CLS 準拠ではありません。

この XElement の値を Decimal にキャストします。Cast the value of this XElement to a Decimal.

public:
 static explicit operator System::Decimal(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator decimal (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> decimal
Public Shared Narrowing Operator CType (element As XElement) As Decimal

パラメーター

element
XElement XElement XElement XElement

Decimal にキャストする XElementThe XElement to cast to Decimal.

戻り値

この XElement の内容を格納している DecimalA Decimal that contains the content of this XElement.

例外

要素が、有効な Decimal 値を格納していません。The element does not contain a valid Decimal value.

element パラメーターが null です。The element parameter is null.

次の例では、10進数の値を持つ要素を作成します。The following example creates an element with a decimal value. 次に、にDecimalキャストして、属性の値を取得します。It then retrieves the value of the attribute by casting to Decimal.

XElement root = new XElement("Root", "79228162514264337593543950335");  
decimal value = (decimal)root;  
Console.WriteLine("value={0}", value);  
Dim root As XElement = <Root>79228162514264337593543950335</Root>  
Dim value As Decimal = CDec(root)  
Console.WriteLine("value={0}", value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

value=79228162514264337593543950335  
こちらもご覧ください

Explicit(XElement to Int64) Explicit(XElement to Int64) Explicit(XElement to Int64) Explicit(XElement to Int64)

重要

この API は CLS 準拠ではありません。

この XElement の値を Int64 にキャストします。Cast the value of this XElement to an Int64.

public:
 static explicit operator long(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator long (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> int64
Public Shared Narrowing Operator CType (element As XElement) As Long

パラメーター

element
XElement XElement XElement XElement

Int64 にキャストする XElementThe XElement to cast to Int64.

戻り値

この XElement の内容を格納している Int64A Int64 that contains the content of this XElement.

例外

要素が、有効な Int64 値を格納していません。The element does not contain a valid Int64 value.

element パラメーターが null です。The element parameter is null.

次の例では、long 整数を含む要素をコンテンツとして作成します。The following example creates an element with a long integer as content. 次に、にInt64キャストして、要素の値を取得します。It then retrieves the value of the element by casting to Int64.

XElement root = new XElement("Root", 9223372036854775807);  
long value = (long)root;  
Console.WriteLine("value={0}", value);  
Dim root As XElement = <Root>9223372036854775807</Root>  
Dim value As Long = CLng(root)  
Console.WriteLine("value={0}", value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

value=9223372036854775807  
こちらもご覧ください

Explicit(XElement to Nullable<Double>) Explicit(XElement to Nullable<Double>) Explicit(XElement to Nullable<Double>) Explicit(XElement to Nullable<Double>)

重要

この API は CLS 準拠ではありません。

この XElement の値を DoubleNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of Double.

public:
 static explicit operator Nullable<double>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<double> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<double>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Double)

パラメーター

element
XElement XElement XElement XElement

DoubleNullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of Double.

戻り値

この XElement の内容を格納している DoubleNullable<T>A Nullable<T> of Double that contains the content of this XElement.

例外

要素が null ではなく、有効な Double 値を含んでいません。The element is not null and does not contain a valid Double value.

次の例では、倍精度浮動小数点のコンテンツを持つ要素を作成します。The following example creates an element with double precision floating point content. 次に、のNullable<T> Doubleにキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of Double.

XElement root = new XElement("Root",  
    new XElement("Value", 1.79769313486231e308)  
);  
double? value = (double?)root.Element("Value");  
Console.WriteLine("Nullable double: value={0}", value == null ? "null" : value.ToString());  
Dim root As XElement = _  
        <Root>  
            <Value>1.79769313486231e308</Value>  
        </Root>  

Dim value As Nullable(Of Double) = CType(root.Element("Value"), Nullable(Of Double))  
Console.WriteLine("Nullable double: value={0}", IIf(value.HasValue, value.ToString(), "null"))  

この例を実行すると、次の出力が生成されます。This example produces the following output:

Nullable double: value=1.79769313486231E+308  
こちらもご覧ください

Explicit(XElement to Nullable<DateTime>) Explicit(XElement to Nullable<DateTime>) Explicit(XElement to Nullable<DateTime>) Explicit(XElement to Nullable<DateTime>)

重要

この API は CLS 準拠ではありません。

この XElement の値を DateTimeNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of DateTime.

public:
 static explicit operator Nullable<DateTime>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<DateTime> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<DateTime>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of DateTime)

パラメーター

element
XElement XElement XElement XElement

DateTimeNullable<T> にキャストする XElementThe XElement to cast to Nullable<T> of DateTime.

戻り値

この XElement の内容を格納している DateTimeNullable<T>A Nullable<T> of DateTime that contains the content of this XElement.

例外

要素が null ではなく、有効な DateTime 値を含んでいません。The element is not null and does not contain a valid DateTime value.

次の例では、日付と時刻をコンテンツとして持つ要素を作成します。The following example creates an element with a date and time as content. 次に、のNullable<T> DateTimeにキャストして値を取得します。It then retrieves the value by casting to Nullable<T> of DateTime.

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

この例を実行すると、次の出力が生成されます。This example produces the following output:

Nullable DateTime: value=10/6/2006 12:30:00 PM  

注釈

日付と時刻の内容を含む属性または要素の値空間は、ISO 8601 で説明されている日付と時刻に密接に関連しています。The value space of an attribute or element that contains date and time content is closely related to the dates and times described in ISO 8601. 日付と時刻の内容を含む属性または要素を作成する場合、属性または要素の値は W3C 仕様に従って書式設定されます。When creating an attribute or element that contains date and time content, the attribute or element values are formatted per the W3C specification. 詳細については、W3C の仕様を参照してください。See the W3C specification for more details.

属性または要素からNullable<T>DateTimeにキャストする場合、動作は厳密ではありません。The behavior is lax when casting to a Nullable<T> of DateTime from an attribute or element. 属性または要素の値が W3C 仕様に従って正確に書式設定されていない場合でNullable<T>DateTime、値はのに適切に変換されます。Even if the attribute or element value is not formatted exactly per the W3C specification, the value is appropriately converted to a Nullable<T> of DateTime.

この変換演算子はCultureInfo.InvariantCultureDateTimeを使用してから変換します。This conversion operator uses CultureInfo.InvariantCulture to convert from a DateTime.

こちらもご覧ください

Explicit(XElement to Nullable<DateTimeOffset>) Explicit(XElement to Nullable<DateTimeOffset>) Explicit(XElement to Nullable<DateTimeOffset>) Explicit(XElement to Nullable<DateTimeOffset>)

重要

この API は CLS 準拠ではありません。

この XElement の値を DateTimeOffsetNullable<T> にキャストします。Cast the value of this XElement to a Nullable<T> of DateTimeOffset.

public:
 static explicit operator Nullable<DateTimeOffset>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator Nullable<DateTimeOffset> (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<DateTimeOffset>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of DateTimeOffset)

パラメーター

element
XElement XElement XElement XElement

DateTimeOffsetNullable<T> にキャストする XElementThe XElement to cast to an Nullable<T> of DateTimeOffset.

戻り値

この XElement の内容を格納している DateTimeOffsetNullable<T>A Nullable<T> of DateTimeOffset that contains the content of this XElement.

例外

要素が null ではなく、有効な DateTimeOffset 値を含んでいません。The element is not null and does not contain a valid DateTimeOffset value.

次の例では、日付と時刻の内容を含む要素を作成します。The following example creates an element with date and time content. 次に、のNullable<T> DateTimeOffsetにキャストして値を取得します。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);  
Dim root As XElement = _  
    <Root>  
        <Child><%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %></Child>  
    </Root>  
Console.WriteLine(root)  

Dim dt As Nullable(Of DateTimeOffset) = CType(root.<Child>(0), Nullable(Of DateTimeOffset))  
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  

注釈

この変換演算子は、 XmlConvertクラスを使用して変換を実行します。This conversion operator uses the XmlConvert class to do the conversion.

こちらもご覧ください

Explicit(XElement to Int32) Explicit(XElement to Int32) Explicit(XElement to Int32) Explicit(XElement to Int32)

重要

この API は CLS 準拠ではありません。

この XElement の値を Int32 にキャストします。Cast the value of this XElement to an Int32.

public:
 static explicit operator int(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator int (System.Xml.Linq.XElement element);
static member op_Explicit : System.Xml.Linq.XElement -> int
Public Shared Narrowing Operator CType (element As XElement) As Integer

パラメーター

element
XElement XElement XElement XElement

Int32 にキャストする XElementThe XElement to cast to Int32.

戻り値

この XElement の内容を格納している Int32A Int32 that contains the content of this XElement.

例外

要素が、有効な Int32 値を格納していません。The element does not contain a valid Int32 value.

element パラメーターが null です。The element parameter is null.

次の例では、コンテンツとして整数を持つ要素を作成します。The following example creates an element with an integer as content. 次に、にInt32キャストして値を取得します。It then retrieves the value by casting to Int32.

XElement root = new XElement("Root", 2147483647);  
int value = (int)root;  
Console.WriteLine("value={0}", value);  
Dim root As XElement = <Root>2147483647</Root>  
Dim value As Integer = CInt(root)  
Console.WriteLine("value={0}", value)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

value=2147483647  
こちらもご覧ください

適用対象