XAttribute.Explicit 运算符

参考

定义

命名空间:: System.Xml.Linq

程序集:: System.Xml.XDocument.dll

程序集:: System.Xml.Linq.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

Explicit(XAttribute to Nullable<Int64>)	将此 XAttribute 的值强制转换为 Int64 的 Nullable<T>。
Explicit(XAttribute to Nullable<Single>)	将此 XAttribute 的值强制转换为 Single 的 Nullable<T>。
Explicit(XAttribute to Nullable<TimeSpan>)	将此 XAttribute 的值强制转换为 TimeSpan 的 Nullable<T>。
Explicit(XAttribute to Nullable<UInt32>)	将此 XAttribute 的值强制转换为 UInt32 的 Nullable<T>。
Explicit(XAttribute to Nullable<UInt64>)	将此 XAttribute 的值强制转换为 UInt64 的 Nullable<T>。
Explicit(XAttribute to TimeSpan)	将此 XAttribute 的值强制转换为 TimeSpan。
Explicit(XAttribute to String)	将此 XAttribute 的值强制转换为 String。
Explicit(XAttribute to Nullable<Int32>)	将此 XAttribute 的值强制转换为 Int32 的 Nullable<T>。
Explicit(XAttribute to UInt32)	将此 XAttribute 的值强制转换为 UInt32。
Explicit(XAttribute to UInt64)	将此 XAttribute 的值强制转换为 UInt64。
Explicit(XAttribute to Single)	将此 XAttribute 的值强制转换为 Single。
Explicit(XAttribute to Nullable<Guid>)	将此 XAttribute 的值强制转换为 Guid 的 Nullable<T>。
Explicit(XAttribute to Nullable<Decimal>)	将此 XAttribute 的值强制转换为 Decimal 的 Nullable<T>。
Explicit(XAttribute to Decimal)	将此 XAttribute 的值强制转换为 Decimal。
Explicit(XAttribute to Nullable<DateTimeOffset>)	将此 XAttribute 的值强制转换为 DateTimeOffset 的 Nullable<T>。
Explicit(XAttribute to Nullable<DateTime>)	将此 XAttribute 的值强制转换为 DateTime 的 Nullable<T>。
Explicit(XAttribute to Nullable<Boolean>)	将此 XAttribute 的值强制转换为 Boolean 的 Nullable<T>。
Explicit(XAttribute to Int64)	将此 XAttribute 的值强制转换为 Int64。
Explicit(XAttribute to Int32)	将此 XAttribute 的值强制转换为 Int32。
Explicit(XAttribute to Guid)	将此 XAttribute 的值强制转换为 Guid。
Explicit(XAttribute to Double)	将此 XAttribute 的值强制转换为 Double。
Explicit(XAttribute to Nullable<Double>)	将此 XAttribute 的值强制转换为 Double 的 Nullable<T>。
Explicit(XAttribute to DateTimeOffset)	将此 XAttribute 的值强制转换为 DateTimeOffset。
Explicit(XAttribute to DateTime)	将此 XAttribute 的值强制转换为 DateTime。
Explicit(XAttribute to Boolean)	将此 XAttribute 的值强制转换为 Boolean。

Explicit(XAttribute to Nullable<Int64>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Int64 的 Nullable<T>。

public:
 static explicit operator Nullable<long>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator long? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator long? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<int64>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Long)

参数

attribute: XAttribute

要强制转换为 Int64 的 Nullable<T> 的 XAttribute。

Nullable<Int64>

一个 Int64 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Int64 值。

示例

以下示例创建一个包含长整数内容的属性。然后，它通过强制转换为Nullable<T>Int64值来检索值。

XElement root = new XElement("Root",   
    new XAttribute("Att", 9223372036854775807)  
);  
long? value = (long?)root.Attribute("Att");  
Console.WriteLine("Nullable long: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="9223372036854775807"/>  
Dim value As Nullable(Of Long) = CType(root.Attribute("Att"), Nullable(Of Long))  
Console.WriteLine("Nullable long: value={0}", IIf(value.HasValue, value.ToString(), "null"))

该示例产生下面的输出：

Nullable long: value=9223372036854775807

另请参阅

适用于

Explicit(XAttribute to Nullable<Single>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Single 的 Nullable<T>。

public:
 static explicit operator Nullable<float>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator float? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator float? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<single>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Single)

参数

attribute: XAttribute

要强制转换为 Single 的 Nullable<T> 的 XAttribute。

Nullable<Single>

一个 Single 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Single 值。

示例

以下示例创建一个具有单精度浮点内容的属性。然后，它通过强制转换为Nullable<T>Single值来检索值。

XElement root = new XElement("Root",   
    new XAttribute("Att", 3.402823e38)  
);  
float? value = (float?)root.Attribute("Att");  
Console.WriteLine("Nullable Single: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="3.402823E+38"/>  
Dim value As Nullable(Of Single) = CType(root.Attribute("Att"), Nullable(Of Single))  
Console.WriteLine("Nullable Single: value={0}", IIf(value.HasValue, value.ToString(), "null"))

该示例产生下面的输出：

Nullable Single: value=3.402823E+38

另请参阅

适用于

Explicit(XAttribute to Nullable<TimeSpan>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 TimeSpan 的 Nullable<T>。

public:
 static explicit operator Nullable<TimeSpan>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator TimeSpan? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator TimeSpan? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<TimeSpan>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of TimeSpan)

参数

attribute: XAttribute

要强制转换为 TimeSpan 的 Nullable<T> 的 XAttribute。

Nullable<TimeSpan>

一个 TimeSpan 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 TimeSpan 值。

示例

以下示例创建包含时间跨度内容的属性。然后，它通过强制转换为Nullable<T>TimeSpan值来检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", new TimeSpan(1, 5, 30))  
);  
TimeSpan? value = (TimeSpan?)root.Attribute("Att");  
Console.WriteLine("Nullable TimeSpan: value={0}", value == null ? "null" : value.ToString());

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

该示例产生下面的输出：

Nullable TimeSpan: value=01:05:30

注解

包含时间跨度内容的属性或元素的值空间与 ISO 8601 中所述的持续时间内容密切相关。创建包含时间跨度内容的属性或元素时，会根据 W3C 规范设置属性或元素值的格式。有关更多详细信息，请参阅 W3C 规范。

从属性或元素强制转换为Nullable<T>TimeSpan行为时行为松散。即使属性或元素值没有完全按照 W3C 规范设置格式，该值也会适当地转换为一TimeSpan个Nullable<T>值。

另请参阅

适用于

Explicit(XAttribute to Nullable<UInt32>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 UInt32 的 Nullable<T>。

public:
 static explicit operator Nullable<System::UInt32>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator uint? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator uint? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<uint32>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of UInteger)

参数

attribute: XAttribute

要强制转换为 UInt32 的 Nullable<T> 的 XAttribute。

Nullable<UInt32>

一个 UInt32 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 UInt32 值。

示例

以下示例创建一个包含无符号整数内容的属性。然后，它通过强制转换为Nullable<T>UInt32值来检索值。

XElement root = new XElement("Root",   
    new XAttribute("Att", 4294967295)  
);  
uint? value = (uint?)root.Attribute("Att");  
Console.WriteLine("Nullable uint: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="4294967295"/>  
Dim value As Nullable(Of UInteger) = CType(root.Attribute("Att"), Nullable(Of UInteger))  
Console.WriteLine("Nullable uint: value={0}", IIf(value.HasValue, value.ToString(), "null"))

该示例产生下面的输出：

Nullable uint: value=4294967295

另请参阅

适用于

Explicit(XAttribute to Nullable<UInt64>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 UInt64 的 Nullable<T>。

public:
 static explicit operator Nullable<System::UInt64>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator ulong? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator ulong? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<uint64>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of ULong)

参数

attribute: XAttribute

要强制转换为 UInt64 的 Nullable<T> 的 XAttribute。

Nullable<UInt64>

一个 UInt64 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 UInt64 值。

示例

以下示例创建一个包含无符号长整数内容的属性。然后，它通过强制转换为Nullable<T>UInt64值来检索值。

XElement root = new XElement("Root",   
    new XAttribute("Att", 9223372036854775807)  
);  
ulong? value = (ulong?)root.Attribute("Att");  
Console.WriteLine("Nullable ulong: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="9223372036854775807"/>  
Dim value As Nullable(Of ULong) = CType(root.Attribute("Att"), Nullable(Of ULong))  
Console.WriteLine("Nullable ulong: value={0}", IIf(value.HasValue, value.ToString(), "null"))

该示例产生下面的输出：

Nullable ulong: value=9223372036854775807

另请参阅

适用于

Explicit(XAttribute to TimeSpan)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 TimeSpan。

public:
 static explicit operator TimeSpan(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator TimeSpan (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> TimeSpan

Public Shared Narrowing Operator CType (attribute As XAttribute) As TimeSpan

参数

attribute: XAttribute

要强制转换为 TimeSpan 的 XAttribute。

TimeSpan

一个 TimeSpan，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 TimeSpan 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建具有时间跨度内容的属性。然后，它通过强制转换为 TimeSpan检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", new TimeSpan(1, 5, 30))  
);  
TimeSpan value = (TimeSpan)root.Attribute("Att");  
Console.WriteLine("value={0}", value);

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

该示例产生下面的输出：

value=01:05:30

注解

从属性或元素强制转换为 TimeSpan 行为时行为松散。即使根据 W3C 规范未完全设置属性或元素值的格式，该值也会适当地转换为 a TimeSpan。

另请参阅

适用于

Explicit(XAttribute to String)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 String。

public:
 static explicit operator System::String ^(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator string (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator string? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> string

Public Shared Narrowing Operator CType (attribute As XAttribute) As String

参数

attribute: XAttribute

要强制转换为 String 的 XAttribute。

String

一个 String，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

示例

以下示例创建包含字符串内容的属性。然后，它通过强制转换为 String来检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", "attribute content")  
);  
XAttribute att = root.Attribute("Att");  
string str = (string)att;  
Console.WriteLine("(string)att={0}", str);

Dim root As XElement = <Root Att="attribute content"/>  
Dim att As XAttribute = root.Attribute("Att")  
Dim str As String = CStr(att)  
Console.WriteLine("(string)att={0}", str)

该示例产生下面的输出：

(string)att=attribute content

另请参阅

适用于

Explicit(XAttribute to Nullable<Int32>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Int32 的 Nullable<T>。

public:
 static explicit operator Nullable<int>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator int? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator int? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<int>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Integer)

参数

attribute: XAttribute

要强制转换为 Int32 的 Nullable<T> 的 XAttribute。

Nullable<Int32>

一个 Int32 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

示例

以下示例创建包含整数内容的属性。然后，它通过强制转换为Nullable<T>Int32值来检索值。

XElement root = new XElement("Root",   
    new XAttribute("Att", 2147483647)  
);  
int? value = (int?)root.Attribute("Att");  
Console.WriteLine("Nullable int: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="2147483647"/>  
Dim value As Nullable(Of Integer) = CType(root.Attribute("Att"), Nullable(Of Integer))  
Console.WriteLine("Nullable int: value={0}", IIf(value.HasValue, value.ToString(), "null"))

该示例产生下面的输出：

Nullable int: value=2147483647

另请参阅

适用于

Explicit(XAttribute to UInt32)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 UInt32。

public:
 static explicit operator System::UInt32(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator uint (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> uint32

Public Shared Narrowing Operator CType (attribute As XAttribute) As UInteger

参数

attribute: XAttribute

要强制转换为 UInt32 的 XAttribute。

UInt32

一个 UInt32，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 UInt32 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建一个包含无符号整数内容的属性。然后，它通过强制转换为 UInt32检索值。

XElement root = new XElement("Root",   
    new XAttribute("Att", 4294967295)  
);  
uint value = (uint)root.Attribute("Att");  
Console.WriteLine("value={0}", value);

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

该示例产生下面的输出：

value=4294967295

另请参阅

适用于

Explicit(XAttribute to UInt64)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 UInt64。

public:
 static explicit operator System::UInt64(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator ulong (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> uint64

Public Shared Narrowing Operator CType (attribute As XAttribute) As ULong

参数

attribute: XAttribute

要强制转换为 UInt64 的 XAttribute。

UInt64

一个 UInt64，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 UInt64 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建一个包含无符号长整数内容的属性。然后，它通过强制转换为 UInt64检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", 1844674407370955161)  
);  
ulong value = (ulong)root.Attribute("Att");  
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att="1844674407370955161"/>  
Dim value As ULong = CULng(root.Attribute("Att"))  
Console.WriteLine("value={0}", value)

该示例产生下面的输出：

value=1844674407370955161

另请参阅

适用于

Explicit(XAttribute to Single)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Single。

public:
 static explicit operator float(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator float (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> single

Public Shared Narrowing Operator CType (attribute As XAttribute) As Single

参数

attribute: XAttribute

要强制转换为 Single 的 XAttribute。

Single

一个 Single，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Single 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建一个具有单精度浮点内容的属性。然后，它通过强制转换为 Single来检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", 3.402823e38)  
);  
float value = (float)root.Attribute("Att");  
Console.WriteLine("value={0}", value);

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

该示例产生下面的输出：

value=3.402823E+38

另请参阅

适用于

Explicit(XAttribute to Nullable<Guid>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Guid 的 Nullable<T>。

public:
 static explicit operator Nullable<Guid>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator Guid? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator Guid? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<Guid>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Guid)

参数

attribute: XAttribute

要强制转换为 Guid 的 Nullable<T> 的 XAttribute。

Nullable<Guid>

一个 Guid 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Guid 值。

示例

以下示例创建一个包含 guid 内容的属性。然后，它通过强制转换为Nullable<T>Guid值来检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"))  
);  
Guid? value = (Guid?)root.Attribute("Att");  
Console.WriteLine("Nullable Guid: value={0}", value == null ? "null" : value.ToString());

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

该示例产生下面的输出：

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

另请参阅

适用于

Explicit(XAttribute to Nullable<Decimal>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Decimal 的 Nullable<T>。

public:
 static explicit operator Nullable<System::Decimal>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator decimal? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator decimal? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<decimal>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Decimal)

参数

attribute: XAttribute

要强制转换为 Decimal 的 Nullable<T> 的 XAttribute。

Nullable<Decimal>

一个 Decimal 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Decimal 值。

示例

以下示例创建包含十进制内容的属性。然后，它通过强制转换为Nullable<T>Decimal值来检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", "79228162514264337593543950335")  
);  
decimal? value = (decimal?)root.Attribute("Att");  
Console.WriteLine("Nullable decimal: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="79228162514264337593543950335"/>  
Dim value As Nullable(Of Decimal) = CType(root.Attribute("Att"), Nullable(Of Decimal))  
Console.WriteLine("Nullable decimal: value={0}", IIf(value.HasValue, value.ToString(), "null"))

该示例产生下面的输出：

Nullable decimal: value=79228162514264337593543950335

另请参阅

适用于

Explicit(XAttribute to Decimal)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Decimal。

public:
 static explicit operator System::Decimal(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator decimal (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> decimal

Public Shared Narrowing Operator CType (attribute As XAttribute) As Decimal

参数

attribute: XAttribute

要强制转换为 Decimal 的 XAttribute。

Decimal

一个 Decimal，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Decimal 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建一个具有十进制值的属性。然后，它通过强制转换为 Decimal属性来检索特性的值。

XElement root = new XElement("Root",  
    new XAttribute("Att", "79228162514264337593543950335")  
);  
decimal value = (decimal)root.Attribute("Att");  
Console.WriteLine("value={0}", value);

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

该示例产生下面的输出：

value=79228162514264337593543950335

另请参阅

适用于

Explicit(XAttribute to Nullable<DateTimeOffset>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 DateTimeOffset 的 Nullable<T>。

public:
 static explicit operator Nullable<DateTimeOffset>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTimeOffset? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTimeOffset? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<DateTimeOffset>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of DateTimeOffset)

参数

attribute: XAttribute

要强制转换为 DateTimeOffset 的 Nullable<T> 的 XAttribute。

Nullable<DateTimeOffset>

一个 DateTimeOffset 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 DateTimeOffset 值。

示例

以下示例创建一个包含日期和时间作为内容的属性。 It then retrieves the value by casting to Nullable<T> of DateTimeOffset.

XElement root = new XElement("Root",  
    new XAttribute("Att", new DateTimeOffset(new DateTime(2006, 10, 6, 12, 30, 0)))  
);  
DateTimeOffset? value = (DateTimeOffset?)root.Attribute("Att");  
Console.WriteLine("Nullable DateTimeOffset: value={0}", value == null ? "null" : value.ToString());

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

该示例产生下面的输出：

Nullable DateTimeOffset: value=10/6/2006 12:30:00 PM -07:00

注解

此转换运算符使用 XmlConvert 类执行转换。

适用于

Explicit(XAttribute to Nullable<DateTime>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 DateTime 的 Nullable<T>。

public:
 static explicit operator Nullable<DateTime>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTime? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTime? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<DateTime>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of DateTime)

参数

attribute: XAttribute

要强制转换为 DateTime 的 Nullable<T> 的 XAttribute。

Nullable<DateTime>

一个 DateTime 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 DateTime 值。

示例

以下示例创建一个包含日期和时间作为内容的属性。 It then retrieves the value by casting to Nullable<T> of DateTime.

XElement root = new XElement("Root",  
    new XAttribute("Att", new DateTime(2006, 10, 6, 12, 30, 0))  
);  
DateTime? value = (DateTime?)root.Attribute("Att");  
Console.WriteLine("Nullable DateTime: value={0}", value == null ? "null" : value.ToString());

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

该示例产生下面的输出：

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

注解

包含日期和时间内容的属性或元素的值空间与 ISO 8601 中所述的日期和时间密切相关。创建包含日期和时间内容的属性或元素时，根据 W3C 规范设置属性或元素值的格式。有关更多详细信息，请参阅 W3C 规范。

从属性或元素转换到Nullable<T>DateTime某个属性时，行为很宽松。 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.

另请参阅

适用于

Explicit(XAttribute to Nullable<Boolean>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Boolean 的 Nullable<T>。

public:
 static explicit operator Nullable<bool>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator bool? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator bool? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<bool>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Boolean)

参数

attribute: XAttribute

要强制转换为 Boolean 的 Nullable<T> 的 XAttribute。

Nullable<Boolean>

一个 Boolean 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Boolean 值。

示例

以下示例创建包含布尔内容的属性。 It then retrieves the value by casting to Nullable<T> of Boolean.

XElement root = new XElement("Root",   
    new XAttribute("BoolValue1", true),  
    new XAttribute("BoolValue2", false)  
);  
bool? bool1 = (bool?)root.Attribute("BoolValue1");  
bool? bool2 = (bool?)root.Attribute("BoolValue2");  
Console.WriteLine("Nullable boolean: BoolValue1={0}", bool1);  
Console.WriteLine("Nullable boolean: BoolValue2={0}", bool2);

Dim root As XElement = <Root BoolValue1="true" BoolValue2="false"/>  
Dim bool1 As Nullable(Of Boolean) = CType(root.Attribute("BoolValue1"), Nullable(Of Boolean))  
Dim bool2 As Nullable(Of Boolean) = CType(root.Attribute("BoolValue2"), Nullable(Of Boolean))  
Console.WriteLine("Nullable boolean: BoolValue1={0}", bool1)  
Console.WriteLine("Nullable boolean: BoolValue2={0}", bool2)

该示例产生下面的输出：

Nullable boolean: BoolValue1=True  
Nullable boolean: BoolValue2=False

注解

从属性或元素转换为 Boolean 时，允许的值为“0”、“1”，以及修整并转换为小写后生成“true”或“false”的任何字符串。

另请参阅

适用于

Explicit(XAttribute to Int64)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Int64。

public:
 static explicit operator long(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator long (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> int64

Public Shared Narrowing Operator CType (attribute As XAttribute) As Long

参数

attribute: XAttribute

要强制转换为 Int64 的 XAttribute。

Int64

一个 Int64，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Int64 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建一个包含长整型的属性作为内容。然后，它通过强制转换为 Int64属性来检索特性的值。

XElement root = new XElement("Root",  
    new XAttribute("Att", 9223372036854775807)  
);  
long value = (long)root.Attribute("Att");  
Console.WriteLine("value={0}", value);

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

该示例产生下面的输出：

value=9223372036854775807

另请参阅

适用于

Explicit(XAttribute to Int32)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Int32。

public:
 static explicit operator int(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator int (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> int

Public Shared Narrowing Operator CType (attribute As XAttribute) As Integer

参数

attribute: XAttribute

要强制转换为 Int32 的 XAttribute。

Int32

一个 Int32，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Int32 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建一个包含整数的属性作为内容。然后，它通过强制转换为 Int32检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", 2147483647)  
);  
int value = (int)root.Attribute("Att");  
Console.WriteLine("value={0}", value);

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

该示例产生下面的输出：

value=2147483647

另请参阅

适用于

Explicit(XAttribute to Guid)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Guid。

public:
 static explicit operator Guid(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator Guid (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Guid

Public Shared Narrowing Operator CType (attribute As XAttribute) As Guid

参数

attribute: XAttribute

要强制转换为 Guid 的 XAttribute。

Guid

一个 Guid，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Guid 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建一个包含 GUID 作为内容的属性。然后，它通过强制转换为 Guid检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"))  
);  
Guid value = (Guid)root.Attribute("Att");  
Console.WriteLine("value={0}", value);

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

该示例产生下面的输出：

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

另请参阅

适用于

Explicit(XAttribute to Double)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Double。

public:
 static explicit operator double(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator double (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> double

Public Shared Narrowing Operator CType (attribute As XAttribute) As Double

参数

attribute: XAttribute

要强制转换为 Double 的 XAttribute。

Double

一个 Double，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Double 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建包含 Double 内容的属性。然后，它通过强制转换为 Double检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", 1.79769313486231e308)  
);  
double value = (double)root.Attribute("Att");  
Console.WriteLine("value={0}", value);

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

该示例产生下面的输出：

value=1.79769313486231E+308

另请参阅

适用于

Explicit(XAttribute to Nullable<Double>)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Double 的 Nullable<T>。

public:
 static explicit operator Nullable<double>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator double? (System.Xml.Linq.XAttribute attribute);

[System.CLSCompliant(false)]
public static explicit operator double? (System.Xml.Linq.XAttribute? attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<double>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Double)

参数

attribute: XAttribute

要强制转换为 Double 的 Nullable<T> 的 XAttribute。

Nullable<Double>

一个 Double 的 Nullable<T>，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Double 值。

示例

以下示例创建一个具有双精度浮点内容的属性。然后，它通过强制转换为Nullable<T>Double值来检索值。

XElement root = new XElement("Root",  
    new XAttribute("Att", 1.79769313486231e308)  
);  
double? value = (double?)root.Attribute("Att");  
Console.WriteLine("Nullable double: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="1.79769313486231E+308"/>  
Dim value As Nullable(Of Double) = CType(root.Attribute("Att"), Nullable(Of Double))  
Console.WriteLine("Nullable double: value={0}", IIf(value.HasValue, value.ToString(), "null"))

该示例产生下面的输出：

Nullable double: value=1.79769313486231E+308

另请参阅

适用于

Explicit(XAttribute to DateTimeOffset)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 DateTimeOffset。

public:
 static explicit operator DateTimeOffset(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTimeOffset (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> DateTimeOffset

Public Shared Narrowing Operator CType (attribute As XAttribute) As DateTimeOffset

参数

attribute: XAttribute

要强制转换为 DateTimeOffset 的 XAttribute。

DateTimeOffset

一个 DateTimeOffset，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 DateTimeOffset 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建包含日期和时间内容的属性。然后将它强制转换为 DateTimeOffset 检索值。

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

// casting from a strictly formatted XML attribute  
DateTimeOffset dt = (DateTimeOffset)root.Attribute("Att");  
Console.WriteLine("dt={0}", dt);

Dim root As XElement = _  
    <Root  
        Att=<%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %>/>  
Console.WriteLine(root)  

' casting from a strictly formatted XML attribute  
Dim dt As DateTimeOffset = CType(root.Attribute("Att"), DateTimeOffset)  
Console.WriteLine("dt={0}", dt)

该示例产生下面的输出：

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

注解

此转换运算符使用 XmlConvert 类执行转换。

另请参阅

适用于

Explicit(XAttribute to DateTime)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 DateTime。

public:
 static explicit operator DateTime(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTime (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> DateTime

Public Shared Narrowing Operator CType (attribute As XAttribute) As DateTime

参数

attribute: XAttribute

要强制转换为 DateTime 的 XAttribute。

DateTime

一个 DateTime，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 DateTime 值。

ArgumentNullException

attribute 参数为 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 XAttribute("Att", new DateTime(2006, 10, 6, 12, 30, 0))  
);  
Console.WriteLine(root);  

// casting from a strictly formatted XML attribute  
DateTime dt = (DateTime)root.Attribute("Att");  
Console.WriteLine("dt={0}", dt);  
Console.WriteLine("-----");  

// if root is formatted in some different way than the standard ISO 8601, if at all possible,  
// the value is appropriately converted to DateTime  

XAttribute dtAtt = new XAttribute("OrderDate", "October 6, 2006");  
Console.WriteLine(dtAtt);  
DateTime orderDate = (DateTime)dtAtt;  
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 Att=<%= New DateTime(2006, 10, 6, 12, 30, 0) %>/>  

Console.WriteLine(root)  

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

' if root is formatted in some different way than the standard ISO 8601, if at all possible,  
' the value is appropriately converted to DateTime  
Dim dtAtt As XAttribute = New XAttribute("OrderDate", "October 6, 2006")  
Console.WriteLine(dtAtt)  
Dim orderDate As DateTime = CType(dtAtt, DateTime)  
Console.WriteLine("OrderDate={0:d}", orderDate)

该示例产生下面的输出：

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

注解

从属性或元素强制转换为 DateTime 某个行为时行为很宽松。即使根据 W3C 规范未完全设置属性或元素值的格式，该值也会适当地转换为 a DateTime。

此转换运算符用于 CultureInfo.InvariantCulture 从 . DateTime.

另请参阅

适用于

Explicit(XAttribute to Boolean)

重要

此 API 不符合 CLS。

将此 XAttribute 的值强制转换为 Boolean。

public:
 static explicit operator bool(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator bool (System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> bool

Public Shared Narrowing Operator CType (attribute As XAttribute) As Boolean

参数

attribute: XAttribute

要强制转换为 Boolean 的 XAttribute。

Boolean

一个 Boolean，其中包含此 XAttribute 的内容。

属性: CLSCompliantAttribute

例外

FormatException

属性不包含有效的 Boolean 值。

ArgumentNullException

attribute 参数为 null。

示例

以下示例创建一个 Boolean 具有值的属性，然后将其强制转换为 Boolean。

XElement root = new XElement("Root",   
    new XAttribute("BoolValue", true)  
);  
bool bv = (bool)root.Attribute("BoolValue");  
Console.WriteLine("(bool)BoolValue={0}", bv);

Dim root As XElement = <root BoolValue="true"/>  
Dim bv As Boolean = CBool(root.Attribute("BoolValue"))  
Console.WriteLine("(bool)BoolValue={0}", bv)

该示例产生下面的输出：

(bool)BoolValue=True

注解

从属性或元素转换为 Boolean 时，允许的值为“0”、“1”，以及修整并转换为小写后生成“true”或“false”的任何字符串。

另请参阅

适用于

XAttribute.Explicit 运算符

定义

重载

Explicit(XAttribute to Nullable<Int64>)

参数

返回

例外

示例

另请参阅

适用于

Explicit(XAttribute to Nullable<Single>)

参数

返回

例外

示例

另请参阅

适用于

Explicit(XAttribute to Nullable<TimeSpan>)

参数

返回

例外

示例

注解

另请参阅

适用于

Explicit(XAttribute to Nullable<UInt32>)

参数

返回

例外

示例

另请参阅

适用于

Explicit(XAttribute to Nullable<UInt64>)

参数

返回

例外

示例

另请参阅

适用于

Explicit(XAttribute to TimeSpan)

参数

返回

例外

示例

注解

另请参阅

适用于

Explicit(XAttribute to String)

参数

返回

示例

另请参阅

适用于

Explicit(XAttribute to Nullable<Int32>)

参数

返回

示例

另请参阅

适用于

Explicit(XAttribute to UInt32)

参数

返回

例外

示例

另请参阅

适用于

Explicit(XAttribute to UInt64)

参数

返回

例外

示例

另请参阅

适用于

Explicit(XAttribute to Single)

参数

返回

例外

示例

另请参阅

适用于