XElement.Explicit Operator

定義

オーバーロード

名前 説明
Explicit(XElement to Nullable<Int64>)

このXElementの値をNullable<T>Int64にキャストします。

Explicit(XElement to Nullable<Single>)

このXElementの値をNullable<T>Singleにキャストします。

Explicit(XElement to Nullable<TimeSpan>)

このXElementの値をNullable<T>TimeSpanにキャストします。

Explicit(XElement to Nullable<UInt32>)

このXElementの値をNullable<T>UInt32にキャストします。

Explicit(XElement to Nullable<UInt64>)

このXElementの値をNullable<T>UInt64にキャストします。

Explicit(XElement to UInt32)

この XElement の値を UInt32にキャストします。

Explicit(XElement to String)

この XElement の値を Stringにキャストします。

Explicit(XElement to TimeSpan)

この XElement の値を TimeSpanにキャストします。

Explicit(XElement to UInt64)

この XElement の値を UInt64にキャストします。

Explicit(XElement to Nullable<Int32>)

このXElementの値をNullable<T>Int32にキャストします。

Explicit(XElement to Single)

この XElement の値を Singleにキャストします。

Explicit(XElement to Nullable<Guid>)

このXElementの値をNullable<T>Guidにキャストします。

Explicit(XElement to Nullable<Boolean>)

このXElementの値をNullable<T>Booleanにキャストします。

Explicit(XElement to Nullable<Decimal>)

このXElementの値をNullable<T>Decimalにキャストします。

Explicit(XElement to Boolean)

この XElement の値を Booleanにキャストします。

Explicit(XElement to DateTime)

この XElement の値を DateTimeにキャストします。

Explicit(XElement to DateTimeOffset)

この XAttribute の値を DateTimeOffsetにキャストします。

Explicit(XElement to Double)

この XElement の値を Doubleにキャストします。

Explicit(XElement to Guid)

この XElement の値を Guidにキャストします。

Explicit(XElement to Decimal)

この XElement の値を Decimalにキャストします。

Explicit(XElement to Int64)

この XElement の値を Int64にキャストします。

Explicit(XElement to Nullable<Double>)

このXElementの値をNullable<T>Doubleにキャストします。

Explicit(XElement to Nullable<DateTime>)

このXElementの値をNullable<T>DateTimeにキャストします。

Explicit(XElement to Nullable<DateTimeOffset>)

このXElementの値をNullable<T>DateTimeOffsetにキャストします。

Explicit(XElement to Int32)

この XElement の値を Int32にキャストします。

Explicit(XElement to Nullable<Int64>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>Int64にキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするInt64

返品

このNullable<T>の内容を含むInt64XElement

属性

例外

要素は null されず、有効な Int64 値が含まれていません。

次の例では、長整数コンテンツを含む要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

Nullable ulong: value=9223372036854775807

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<Single>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>Singleにキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするSingle

返品

このNullable<T>の内容を含むSingleXElement

属性

例外

要素は null されず、有効な Single 値が含まれていません。

次の例では、単精度浮動小数点コンテンツを持つ要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

Nullable Single: value=3.402823E+38

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<TimeSpan>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>TimeSpanにキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするTimeSpan

返品

このNullable<T>の内容を含むTimeSpanXElement

属性

例外

要素は null されず、有効な TimeSpan 値が含まれていません。

次の例では、期間コンテンツを含む要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

Nullable TimeSpan: value=01:05:30

注釈

タイム スパン コンテンツを含む属性または要素の値空間は、ISO 8601 で説明されているように、期間コンテンツと密接に関連しています。 タイム スパン コンテンツを含む属性または要素を作成する場合、属性または要素の値は W3C 仕様に従って書式設定されます。 詳細については、W3C 仕様を参照してください。

属性または要素からNullable<T>TimeSpanにキャストする場合の動作は緩いです。 属性または要素の値が W3C 仕様に従って正確に書式設定されていない場合でも、値はNullable<T>TimeSpanに適切に変換されます。

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<UInt32>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>UInt32にキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするUInt32

返品

このNullable<T>の内容を含むUInt32XElement

属性

例外

要素は null されず、有効な UInt32 値が含まれていません。

次の例では、符号なし整数コンテンツを持つ要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

Nullable uint: value=4294967295

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<UInt64>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>UInt64にキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするUInt64

返品

このNullable<T>の内容を含むUInt64XElement

属性

例外

要素は null されず、有効な UInt64 値が含まれていません。

次の例では、符号なし長整数コンテンツを持つ要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

Nullable ulong: value=9223372036854775807

こちらもご覧ください

適用対象

Explicit(XElement to UInt32)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を 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);
[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XElement -> uint32
Public Shared Narrowing Operator CType (element As XElement) As UInteger

パラメーター

element
XElement

XElementにキャストするUInt32

返品

このUInt32の内容を含むXElement

属性

例外

要素に有効な UInt32 値が含まれていません。

element パラメーターはnull

次の例では、符号なし整数コンテンツを持つ要素を作成します。 その後、 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)

この例を実行すると、次の出力が生成されます。

value=4294967295

こちらもご覧ください

適用対象

Explicit(XElement to String)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を 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);
[System.CLSCompliant(false)]
public static explicit operator string?(System.Xml.Linq.XElement? element);
[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XElement -> string
Public Shared Narrowing Operator CType (element As XElement) As String

パラメーター

element
XElement

XElementにキャストするString

返品

このStringの内容を含むXElement

属性

次の例では、文字列コンテンツを含む要素を作成します。 その後、 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)

この例を実行すると、次の出力が生成されます。

(string)root=abc def ghi

注釈

XElementに子がある場合は、要素のすべてのテキストと子孫のテキストの連結文字列値が返されます。

こちらもご覧ください

適用対象

Explicit(XElement to TimeSpan)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を TimeSpanにキャストします。

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

パラメーター

element
XElement

XElementにキャストするTimeSpan

返品

このTimeSpanの内容を含むXElement

属性

例外

要素に有効な TimeSpan 値が含まれていません。

element パラメーターはnull

次の例では、期間コンテンツを含む要素を作成します。 その後、 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)

この例を実行すると、次の出力が生成されます。

value=01:05:30

注釈

タイム スパン コンテンツを含む属性または要素の値空間は、ISO 8601 で説明されているように、期間コンテンツと密接に関連しています。 タイム スパン コンテンツを含む属性または要素を作成する場合、属性または要素の値は W3C 仕様に従って書式設定されます。 詳細については、W3C 仕様を参照してください。

属性または要素から TimeSpan にキャストする場合の動作は緩いです。 属性または要素の値が W3C 仕様に従って正確に書式設定されていない場合でも、値は適切に TimeSpanに変換されます。

こちらもご覧ください

適用対象

Explicit(XElement to UInt64)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を 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);
[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XElement -> uint64
Public Shared Narrowing Operator CType (element As XElement) As ULong

パラメーター

element
XElement

XElementにキャストするUInt64

返品

このUInt64の内容を含むXElement

属性

例外

要素に有効な UInt64 値が含まれていません。

element パラメーターはnull

elementnullです。

次の例では、符号なし長整数コンテンツを持つ要素を作成します。 その後、 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)

この例を実行すると、次の出力が生成されます。

value=18446744073709551615

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<Int32>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>Int32にキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするInt32

返品

このNullable<T>の内容を含むInt32XElement

属性

例外

要素は null されず、有効な Int32 値が含まれていません。

次の例では、符号なし整数コンテンツを持つ要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

Nullable integer: value=2147483647

こちらもご覧ください

適用対象

Explicit(XElement to Single)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を Singleにキャストします。

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

パラメーター

element
XElement

XElementにキャストするSingle

返品

このSingleの内容を含むXElement

属性

例外

要素に有効な Single 値が含まれていません。

element パラメーターはnull

elementnullです。

次の例では、単精度浮動小数点コンテンツを持つ要素を作成します。 その後、 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)

この例を実行すると、次の出力が生成されます。

value=3.402823E+38

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<Guid>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>Guidにキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするGuid

返品

このNullable<T>の内容を含むGuidXElement

属性

例外

要素は null されず、有効な Guid 値が含まれていません。

次の例では、guid コンテンツを含む要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

Nullable Guid: value=3c1cc55b-baff-4b7a-9d17-077af3aa5730

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<Boolean>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>Booleanにキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするBoolean

返品

このNullable<T>の内容を含むBooleanXElement

属性

例外

要素は null されず、有効な Boolean 値が含まれていません。

次の例では、ブール値の内容を持つ要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

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

注釈

属性または要素からNullable<T>Booleanに変換する場合、使用できる値は "0"、"1"、トリミングと小文字への変換後に "true" または "false" を生成する任意の文字列です。

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<Decimal>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>Decimalにキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするDecimal

返品

このNullable<T>の内容を含むDecimalXElement

属性

例外

要素は null されず、有効な Decimal 値が含まれていません。

次の例では、10 進コンテンツを含む要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

Nullable decimal: value=79228162514264337593543950335

こちらもご覧ください

適用対象

Explicit(XElement to Boolean)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を Booleanにキャストします。

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

パラメーター

element
XElement

XElementにキャストするBoolean

返品

このBooleanの内容を含むXElement

属性

例外

要素に有効な Boolean 値が含まれていません。

element パラメーターはnull

次の例では、ブール値を持つ要素をいくつか作成します。 その後、それらを 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)

この例を実行すると、次の出力が生成されます。

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

注釈

属性または要素から Boolean に変換する場合、使用できる値は "0"、"1"、およびトリミング後に "true" または "false" を生成する文字列を小文字に変換します。

こちらもご覧ください

適用対象

Explicit(XElement to DateTime)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を DateTimeにキャストします。

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

パラメーター

element
XElement

XElementにキャストするDateTime

返品

このDateTimeの内容を含むXElement

属性

例外

要素に有効な DateTime 値が含まれていません。

element パラメーターはnull

elementnullです。

次の例では、日付と時刻の内容を含む要素を作成します。 その後、それを DateTime にキャストして値を取得します。

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

この例を実行すると、次の出力が生成されます。

<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 で説明されている日付と時刻に密接に関連しています。 日付と時刻の内容を含む属性または要素を作成する場合、属性または要素の値は W3C 仕様に従って書式設定されます。 詳細については、W3C 仕様を参照してください。

属性または要素から DateTime にキャストする場合の動作は緩いです。 属性または要素の値が W3C 仕様に従って正確に書式設定されていない場合でも、値は適切に DateTimeに変換されます。

この変換演算子は、 CultureInfo.InvariantCulture を使用して DateTimeから変換します。

こちらもご覧ください

適用対象

Explicit(XElement to DateTimeOffset)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XAttribute の値を DateTimeOffsetにキャストします。

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

パラメーター

element
XElement

XElementにキャストするDateTimeOffset

返品

このDateTimeOffsetの内容を含むXElement

属性

例外

要素に有効な DateTimeOffset 値が含まれていません。

element パラメーターはnull

elementnullです。

次の例では、日付と時刻の内容を含む要素を作成します。 その後、 DateTimeOffset にキャストして値を取得します。

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)

この例を実行すると、次の出力が生成されます。

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

注釈

この変換演算子は、 XmlConvert クラスを使用して変換を行います。

こちらもご覧ください

適用対象

Explicit(XElement to Double)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を Doubleにキャストします。

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

パラメーター

element
XElement

XElementにキャストするDouble

返品

このDoubleの内容を含むXElement

属性

例外

要素に有効な Double 値が含まれていません。

element パラメーターはnull

elementnullです。

次の例では、 double コンテンツを含む属性を作成します。 その後、 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)

この例を実行すると、次の出力が生成されます。

value=1.79769313486231E+308

こちらもご覧ください

適用対象

Explicit(XElement to Guid)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を Guidにキャストします。

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

パラメーター

element
XElement

XElementにキャストするGuid

返品

このGuidの内容を含むXElement

属性

例外

要素に有効な Guid 値が含まれていません。

element パラメーターはnull

elementnullです。

次の例では、guid をコンテンツとして持つ要素を作成します。 その後、 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)

この例を実行すると、次の出力が生成されます。

value=3c1cc55b-baff-4b7a-9d17-077af3aa5730

こちらもご覧ください

適用対象

Explicit(XElement to Decimal)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を 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);
[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XElement -> decimal
Public Shared Narrowing Operator CType (element As XElement) As Decimal

パラメーター

element
XElement

XElementにキャストするDecimal

返品

このDecimalの内容を含むXElement

属性

例外

要素に有効な Decimal 値が含まれていません。

element パラメーターはnull

elementnullです。

次の例では、10 進値を持つ要素を作成します。 次に、 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)

この例を実行すると、次の出力が生成されます。

value=79228162514264337593543950335

こちらもご覧ください

適用対象

Explicit(XElement to Int64)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を Int64にキャストします。

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

パラメーター

element
XElement

XElementにキャストするInt64

返品

このInt64の内容を含むXElement

属性

例外

要素に有効な Int64 値が含まれていません。

element パラメーターはnull

elementnullです。

次の例では、長整数の要素をコンテンツとして作成します。 次に、 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)

この例を実行すると、次の出力が生成されます。

value=9223372036854775807

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<Double>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>Doubleにキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするDouble

返品

このNullable<T>の内容を含むDoubleXElement

属性

例外

要素は null されず、有効な Double 値が含まれていません。

次の例では、倍精度浮動小数点コンテンツを持つ要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

Nullable double: value=1.79769313486231E+308

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<DateTime>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>DateTimeにキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするDateTime

返品

このNullable<T>の内容を含むDateTimeXElement

属性

例外

要素は null されず、有効な DateTime 値が含まれていません。

次の例では、日付と時刻をコンテンツとして持つ要素を作成します。 その後、Nullable<T>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"))

この例を実行すると、次の出力が生成されます。

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

注釈

日付と時刻の内容を含む属性または要素の値空間は、ISO 8601 で説明されている日付と時刻に密接に関連しています。 日付と時刻の内容を含む属性または要素を作成する場合、属性または要素の値は W3C 仕様に従って書式設定されます。 詳細については、W3C 仕様を参照してください。

属性または要素からNullable<T>DateTimeにキャストする場合の動作は緩いです。 属性または要素の値が W3C 仕様に従って正確に書式設定されていない場合でも、値はNullable<T>DateTimeに適切に変換されます。

この変換演算子は、 CultureInfo.InvariantCulture を使用して DateTimeから変換します。

こちらもご覧ください

適用対象

Explicit(XElement to Nullable<DateTimeOffset>)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

このXElementの値をNullable<T>DateTimeOffsetにキャストします。

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

パラメーター

element
XElement

XElementNullable<T>にキャストするDateTimeOffset

返品

このNullable<T>の内容を含むDateTimeOffsetXElement

属性

例外

要素は null されず、有効な DateTimeOffset 値が含まれていません。

次の例では、日付と時刻の内容を含む要素を作成します。 その後、Nullable<T>DateTimeOffsetにキャストして値を取得します。

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)

この例を実行すると、次の出力が生成されます。

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

注釈

この変換演算子は、 XmlConvert クラスを使用して変換を行います。

こちらもご覧ください

適用対象

Explicit(XElement to Int32)

ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs
ソース:
XElement.cs

重要

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

この XElement の値を Int32にキャストします。

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

パラメーター

element
XElement

XElementにキャストするInt32

返品

このInt32の内容を含むXElement

属性

例外

要素に有効な Int32 値が含まれていません。

element パラメーターはnull

次の例では、コンテンツとして整数を持つ要素を作成します。 その後、 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)

この例を実行すると、次の出力が生成されます。

value=2147483647

こちらもご覧ください

適用対象