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

정의

오버로드

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

XElement의 값을 Nullable<T>Int64로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Int64.

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

XElement의 값을 Nullable<T>Single로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Single.

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

XElement의 값을 Nullable<T>TimeSpan로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of TimeSpan.

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

XElement의 값을 Nullable<T>UInt32로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of UInt32.

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

XElement의 값을 Nullable<T>UInt64로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of UInt64.

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

XElement의 값을 UInt32으로 캐스팅합니다.Cast the value of this XElement to a UInt32.

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

XElement의 값을 String으로 캐스팅합니다.Cast the value of this XElement to a String.

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

XElement의 값을 TimeSpan으로 캐스팅합니다.Cast the value of this XElement to a TimeSpan.

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

XElement의 값을 UInt64으로 캐스팅합니다.Cast the value of this XElement to a UInt64.

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

XElement의 값을 Nullable<T>Int32로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Int32.

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

XElement의 값을 Single으로 캐스팅합니다.Cast the value of this XElement to a Single.

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

XElement의 값을 Nullable<T>Guid로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Guid.

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

XElement의 값을 Nullable<T>Boolean로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Boolean.

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

XElement의 값을 Nullable<T>Decimal로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Decimal.

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

XElement의 값을 Boolean으로 캐스팅합니다.Cast the value of this XElement to a Boolean.

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

XElement의 값을 DateTime으로 캐스팅합니다.Cast the value of this XElement to a DateTime.

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

XAttribute의 값을 DateTimeOffset으로 캐스팅합니다.Cast the value of this XAttribute to a DateTimeOffset.

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

XElement의 값을 Double으로 캐스팅합니다.Cast the value of this XElement to a Double.

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

XElement의 값을 Guid으로 캐스팅합니다.Cast the value of this XElement to a Guid.

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

XElement의 값을 Decimal으로 캐스팅합니다.Cast the value of this XElement to a Decimal.

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

XElement의 값을 Int64로 캐스팅합니다.Cast the value of this XElement to an Int64.

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

XElement의 값을 Nullable<T>Double로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Double.

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

XElement의 값을 Nullable<T>DateTime로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of DateTime.

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

XElement의 값을 Nullable<T>DateTimeOffset로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of DateTimeOffset.

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

XElement의 값을 Int32로 캐스팅합니다.Cast the value of this XElement to an Int32.

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>Int64로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Int64.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 Int64입니다.The XElement to cast to Nullable<T> of Int64.

반환

Nullable<T>의 콘텐츠가 들어 있는 Int64XElement입니다.A Nullable<T> of Int64 that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 Int64 값을 포함하지 않습니다.The element is not null and does not contain a valid Int64 value.

예제

다음 예제에서는 정수 (long) 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with long integer content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>Int64합니다.It then retrieves the value by casting to Nullable<T> of Int64.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

Nullable ulong: value=9223372036854775807  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>Single로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Single.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 Single입니다.The XElement to cast to Nullable<T> of Single.

반환

Nullable<T>의 콘텐츠가 들어 있는 SingleXElement입니다.A Nullable<T> of Single that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 Single 값을 포함하지 않습니다.The element is not null and does not contain a valid Single value.

예제

다음 예제에서는 단 정밀도 부동 소수점 콘텐츠가 있는 요소를 만듭니다.The following example creates an element with single precision floating point content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>Single합니다.It then retrieves the value by casting to Nullable<T> of Single.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

Nullable Single: value=3.402823E+38  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>TimeSpan로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of TimeSpan.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 TimeSpan입니다.The XElement to cast to Nullable<T> of TimeSpan.

반환

Nullable<T>의 콘텐츠가 들어 있는 TimeSpanXElement입니다.A Nullable<T> of TimeSpan that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 TimeSpan 값을 포함하지 않습니다.The element is not null and does not contain a valid TimeSpan value.

예제

다음 예제에서는 요소를 만듭니다 시간 범위를 사용 하 여 콘텐츠.The following example creates an element with time span content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>TimeSpan합니다.It then retrieves the value by casting to Nullable<T> of TimeSpan.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

Nullable TimeSpan: value=01:05:30  

설명

시간 범위 콘텐츠를 포함 하는 요소나 특성의 값 공간은 ISO 8601에 설명 된 대로 밀접 하 게 기간 콘텐츠 관련 됩니다.The value space of an attribute or element that contains time span content is closely related to duration content as described in ISO 8601. 특성 또는 시간 범위 콘텐츠를 포함 하는 요소를 만들 때 W3C 사양과 특성 또는 요소 값 형식이 됩니다.When creating an attribute or element that contains time span content, the attribute or element values are formatted per the W3C specification. 자세한 내용은 W3C 사양을 참조 하세요.Please see the W3C specification for more details.

으로 캐스팅할 때의 동작은 lax를 Nullable<T>TimeSpan 특성 또는 요소입니다.Behavior is lax when casting to a Nullable<T> of TimeSpan from an attribute or element. 값을 적절 하 게 변환할 특성 또는 요소 값의 형식이 W3C 사양과 정확 하 게 하지 않더라도 Nullable<T>TimeSpan합니다.Even if the attribute or element value is not formatted exactly per the W3C specification, the value is appropriately converted to a Nullable<T> of TimeSpan.

추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>UInt32로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of UInt32.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 UInt32입니다.The XElement to cast to Nullable<T> of UInt32.

반환

Nullable<T>의 콘텐츠가 들어 있는 UInt32XElement입니다.A Nullable<T> of UInt32 that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 UInt32 값을 포함하지 않습니다.The element is not null and does not contain a valid UInt32 value.

예제

다음 예제에서는 부호 없는 정수로 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with unsigned integer content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>UInt32합니다.It then retrieves the value by casting to Nullable<T> of UInt32.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

Nullable uint: value=4294967295  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>UInt64로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of UInt64.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 UInt64입니다.The XElement to cast to Nullable<T> of UInt64.

반환

Nullable<T>의 콘텐츠가 들어 있는 UInt64XElement입니다.A Nullable<T> of UInt64 that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 UInt64 값을 포함하지 않습니다.The element is not null and does not contain a valid UInt64 value.

예제

다음 예제에서는 부호 없는 정수 (long) 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with unsigned long integer content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>UInt64합니다.It then retrieves the value by casting to Nullable<T> of UInt64.

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

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

Nullable ulong: value=9223372036854775807  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 UInt32으로 캐스팅합니다.Cast the value of this XElement to a UInt32.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

UInt32의 콘텐츠가 들어 있는 XElement입니다.A UInt32 that contains the content of this XElement.

예외

요소에 유효한 UInt32 값이 들어 있지 않은 경우The element does not contain a valid UInt32 value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 부호 없는 정수로 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with unsigned integer content. 로 캐스팅 하 여 값을 검색 한 다음 UInt32합니다.It then retrieves the value by casting to UInt32.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

value=4294967295  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 String으로 캐스팅합니다.Cast the value of this XElement to a String.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

String의 콘텐츠가 들어 있는 XElement입니다.A String that contains the content of this XElement.

예제

다음 예제에서는 문자열 내용이 포함 된 요소를 만듭니다.The following example creates an element with string content. 로 캐스팅 하 여 값을 검색 한 다음 String합니다.It then retrieves the value by casting to String.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

(string)root=abc def ghi  

설명

경우는 XElement 자식이, 모든 요소의 텍스트 및 하위 항목의 텍스트의 연결 된 문자열 값이 반환 됩니다.If the XElement has children, the concatenated string value of all of the element's text and descendant's text is returned.

추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 TimeSpan으로 캐스팅합니다.Cast the value of this XElement to a TimeSpan.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

TimeSpan의 콘텐츠가 들어 있는 XElement입니다.A TimeSpan that contains the content of this XElement.

예외

요소에 유효한 TimeSpan 값이 들어 있지 않은 경우The element does not contain a valid TimeSpan value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 요소를 만듭니다 시간 범위를 사용 하 여 콘텐츠.The following example creates an element with time span content. 로 캐스팅 하 여 값을 검색 한 다음 TimeSpan합니다.It then retrieves the value by casting to TimeSpan.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

value=01:05:30  

설명

시간 범위 콘텐츠를 포함 하는 요소나 특성의 값 공간은 ISO 8601에 설명 된 대로 밀접 하 게 기간 콘텐츠 관련 됩니다.The value space of an attribute or element that contains time span content is closely related to duration content as described in ISO 8601. 특성 또는 시간 범위 콘텐츠를 포함 하는 요소를 만들 때 W3C 사양과 특성 또는 요소 값 형식이 됩니다.When creating an attribute or element that contains time span content, the attribute or element values are formatted per the W3C specification. 자세한 내용은 W3C 사양을 참조 하세요.Please see the W3C specification for more details.

으로 캐스팅할 때의 동작은 lax는 TimeSpan 특성 또는 요소입니다.Behavior is lax when casting to a TimeSpan from an attribute or element. 값을 적절 하 게 변환할 특성 또는 요소 값의 형식이 W3C 사양과 정확 하 게 하지 않더라도 TimeSpan입니다.Even if the attribute or element value is not formatted exactly per the W3C specification, the value is appropriately converted to a TimeSpan.

추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 UInt64으로 캐스팅합니다.Cast the value of this XElement to a UInt64.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

UInt64의 콘텐츠가 들어 있는 XElement입니다.A UInt64 that contains the content of this XElement.

예외

요소에 유효한 UInt64 값이 들어 있지 않은 경우The element does not contain a valid UInt64 value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 부호 없는 정수 (long) 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with unsigned long integer content. 로 캐스팅 하 여 값을 검색 한 다음 UInt64합니다.It then retrieves the value by casting to UInt64.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

value=18446744073709551615  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>Int32로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Int32.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 Int32입니다.The XElement to cast to Nullable<T> of Int32.

반환

Nullable<T>의 콘텐츠가 들어 있는 Int32XElement입니다.A Nullable<T> of Int32 that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 Int32 값을 포함하지 않습니다.The element is not null and does not contain a valid Int32 value.

예제

다음 예제에서는 부호 없는 정수로 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with unsigned integer content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>Int32합니다.It then retrieves the value by casting to Nullable<T> of Int32.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

Nullable integer: value=2147483647  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Single으로 캐스팅합니다.Cast the value of this XElement to a Single.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

Single의 콘텐츠가 들어 있는 XElement입니다.A Single that contains the content of this XElement.

예외

요소에 유효한 Single 값이 들어 있지 않은 경우The element does not contain a valid Single value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 단 정밀도 부동 소수점 콘텐츠가 있는 요소를 만듭니다.The following example creates an element with single precision floating point content. 로 캐스팅 하 여 값을 검색 한 다음 Single합니다.It then retrieves the value by casting to Single.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

value=3.402823E+38  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>Guid로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Guid.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 Guid입니다.The XElement to cast to Nullable<T> of Guid.

반환

Nullable<T>의 콘텐츠가 들어 있는 GuidXElement입니다.A Nullable<T> of Guid that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 Guid 값을 포함하지 않습니다.The element is not null and does not contain a valid Guid value.

예제

다음 예제에서는 guid 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with guid content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>Guid합니다.It then retrieves the value by casting to Nullable<T> of Guid.

XElement root = new XElement("Root",  
    new XElement("Value", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"))  
);  
Guid? value = (Guid?)root.Element("Value");  
Console.WriteLine("Nullable Guid: value={0}", value == null ? "null" : value.ToString());  
Dim root As XElement = _   
    <Root>  
        <Value><%= New Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730") %></Value>  
    </Root>  
Dim value As Nullable(Of Guid) = CType(root.Element("Value"), Nullable(Of Guid))  
Console.WriteLine("Nullable Guid: value={0}", IIf(value.HasValue, value.ToString(), "null"))  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

Nullable Guid: value=3c1cc55b-baff-4b7a-9d17-077af3aa5730  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>Boolean로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Boolean.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 Boolean입니다.The XElement to cast to Nullable<T> of Boolean.

반환

Nullable<T>의 콘텐츠가 들어 있는 BooleanXElement입니다.A Nullable<T> of Boolean that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 Boolean 값을 포함하지 않습니다.The element is not null and does not contain a valid Boolean value.

예제

다음 예에서는 부울 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with boolean content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>Boolean합니다.It then retrieves the value by casting to Nullable<T> of Boolean.

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

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

변환할 때 Nullable<T>Boolean 특성 또는 요소에서 허용 되는 값은 "0", "1" 및 "true"를 생성 하는 문자열 또는 "false" 트리밍 후 소문자로 변환 합니다.When converting to Nullable<T> of Boolean from an attribute or element, allowed values are "0", "1", and any string that produces "true" or "false" after trimming and conversion to lower case.

추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>Decimal로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Decimal.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 Decimal입니다.The XElement to cast to Nullable<T> of Decimal.

반환

Nullable<T>의 콘텐츠가 들어 있는 DecimalXElement입니다.A Nullable<T> of Decimal that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 Decimal 값을 포함하지 않습니다.The element is not null and does not contain a valid Decimal value.

예제

다음 예제에서는 10 진수 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with decimal content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>Decimal합니다.It then retrieves the value by casting to Nullable<T> of Decimal.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

Nullable decimal: value=79228162514264337593543950335  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Boolean으로 캐스팅합니다.Cast the value of this XElement to a Boolean.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

Boolean의 콘텐츠가 들어 있는 XElement입니다.A Boolean that contains the content of this XElement.

예외

요소에 유효한 Boolean 값이 들어 있지 않은 경우The element does not contain a valid Boolean value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예에서는 부울 값을 사용 하 여 일부 요소를 만듭니다.The following example creates some elements with boolean values. 그런 다음 캐스팅 하도록 Boolean합니다.It then casts them to Boolean.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

변환할 때 Boolean 특성 또는 요소에서 허용 되는 값은 "0", "1" 및 "true"를 생성 하는 문자열 또는 "false" 트리밍 후 소문자로 변환 합니다.When converting to Boolean from an attribute or element, allowed values are "0", "1", and any string that produces "true" or "false" after trimming and conversion to lower case.

추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 DateTime으로 캐스팅합니다.Cast the value of this XElement to a DateTime.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

DateTime의 콘텐츠가 들어 있는 XElement입니다.A DateTime that contains the content of this XElement.

예외

요소에 유효한 DateTime 값이 들어 있지 않은 경우The element does not contain a valid DateTime value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 날짜 및 시간 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with date and time content. 그 다음으로 캐스팅 DateTime 값을 검색 합니다.It then casts it to DateTime to retrieve the value.

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

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

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

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

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

날짜 및 시간 콘텐츠를 포함 하는 요소나 특성의 값 공간은 날짜와 시간을 ISO 8601에 설명 된 밀접 한 관련이 있습니다.The value space of an attribute or element that contains date and time content is closely related to the dates and times described in ISO 8601. 특성 또는 날짜 및 시간 콘텐츠를 포함 하는 요소를 만들 때 W3C 사양과 특성 또는 요소 값 형식이 됩니다.When creating an attribute or element that contains date and time content, the attribute or element values are formatted per the W3C specification. 자세한 내용은 W3C 사양을 참조 하십시오.See the W3C specification for more details.

으로 캐스팅할 때의 동작은 lax는 DateTime 특성 또는 요소입니다.Behavior is lax when casting to a DateTime from an attribute or element. 값을 적절 하 게 변환할 특성 또는 요소 값의 형식이 W3C 사양과 정확 하 게 하지 않더라도 DateTime입니다.Even if the attribute or element value is not formatted exactly per the W3C specification, the value is appropriately converted to a DateTime.

이 변환 연산자 사용 CultureInfo.InvariantCulture 변환할는 DateTime합니다.This conversion operator uses CultureInfo.InvariantCulture to convert from a DateTime.

추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XAttribute의 값을 DateTimeOffset으로 캐스팅합니다.Cast the value of this XAttribute to a DateTimeOffset.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

DateTimeOffset의 콘텐츠가 들어 있는 XElement입니다.A DateTimeOffset that contains the content of this XElement.

예외

요소에 유효한 DateTimeOffset 값이 들어 있지 않은 경우The element does not contain a valid DateTimeOffset value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 날짜 및 시간 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with date and time content. 다음에 캐스팅 DateTimeOffset 값을 검색 합니다.It then casts to DateTimeOffset to retrieve the value.

XElement root = new XElement("Root",  
    new XElement("Child", new DateTimeOffset(new DateTime(2006, 10, 6, 12, 30, 0)))  
);  
Console.WriteLine(root);  

DateTimeOffset dt = (DateTimeOffset)root.Element("Child");  
Console.WriteLine("dt={0}", dt);  
Dim root As XElement = _  
    <Root>  
        <Child><%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %></Child>  
    </Root>  
Console.WriteLine(root)  

Dim dt As DateTimeOffset = CType(root.<Child>(0), DateTimeOffset)  
Console.WriteLine("dt={0}", dt)  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

이 변환 연산자를 사용 하 여 XmlConvert 변환을 수행 하는 클래스입니다.This conversion operator uses the XmlConvert class to do the conversion.

추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Double으로 캐스팅합니다.Cast the value of this XElement to a Double.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

Double의 콘텐츠가 들어 있는 XElement입니다.A Double that contains the content of this XElement.

예외

요소에 유효한 Double 값이 들어 있지 않은 경우The element does not contain a valid Double value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 사용 하 여 특성 double 콘텐츠입니다.The following example creates an attribute with double content. 로 캐스팅 하 여 값을 검색 한 다음 Double합니다.It then retrieves the value by casting to Double.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

value=1.79769313486231E+308  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Guid으로 캐스팅합니다.Cast the value of this XElement to a Guid.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

Guid의 콘텐츠가 들어 있는 XElement입니다.A Guid that contains the content of this XElement.

예외

요소에 유효한 Guid 값이 들어 있지 않은 경우The element does not contain a valid Guid value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 guid를 사용 하 여 콘텐츠 요소를 만듭니다.The following example creates an element with a guid as content. 로 캐스팅 하 여 값을 검색 한 다음 Guid합니다.It then retrieves the value by casting to Guid.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

value=3c1cc55b-baff-4b7a-9d17-077af3aa5730  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Decimal으로 캐스팅합니다.Cast the value of this XElement to a Decimal.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

Decimal의 콘텐츠가 들어 있는 XElement입니다.A Decimal that contains the content of this XElement.

예외

요소에 유효한 Decimal 값이 들어 있지 않은 경우The element does not contain a valid Decimal value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 10 진수 값을 사용 하 여 요소를 만듭니다.The following example creates an element with a decimal value. 로 캐스팅 하 여 특성의 값을 검색 한 다음 Decimal합니다.It then retrieves the value of the attribute by casting to Decimal.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

value=79228162514264337593543950335  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Int64로 캐스팅합니다.Cast the value of this XElement to an Int64.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

Int64의 콘텐츠가 들어 있는 XElement입니다.A Int64 that contains the content of this XElement.

예외

요소에 유효한 Int64 값이 들어 있지 않은 경우The element does not contain a valid Int64 value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 정수 (long)를 사용 하 여 콘텐츠 요소를 만듭니다.The following example creates an element with a long integer as content. 로 캐스팅 하 여 요소의 값을 검색 한 다음 Int64합니다.It then retrieves the value of the element by casting to Int64.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

value=9223372036854775807  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>Double로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of Double.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 Double입니다.The XElement to cast to Nullable<T> of Double.

반환

Nullable<T>의 콘텐츠가 들어 있는 DoubleXElement입니다.A Nullable<T> of Double that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 Double 값을 포함하지 않습니다.The element is not null and does not contain a valid Double value.

예제

다음 예제에서는 배정밀도 부동 소수점 콘텐츠가 있는 요소를 만듭니다.The following example creates an element with double precision floating point content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>Double합니다.It then retrieves the value by casting to Nullable<T> of Double.

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

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

Nullable double: value=1.79769313486231E+308  
추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>DateTime로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of DateTime.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 DateTime입니다.The XElement to cast to Nullable<T> of DateTime.

반환

Nullable<T>의 콘텐츠가 들어 있는 DateTimeXElement입니다.A Nullable<T> of DateTime that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 DateTime 값을 포함하지 않습니다.The element is not null and does not contain a valid DateTime value.

예제

다음 예제에서는 콘텐츠로 시간과 날짜를 사용 하 여 요소를 만듭니다.The following example creates an element with a date and time as content. 로 캐스팅 하 여 다음 값을 얻어냅니다 Nullable<T>DateTime합니다.It then retrieves the value by casting to Nullable<T> of DateTime.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

날짜 및 시간 콘텐츠를 포함 하는 요소나 특성의 값 공간은 날짜와 시간을 ISO 8601에 설명 된 밀접 한 관련이 있습니다.The value space of an attribute or element that contains date and time content is closely related to the dates and times described in ISO 8601. 특성 또는 날짜 및 시간 콘텐츠를 포함 하는 요소를 만들 때 W3C 사양과 특성 또는 요소 값 형식이 됩니다.When creating an attribute or element that contains date and time content, the attribute or element values are formatted per the W3C specification. 자세한 내용은 W3C 사양을 참조 하십시오.See the W3C specification for more details.

으로 캐스팅할 때 동작은 lax를 Nullable<T>DateTime 특성 또는 요소입니다.The behavior is lax when casting to a Nullable<T> of DateTime from an attribute or element. 값을 적절 하 게 변환할 특성 또는 요소 값의 형식이 W3C 사양과 정확 하 게 하지 않더라도 Nullable<T>DateTime합니다.Even if the attribute or element value is not formatted exactly per the W3C specification, the value is appropriately converted to a Nullable<T> of DateTime.

이 변환 연산자 사용 CultureInfo.InvariantCulture 변환할는 DateTime합니다.This conversion operator uses CultureInfo.InvariantCulture to convert from a DateTime.

추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Nullable<T>DateTimeOffset로 캐스팅합니다.Cast the value of this XElement to a Nullable<T> of DateTimeOffset.

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

매개 변수

element
XElement XElement XElement XElement

XElementNullable<T>로 캐스팅할 DateTimeOffset입니다.The XElement to cast to an Nullable<T> of DateTimeOffset.

반환

Nullable<T>의 콘텐츠가 들어 있는 DateTimeOffsetXElement입니다.A Nullable<T> of DateTimeOffset that contains the content of this XElement.

예외

요소가 null이 아니고 유효한 DateTimeOffset 값을 포함하지 않습니다.The element is not null and does not contain a valid DateTimeOffset value.

예제

다음 예제에서는 날짜 및 시간 콘텐츠를 사용 하 여 요소를 만듭니다.The following example creates an element with date and time content. 다음에 캐스팅 Nullable<T>DateTimeOffset 값을 검색 합니다.It then casts to Nullable<T> of DateTimeOffset to retrieve the value.

XElement root = new XElement("Root",  
    new XElement("Child", new DateTimeOffset(new DateTime(2006, 10, 6, 12, 30, 0)))  
);  
Console.WriteLine(root);  

DateTimeOffset? dt = (DateTimeOffset?)root.Element("Child");  
Console.WriteLine("dt={0}", dt);  
Dim root As XElement = _  
    <Root>  
        <Child><%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %></Child>  
    </Root>  
Console.WriteLine(root)  

Dim dt As Nullable(Of DateTimeOffset) = CType(root.<Child>(0), Nullable(Of DateTimeOffset))  
Console.WriteLine("dt={0}", dt)  

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

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

설명

이 변환 연산자를 사용 하 여 XmlConvert 변환을 수행 하는 클래스입니다.This conversion operator uses the XmlConvert class to do the conversion.

추가 정보

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

중요

이 API는 CLS 규격이 아닙니다.

XElement의 값을 Int32로 캐스팅합니다.Cast the value of this XElement to an Int32.

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

매개 변수

element
XElement XElement XElement XElement

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

반환

Int32의 콘텐츠가 들어 있는 XElement입니다.A Int32 that contains the content of this XElement.

예외

요소에 유효한 Int32 값이 들어 있지 않은 경우The element does not contain a valid Int32 value.

element 매개 변수가 null인 경우The element parameter is null.

예제

다음 예제에서는 정수를 사용 하 여 콘텐츠 요소를 만듭니다.The following example creates an element with an integer as content. 로 캐스팅 하 여 값을 검색 한 다음 Int32합니다.It then retrieves the value by casting to Int32.

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

이 예제는 다음과 같은 출력을 생성합니다.This example produces the following output:

value=2147483647  
추가 정보

적용 대상