XElement.Explicit Operator

Referensi

Definisi

Ruang nama:: System.Xml.Linq

Rakitan:: System.Xml.XDocument.dll

Rakitan:: System.Xml.Linq.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Overload

Explicit(XElement to Nullable<Int64>)	Transmisikan nilai ini XElement ke Nullable<T> dari Int64.
Explicit(XElement to Nullable<Single>)	Transmisikan nilai ini XElement ke Nullable<T> dari Single.
Explicit(XElement to Nullable<TimeSpan>)	Transmisikan nilai ini XElement ke Nullable<T> dari TimeSpan.
Explicit(XElement to Nullable<UInt32>)	Transmisikan nilai ini XElement ke Nullable<T> dari UInt32.
Explicit(XElement to Nullable<UInt64>)	Transmisikan nilai ini XElement ke Nullable<T> dari UInt64.
Explicit(XElement to UInt32)	Transmisikan nilai ini XElement ke UInt32.
Explicit(XElement to String)	Transmisikan nilai ini XElement ke String.
Explicit(XElement to TimeSpan)	Transmisikan nilai ini XElement ke TimeSpan.
Explicit(XElement to UInt64)	Transmisikan nilai ini XElement ke UInt64.
Explicit(XElement to Nullable<Int32>)	Transmisikan nilai ini XElement ke Nullable<T> dari Int32.
Explicit(XElement to Single)	Transmisikan nilai ini XElement ke Single.
Explicit(XElement to Nullable<Guid>)	Transmisikan nilai ini XElement ke Nullable<T> dari Guid.
Explicit(XElement to Nullable<Boolean>)	Transmisikan nilai ini XElement ke Nullable<T> dari Boolean.
Explicit(XElement to Nullable<Decimal>)	Transmisikan nilai ini XElement ke Nullable<T> dari Decimal.
Explicit(XElement to Boolean)	Transmisikan nilai ini XElement ke Boolean.
Explicit(XElement to DateTime)	Transmisikan nilai ini XElement ke DateTime.
Explicit(XElement to DateTimeOffset)	Transmisikan nilai ini XAttribute ke DateTimeOffset.
Explicit(XElement to Double)	Transmisikan nilai ini XElement ke Double.
Explicit(XElement to Guid)	Transmisikan nilai ini XElement ke Guid.
Explicit(XElement to Decimal)	Transmisikan nilai ini XElement ke Decimal.
Explicit(XElement to Int64)	Transmisikan nilai ini XElement ke Int64.
Explicit(XElement to Nullable<Double>)	Transmisikan nilai ini XElement ke Nullable<T> dari Double.
Explicit(XElement to Nullable<DateTime>)	Transmisikan nilai ini XElement ke Nullable<T> dari DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)	Transmisikan nilai ini XElement ke Nullable<T> dari DateTimeOffset.
Explicit(XElement to Int32)	Transmisikan nilai ini XElement ke Int32.

Explicit(XElement to Nullable<Int64>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari Int64.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Long)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> dari Int64.

Mengembalikan

Nullable<Int64>

dari Nullable<T>Int64 yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen ini tidak null dan tidak berisi nilai yang valid Int64 .

Contoh

Contoh berikut membuat elemen dengan konten bilangan bulat panjang. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

Nullable ulong: value=9223372036854775807

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<Single>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari Single.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Single)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> dari Single.

Mengembalikan

Nullable<Single>

dari Nullable<T>Single yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen ini tidak null dan tidak berisi nilai yang valid Single .

Contoh

Contoh berikut membuat elemen dengan konten titik mengambang presisi tunggal. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

Nullable Single: value=3.402823E+38

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<TimeSpan>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari TimeSpan.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of TimeSpan)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> dari TimeSpan.

Mengembalikan

Nullable<TimeSpan>

dari Nullable<T>TimeSpan yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen ini tidak null dan tidak berisi nilai yang valid TimeSpan .

Contoh

Contoh berikut membuat elemen dengan konten rentang waktu. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

Nullable TimeSpan: value=01:05:30

Keterangan

Ruang nilai atribut atau elemen yang berisi konten rentang waktu terkait erat dengan konten durasi seperti yang dijelaskan dalam ISO 8601. Saat membuat atribut atau elemen yang berisi konten rentang waktu, nilai atribut atau elemen diformat sesuai spesifikasi W3C. Silakan lihat spesifikasi W3C untuk detail selengkapnya.

Perilaku adalah lax saat mentransmisikan ke Nullable<T> dari TimeSpan atribut atau elemen. Bahkan jika nilai atribut atau elemen tidak diformat persis sesuai spesifikasi W3C, nilainya dikonversi dengan tepat menjadi Nullable<T> dari TimeSpan.

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<UInt32>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari UInt32.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of UInteger)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> dari UInt32.

Mengembalikan

Nullable<UInt32>

dari Nullable<T>UInt32 yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen ini tidak null dan tidak berisi nilai yang valid UInt32 .

Contoh

Contoh berikut membuat elemen dengan konten bilangan bulat yang tidak ditandatangani. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

Nullable uint: value=4294967295

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<UInt64>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari UInt64.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of ULong)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> dari UInt64.

Mengembalikan

Nullable<UInt64>

dari Nullable<T>UInt64 yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen ini tidak null dan tidak berisi nilai yang valid UInt64 .

Contoh

Contoh berikut membuat elemen dengan konten bilangan bulat panjang yang tidak ditandatangani. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

Nullable ulong: value=9223372036854775807

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to UInt32)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke UInt32.

public:
 static explicit operator System::UInt32(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As UInteger

Parameter

element: XElement

yang XElement akan dilemparkan ke UInt32.

Mengembalikan

UInt32

UInt32 yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid UInt32 .

ArgumentNullException

Parameternya element adalah null.

Contoh

Contoh berikut membuat elemen dengan konten bilangan bulat yang tidak ditandatangani. Kemudian mengambil nilai dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

value=4294967295

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to String)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke String.

public:
 static explicit operator System::String ^(System::Xml::Linq::XElement ^ element);

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As String

Parameter

element: XElement

yang XElement akan dilemparkan ke String.

Mengembalikan

String

String yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Contoh

Contoh berikut membuat elemen dengan konten string. Kemudian mengambil nilai dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

(string)root=abc def ghi

Keterangan

XElement Jika memiliki turunan, nilai string yang digabungkan dari semua teks elemen dan teks turunan dikembalikan.

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to TimeSpan)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke TimeSpan.

public:
 static explicit operator TimeSpan(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As TimeSpan

Parameter

element: XElement

yang XElement akan dilemparkan ke TimeSpan.

Mengembalikan

TimeSpan

TimeSpan yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid TimeSpan .

ArgumentNullException

Parameternya element adalah null.

Contoh

Contoh berikut membuat elemen dengan konten rentang waktu. Kemudian mengambil nilai dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

value=01:05:30

Keterangan

Perilaku adalah lax saat mentransmisikan ke TimeSpan dari atribut atau elemen. Bahkan jika nilai atribut atau elemen tidak diformat persis sesuai spesifikasi W3C, nilainya dikonversi dengan tepat menjadi TimeSpan.

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to UInt64)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke UInt64.

public:
 static explicit operator System::UInt64(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As ULong

Parameter

element: XElement

yang XElement akan dilemparkan ke UInt64.

Mengembalikan

UInt64

UInt64 yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid UInt64 .

ArgumentNullException

Parameternya element adalah null.

InvalidOperationException

elementadalah null.

Contoh

Contoh berikut membuat elemen dengan konten bilangan bulat panjang yang tidak ditandatangani. Kemudian mengambil nilai dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

value=18446744073709551615

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<Int32>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari Int32.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Integer)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> .Int32

Mengembalikan

Nullable<Int32>

Nullable<T> dari Int32 yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak null dan tidak berisi nilai yang valid Int32 .

Contoh

Contoh berikut membuat elemen dengan konten bilangan bulat yang tidak ditandatangani. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

Nullable integer: value=2147483647

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Single)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Single.

public:
 static explicit operator float(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As Single

Parameter

element: XElement

yang XElement akan dilemparkan ke Single.

Mengembalikan

Single

Single yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid Single .

ArgumentNullException

Parameternya element adalah null.

InvalidOperationException

elementadalah null.

Contoh

Contoh berikut membuat elemen dengan konten titik floating presisi tunggal. Kemudian mengambil nilai dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

value=3.402823E+38

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<Guid>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari Guid.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Guid)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> .Guid

Mengembalikan

Nullable<Guid>

Nullable<T> dari Guid yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak null dan tidak berisi nilai yang valid Guid .

Contoh

Contoh berikut membuat elemen dengan konten guid. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

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

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<Boolean>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari Boolean.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Boolean)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> .Boolean

Mengembalikan

Nullable<Boolean>

Nullable<T> dari Boolean yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak null dan tidak berisi nilai yang valid Boolean .

Contoh

Contoh berikut membuat elemen dengan konten boolean. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

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

Keterangan

Saat mengonversi ke Nullable<T> dari Boolean atribut atau elemen, nilai yang diizinkan adalah "0", "1", dan string apa pun yang menghasilkan "true" atau "false" setelah pemangkasan dan konversi ke huruf kecil.

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<Decimal>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari Decimal.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Decimal)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> .Decimal

Mengembalikan

Nullable<Decimal>

Nullable<T> dari Decimal yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak null dan tidak berisi nilai yang valid Decimal .

Contoh

Contoh berikut membuat elemen dengan konten desimal. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

Nullable decimal: value=79228162514264337593543950335

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Boolean)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Boolean.

public:
 static explicit operator bool(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As Boolean

Parameter

element: XElement

yang XElement akan dilemparkan ke Boolean.

Mengembalikan

Boolean

Boolean yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid Boolean .

ArgumentNullException

Parameternya element adalah null.

Contoh

Contoh berikut membuat beberapa elemen dengan nilai boolean. Kemudian melemparkannya ke 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)

Contoh ini mencetak output berikut:

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

Keterangan

Saat mengonversi ke Boolean dari atribut atau elemen, nilai yang diizinkan adalah "0", "1", dan string apa pun yang menghasilkan "true" atau "false" setelah pemangkasan dan konversi ke huruf kecil.

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to DateTime)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke DateTime.

public:
 static explicit operator DateTime(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As DateTime

Parameter

element: XElement

yang XElement akan dilemparkan ke DateTime.

Mengembalikan

DateTime

DateTime yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid DateTime .

ArgumentNullException

Parameternya element adalah null.

InvalidOperationException

elementadalah null.

Contoh

Contoh berikut membuat elemen dengan konten tanggal dan waktu. Kemudian melemparkannya ke untuk DateTime mengambil nilai.

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

Contoh ini mencetak output berikut:

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

Keterangan

Ruang nilai atribut atau elemen yang berisi konten tanggal dan waktu terkait erat dengan tanggal dan waktu yang dijelaskan dalam ISO 8601. Saat membuat atribut atau elemen yang berisi konten tanggal dan waktu, nilai atribut atau elemen diformat sesuai spesifikasi W3C. Lihat spesifikasi W3C untuk detail selengkapnya.

Perilaku adalah lax saat mentransmisikan ke DateTime dari atribut atau elemen. Bahkan jika nilai atribut atau elemen tidak diformat persis sesuai spesifikasi W3C, nilainya dikonversi dengan tepat menjadi DateTime.

Operator konversi ini menggunakan CultureInfo.InvariantCulture untuk mengonversi dari DateTime.

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to DateTimeOffset)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XAttribute ke DateTimeOffset.

public:
 static explicit operator DateTimeOffset(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As DateTimeOffset

Parameter

element: XElement

yang XElement akan dilemparkan ke DateTimeOffset.

Mengembalikan

DateTimeOffset

DateTimeOffset yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid DateTimeOffset .

ArgumentNullException

Parameternya element adalah null.

InvalidOperationException

elementadalah null.

Contoh

Contoh berikut membuat elemen dengan konten tanggal dan waktu. Kemudian dilemparkan ke untuk DateTimeOffset mengambil nilai.

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)

Contoh ini mencetak output berikut:

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

Keterangan

Operator konversi ini menggunakan XmlConvert kelas untuk melakukan konversi.

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Double)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Double.

public:
 static explicit operator double(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As Double

Parameter

element: XElement

yang XElement akan dilemparkan ke Double.

Mengembalikan

Double

Double yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid Double .

ArgumentNullException

Parameternya element adalah null.

InvalidOperationException

elementadalah null.

Contoh

Contoh berikut membuat atribut dengan double konten. Kemudian mengambil nilai dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

value=1.79769313486231E+308

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Guid)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Guid.

public:
 static explicit operator Guid(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As Guid

Parameter

element: XElement

yang XElement akan dilemparkan ke Guid.

Mengembalikan

Guid

Guid yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid Guid .

ArgumentNullException

Parameternya element adalah null.

InvalidOperationException

elementadalah null.

Contoh

Contoh berikut membuat elemen dengan panduan sebagai konten. Kemudian mengambil nilai dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

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

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Decimal)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Decimal.

public:
 static explicit operator System::Decimal(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As Decimal

Parameter

element: XElement

yang XElement akan dilemparkan ke Decimal.

Mengembalikan

Decimal

Decimal yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid Decimal .

ArgumentNullException

Parameternya element adalah null.

InvalidOperationException

elementadalah null.

Contoh

Contoh berikut membuat elemen dengan nilai desimal. Kemudian mengambil nilai atribut dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

value=79228162514264337593543950335

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Int64)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Int64.

public:
 static explicit operator long(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As Long

Parameter

element: XElement

yang XElement akan dilemparkan ke Int64.

Mengembalikan

Int64

Int64 yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid Int64 .

ArgumentNullException

Parameternya element adalah null.

InvalidOperationException

elementadalah null.

Contoh

Contoh berikut membuat elemen dengan bilangan bulat panjang sebagai konten. Kemudian mengambil nilai elemen dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

value=9223372036854775807

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<Double>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari Double.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of Double)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> .Double

Mengembalikan

Nullable<Double>

Nullable<T> dari Double yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak null dan tidak berisi nilai yang valid Double .

Contoh

Contoh berikut membuat elemen dengan konten floating point presisi ganda. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

Nullable double: value=1.79769313486231E+308

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<DateTime>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari DateTime.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of DateTime)

Parameter

element: XElement

yang XElement akan dilemparkan ke Nullable<T> .DateTime

Mengembalikan

Nullable<DateTime>

Nullable<T> dari DateTime yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak null dan tidak berisi nilai yang valid DateTime .

Contoh

Contoh berikut membuat elemen dengan tanggal dan waktu sebagai konten. Kemudian mengambil nilai dengan mentransmisikan ke Nullable<T> dari 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"))

Contoh ini mencetak output berikut:

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

Keterangan

Perilakunya adalah lax saat mentransmisikan ke Nullable<T> dari atribut DateTime atau elemen. Bahkan jika nilai atribut atau elemen tidak diformat persis sesuai spesifikasi W3C, nilainya dikonversi dengan tepat ke Nullable<T> dari DateTime.

Operator konversi ini menggunakan CultureInfo.InvariantCulture untuk mengonversi dari DateTime.

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Nullable<DateTimeOffset>)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Nullable<T> dari DateTimeOffset.

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

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

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

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

Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of DateTimeOffset)

Parameter

element: XElement

XElement yang akan dilemparkan ke Nullable<T> dari DateTimeOffset.

Mengembalikan

Nullable<DateTimeOffset>

Nullable<T> dari DateTimeOffset yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak null dan tidak berisi nilai yang valid DateTimeOffset .

Contoh

Contoh berikut membuat elemen dengan konten tanggal dan waktu. Kemudian dilemparkan ke Nullable<T> dari DateTimeOffset untuk mengambil nilai.

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)

Contoh ini mencetak output berikut:

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

Keterangan

Operator konversi ini menggunakan XmlConvert kelas untuk melakukan konversi.

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Explicit(XElement to Int32)

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

API ini bukan kompatibel CLS.

Transmisikan nilai ini XElement ke Int32.

public:
 static explicit operator int(System::Xml::Linq::XElement ^ element);

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

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

Public Shared Narrowing Operator CType (element As XElement) As Integer

Parameter

element: XElement

yang XElement akan dilemparkan ke Int32.

Mengembalikan

Int32

Int32 yang berisi konten ini XElement.

Atribut: CLSCompliantAttribute

Pengecualian

FormatException

Elemen tidak berisi nilai yang valid Int32 .

ArgumentNullException

Parameternya element adalah null.

Contoh

Contoh berikut membuat elemen dengan bilangan bulat sebagai konten. Kemudian mengambil nilai dengan mentransmisikan ke 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)

Contoh ini mencetak output berikut:

value=2147483647

Lihat juga

Gambaran umum LINQ ke XML

Berlaku untuk

Bagikan melalui

XElement.Explicit Operator

Definisi

Overload

Explicit(XElement to Nullable<Int64>)

Parameter

Mengembalikan

Pengecualian

Contoh

Lihat juga

Berlaku untuk

Explicit(XElement to Nullable<Single>)

Parameter

Mengembalikan

Pengecualian

Contoh

Lihat juga

Berlaku untuk

Explicit(XElement to Nullable<TimeSpan>)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Explicit(XElement to Nullable<UInt32>)

Parameter

Mengembalikan

Pengecualian

Contoh

Lihat juga

Berlaku untuk

Explicit(XElement to Nullable<UInt64>)

Parameter

Mengembalikan

Pengecualian

Contoh

Lihat juga

Berlaku untuk

Explicit(XElement to UInt32)

Parameter

Mengembalikan

Pengecualian

Contoh

Lihat juga

Berlaku untuk

Explicit(XElement to String)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Explicit(XElement to TimeSpan)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Explicit(XElement to UInt64)

Parameter

Mengembalikan

Pengecualian

Contoh

Lihat juga

Berlaku untuk

Explicit(XElement to Nullable<Int32>)

Parameter

Mengembalikan

Pengecualian

Contoh

Lihat juga

Berlaku untuk

Explicit(XElement to Single)

Parameter

Mengembalikan

Pengecualian