XElement.Explicit 연산자

참조

정의

네임스페이스:: System.Xml.Linq

어셈블리:: System.Xml.XDocument.dll

어셈블리:: System.Xml.Linq.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

오버로드

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

Source:: XElement.cs

Source:: XElement.cs

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

XElement의 Nullable<T>로 캐스팅할 Int64입니다.

반환

Nullable<Int64>

이 Nullable<T>의 콘텐츠가 들어 있는 Int64의 XElement입니다.

특성: 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 Single입니다.

반환

Nullable<Single>

이 Nullable<T>의 콘텐츠가 들어 있는 Single의 XElement입니다.

특성: 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 TimeSpan입니다.

반환

Nullable<TimeSpan>

이 Nullable<T>의 콘텐츠가 들어 있는 TimeSpan의 XElement입니다.

특성: 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 사양을 참조하세요.

특성 또는 요소에서 의 TimeSpan 로 캐스팅할 Nullable<T> 때 동작이 느슨합니다. 특성 또는 요소 값이 W3C 사양에 따라 정확히 형식이 지정되지 않더라도 값은 의 TimeSpan로 Nullable<T> 적절하게 변환됩니다.

추가 정보

LINQ to XML 개요

적용 대상

Explicit(XElement to Nullable<UInt32>)

Source:: XElement.cs

Source:: XElement.cs

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

XElement의 Nullable<T>로 캐스팅할 UInt32입니다.

반환

Nullable<UInt32>

이 Nullable<T>의 콘텐츠가 들어 있는 UInt32의 XElement입니다.

특성: 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 UInt64입니다.

반환

Nullable<UInt64>

이 Nullable<T>의 콘텐츠가 들어 있는 UInt64의 XElement입니다.

특성: 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

XElement으로 캐스팅할 UInt32입니다.

반환

UInt32

이 UInt32의 콘텐츠가 들어 있는 XElement입니다.

특성: 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

XElement으로 캐스팅할 String입니다.

반환

String

이 String의 콘텐츠가 들어 있는 XElement입니다.

특성: 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

XElement으로 캐스팅할 TimeSpan입니다.

반환

TimeSpan

이 TimeSpan의 콘텐츠가 들어 있는 XElement입니다.

특성: 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

설명

시간 범위 콘텐츠가 포함된 특성 또는 요소의 값 공간은 ISO 8601에 설명된 대로 기간 콘텐츠와 밀접한 관련이 있습니다. 시간 범위 콘텐츠가 포함된 특성 또는 요소를 만들 때 특성 또는 요소 값은 W3C 사양에 따라 형식이 지정됩니다. 자세한 내용은 W3C 사양을 참조하세요.

특성 또는 요소에서 로 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

XElement으로 캐스팅할 UInt64입니다.

반환

UInt64

이 UInt64의 콘텐츠가 들어 있는 XElement입니다.

특성: 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 Int32입니다.

반환

Nullable<Int32>

이 Nullable<T>의 콘텐츠가 들어 있는 Int32의 XElement입니다.

특성: 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

XElement으로 캐스팅할 Single입니다.

반환

Single

이 Single의 콘텐츠가 들어 있는 XElement입니다.

특성: 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 Guid입니다.

반환

Nullable<Guid>

이 Nullable<T>의 콘텐츠가 들어 있는 Guid의 XElement입니다.

특성: 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 Boolean입니다.

반환

Nullable<Boolean>

이 Nullable<T>의 콘텐츠가 들어 있는 Boolean의 XElement입니다.

특성: 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 Decimal입니다.

반환

Nullable<Decimal>

이 Nullable<T>의 콘텐츠가 들어 있는 Decimal의 XElement입니다.

특성: 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

XElement으로 캐스팅할 Boolean입니다.

반환

Boolean

이 Boolean의 콘텐츠가 들어 있는 XElement입니다.

특성: 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

XElement으로 캐스팅할 DateTime입니다.

반환

DateTime

이 DateTime의 콘텐츠가 들어 있는 XElement입니다.

특성: 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

XElement으로 캐스팅할 DateTimeOffset입니다.

반환

DateTimeOffset

이 DateTimeOffset의 콘텐츠가 들어 있는 XElement입니다.

특성: 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

XElement으로 캐스팅할 Double입니다.

반환

Double

이 Double의 콘텐츠가 들어 있는 XElement입니다.

특성: 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

XElement으로 캐스팅할 Guid입니다.

반환

Guid

이 Guid의 콘텐츠가 들어 있는 XElement입니다.

특성: 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

XElement으로 캐스팅할 Decimal입니다.

반환

Decimal

이 Decimal의 콘텐츠가 들어 있는 XElement입니다.

특성: 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

XElement으로 캐스팅할 Int64입니다.

반환

Int64

이 Int64의 콘텐츠가 들어 있는 XElement입니다.

특성: 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 Double입니다.

반환

Nullable<Double>

이 Nullable<T>의 콘텐츠가 들어 있는 Double의 XElement입니다.

특성: 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 DateTime입니다.

반환

Nullable<DateTime>

이 Nullable<T>의 콘텐츠가 들어 있는 DateTime의 XElement입니다.

특성: 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

설명

특성 또는 요소에서 의 DateTime 로 캐스팅할 Nullable<T> 때 동작이 느슨합니다. 특성 또는 요소 값이 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의 값을 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

XElement의 Nullable<T>로 캐스팅할 DateTimeOffset입니다.

반환

Nullable<DateTimeOffset>

이 Nullable<T>의 콘텐츠가 들어 있는 DateTimeOffset의 XElement입니다.

특성: 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

XElement으로 캐스팅할 Int32입니다.

반환

Int32

이 Int32의 콘텐츠가 들어 있는 XElement입니다.

특성: 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 개요

적용 대상