XElement.Explicit 演算子

リファレンス

定義

名前空間:: System.Xml.Linq

アセンブリ:: System.Xml.XDocument.dll

アセンブリ:: System.Xml.Linq.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

Explicit(XElement to Nullable<Int64>)	この XElement の値を Int64 の Nullable<T> にキャストします。
Explicit(XElement to Nullable<Single>)	この XElement の値を Single の Nullable<T> にキャストします。
Explicit(XElement to Nullable<TimeSpan>)	この XElement の値を TimeSpan の Nullable<T> にキャストします。
Explicit(XElement to Nullable<UInt32>)	この XElement の値を UInt32 の Nullable<T> にキャストします。
Explicit(XElement to Nullable<UInt64>)	この XElement の値を UInt64 の Nullable<T> にキャストします。
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 の値を Int32 の Nullable<T> にキャストします。
Explicit(XElement to Single)	この XElement の値を Single にキャストします。
Explicit(XElement to Nullable<Guid>)	この XElement の値を Guid の Nullable<T> にキャストします。
Explicit(XElement to Nullable<Boolean>)	この XElement の値を Boolean の Nullable<T> にキャストします。
Explicit(XElement to Nullable<Decimal>)	この XElement の値を Decimal の Nullable<T> にキャストします。
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 の値を Double の Nullable<T> にキャストします。
Explicit(XElement to Nullable<DateTime>)	この XElement の値を DateTime の Nullable<T> にキャストします。
Explicit(XElement to Nullable<DateTimeOffset>)	この XElement の値を DateTimeOffset の Nullable<T> にキャストします。
Explicit(XElement to Int32)	この XElement の値を Int32 にキャストします。

Explicit(XElement to Nullable<Int64>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

Int64 の Nullable<T> にキャストする XElement。

戻り値

Nullable<Int64>

この XElement の内容を格納している Int64 の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<Single>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

Single の Nullable<T> にキャストする XElement。

戻り値

Nullable<Single>

この XElement の内容を格納している Single の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<TimeSpan>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

TimeSpan の Nullable<T> にキャストする XElement。

戻り値

Nullable<TimeSpan>

この XElement の内容を格納している TimeSpan の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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 仕様に従って正確に書式設定されていない場合でも、値はの TimeSpanに適切にNullable<T>変換されます。

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<UInt32>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

UInt32 の Nullable<T> にキャストする XElement。

戻り値

Nullable<UInt32>

この XElement の内容を格納している UInt32 の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<UInt64>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

UInt64 の Nullable<T> にキャストする XElement。

戻り値

Nullable<UInt64>

この XElement の内容を格納している UInt64 の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to UInt32)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

UInt32 にキャストする XElement。

戻り値

UInt32

この XElement の内容を格納している UInt32。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な UInt32 値を格納していません。

ArgumentNullException

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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to String)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

String にキャストする XElement。

戻り値

String

この XElement の内容を格納している String。

属性: CLSCompliantAttribute

例

次の例では、文字列コンテンツを含む要素を作成します。次に、にキャストして値を 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 子がある場合は、要素のすべてのテキストと子孫のテキストの連結文字列値が返されます。

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to TimeSpan)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

TimeSpan にキャストする XElement。

戻り値

TimeSpan

この XElement の内容を格納している TimeSpan。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な TimeSpan 値を格納していません。

ArgumentNullException

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

注釈

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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to UInt64)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

UInt64 にキャストする XElement。

戻り値

UInt64

この XElement の内容を格納している UInt64。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な UInt64 値を格納していません。

ArgumentNullException

element パラメーターが null です。

InvalidOperationException

element が nullです。

例

次の例では、符号なし長整数コンテンツを持つ要素を作成します。次に、にキャストして値を 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<Int32>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

Int32 の Nullable<T> にキャストする XElement。

戻り値

Nullable<Int32>

この XElement の内容を格納している Int32 の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Single)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

Single にキャストする XElement。

戻り値

Single

この XElement の内容を格納している Single。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な Single 値を格納していません。

ArgumentNullException

element パラメーターが null です。

InvalidOperationException

element が nullです。

例

次の例では、単精度浮動小数点コンテンツを持つ要素を作成します。次に、にキャストして値を 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<Guid>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

Guid の Nullable<T> にキャストする XElement。

戻り値

Nullable<Guid>

この XElement の内容を格納している Guid の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<Boolean>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

Boolean の Nullable<T> にキャストする XElement。

戻り値

Nullable<Boolean>

この XElement の内容を格納している Boolean の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

注釈

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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<Decimal>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

Decimal の Nullable<T> にキャストする XElement。

戻り値

Nullable<Decimal>

この XElement の内容を格納している Decimal の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Boolean)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

Boolean にキャストする XElement。

戻り値

Boolean

この XElement の内容を格納している Boolean。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な Boolean 値を格納していません。

ArgumentNullException

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" を生成する文字列と小文字への変換です。

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to DateTime)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

DateTime にキャストする XElement。

戻り値

DateTime

この XElement の内容を格納している DateTime。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な DateTime 値を格納していません。

ArgumentNullException

element パラメーターが null です。

InvalidOperationException

element が nullです。

例

次の例では、日付と時刻の内容を含む要素を作成します。次に、にキャストして 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。

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to DateTimeOffset)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

DateTimeOffset にキャストする XElement。

戻り値

DateTimeOffset

この XElement の内容を格納している DateTimeOffset。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な DateTimeOffset 値を格納していません。

ArgumentNullException

element パラメーターが null です。

InvalidOperationException

element が nullです。

例

次の例では、日付と時刻の内容を含む要素を作成します。その後、に 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 使用して変換を行います。

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Double)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

Double にキャストする XElement。

戻り値

Double

この XElement の内容を格納している Double。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な Double 値を格納していません。

ArgumentNullException

element パラメーターが null です。

InvalidOperationException

element が nullです。

例

次の例では、コンテンツを含む属性を 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Guid)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

Guid にキャストする XElement。

戻り値

Guid

この XElement の内容を格納している Guid。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な Guid 値を格納していません。

ArgumentNullException

element パラメーターが null です。

InvalidOperationException

element が nullです。

例

次の例では、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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Decimal)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

Decimal にキャストする XElement。

戻り値

Decimal

この XElement の内容を格納している Decimal。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な Decimal 値を格納していません。

ArgumentNullException

element パラメーターが null です。

InvalidOperationException

element が nullです。

例

次の例では、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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Int64)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

Int64 にキャストする XElement。

戻り値

Int64

この XElement の内容を格納している Int64。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な Int64 値を格納していません。

ArgumentNullException

element パラメーターが null です。

InvalidOperationException

element が nullです。

例

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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<Double>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

Double の Nullable<T> にキャストする XElement。

戻り値

Nullable<Double>

この XElement の内容を格納している Double の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<DateTime>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

DateTime の Nullable<T> にキャストする XElement。

戻り値

Nullable<DateTime>

この XElement の内容を格納している DateTime の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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

注釈

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

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

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Nullable<DateTimeOffset>)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

重要

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

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

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

DateTimeOffset の Nullable<T> にキャストする XElement。

戻り値

Nullable<DateTimeOffset>

この XElement の内容を格納している DateTimeOffset の Nullable<T>。

属性: CLSCompliantAttribute

例外

FormatException

要素が 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 使用して変換を行います。

こちらもご覧ください

LINQ to XML の概要

適用対象

Explicit(XElement to Int32)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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

Int32 にキャストする XElement。

戻り値

Int32

この XElement の内容を格納している Int32。

属性: CLSCompliantAttribute

例外

FormatException

要素が、有効な Int32 値を格納していません。

ArgumentNullException

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

こちらもご覧ください

LINQ to XML の概要

適用対象