XElement.Explicit Operator
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
Explicit(XElement to Nullable<Int64>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von Int64.
Gibt zurück
Eine Nullable<T> davon Int64 , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen Int64 Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit langen ganzzahligen Inhalten erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .Int64
XElement root = new XElement("Root",
new XElement("Value", 9223372036854775807)
);
ulong? value = (ulong?)root.Element("Value");
Console.WriteLine("Nullable ulong: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value>9223372036854775807</Value>
</Root>
Dim value As Nullable(Of ULong) = CType(root.Element("Value"), Nullable(Of ULong))
Console.WriteLine("Nullable ulong: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable ulong: value=9223372036854775807
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<Single>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von Single.
Gibt zurück
Eine Nullable<T> davon Single , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen Single Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit einem Gleitkommainhalt mit einfacher Genauigkeit erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .Single
XElement root = new XElement("Root",
new XElement("Value", 3.402823e38)
);
float? value = (float?)root.Element("Value");
Console.WriteLine("Nullable Single: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value>3.402823e38</Value>
</Root>
Dim value As Nullable(Of Single) = CType(root.Element("Value"), Nullable(Of Single))
Console.WriteLine("Nullable Single: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable Single: value=3.402823E+38
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<TimeSpan>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von TimeSpan.
Gibt zurück
Eine Nullable<T> davon TimeSpan , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen TimeSpan Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit Inhaltsdauer erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .TimeSpan
XElement root = new XElement("Root",
new XElement("Value", new TimeSpan(1, 5, 30))
);
TimeSpan? value = (TimeSpan?)root.Element("Value");
Console.WriteLine("Nullable TimeSpan: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value><%= New TimeSpan(1, 5, 30) %></Value>
</Root>
Dim value As Nullable(Of TimeSpan) = CType(root.Element("Value"), Nullable(Of TimeSpan))
Console.WriteLine("Nullable TimeSpan: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable TimeSpan: value=01:05:30
Hinweise
Der Wertbereich eines Attributs oder Elements, das Inhalt der Zeitspanne enthält, hängt eng mit dem Dauerinhalt zusammen, wie in ISO 8601 beschrieben. Beim Erstellen eines Attributs oder Elements, das Einen Zeitrauminhalt enthält, werden die Attribut- oder Elementwerte gemäß der W3C-Spezifikation formatiert. Weitere Details finden Sie in der W3C-Spezifikation.
Das Verhalten ist beim Umwandeln in ein Nullable<T> Von TimeSpan einem Attribut oder Element lax. Auch wenn der Attribut- oder Elementwert nicht exakt gemäß der W3C-Spezifikation formatiert ist, wird der Wert entsprechend in eins Nullable<T>TimeSpankonvertiert.
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<UInt32>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von UInt32.
Gibt zurück
Eine Nullable<T> davon UInt32 , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen UInt32 Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit nicht signierten ganzzahligen Inhalten erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .UInt32
XElement root = new XElement("Root",
new XElement("Value", 4294967295)
);
uint? value = (uint?)root.Element("Value");
Console.WriteLine("Nullable uint: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value>4294967295</Value>
</Root>
Dim value As Nullable(Of UInteger) = CType(root.Element("Value"), Nullable(Of UInteger))
Console.WriteLine("Nullable uint: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable uint: value=4294967295
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<UInt64>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von UInt64.
Gibt zurück
Eine Nullable<T> davon UInt64 , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen UInt64 Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit nicht signierten ganzzahligen Inhalten erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .UInt64
XElement root = new XElement("Root",
new XElement("Value", 9223372036854775807)
);
ulong? value = (ulong?)root.Element("Value");
Console.WriteLine("Nullable ulong: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value>9223372036854775807</Value>
</Root>
Dim value As Nullable(Of ULong) = CType(root.Element("Value"), Nullable(Of ULong))
Console.WriteLine("Nullable ulong: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable ulong: value=9223372036854775807
Weitere Informationen
Gilt für:
Explicit(XElement to UInt32)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A UInt32 , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen UInt32 Wert.
Der element Parameter ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit nicht signierten ganzzahligen Inhalten erstellt. Anschließend wird der Wert durch Umwandlung in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
value=4294967295
Weitere Informationen
Gilt für:
Explicit(XElement to String)
Wichtig
Diese API ist nicht CLS-kompatibel.
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)>]
static member op_Explicit : System.Xml.Linq.XElement -> string
Public Shared Narrowing Operator CType (element As XElement) As String
Parameter
Gibt zurück
A String , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Beispiele
Im folgenden Beispiel wird ein Element mit Zeichenfolgeninhalt erstellt. Anschließend wird der Wert durch Umwandlung in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
(string)root=abc def ghi
Hinweise
Wenn die XElement untergeordneten Elemente vorhanden sind, wird der verkettete Zeichenfolgenwert des gesamten Texts des Elements und der Text des Nachfolgers zurückgegeben.
Weitere Informationen
Gilt für:
Explicit(XElement to TimeSpan)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A TimeSpan , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen TimeSpan Wert.
Der element Parameter ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit Inhaltsdauer erstellt. Anschließend wird der Wert durch Umwandlung in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
value=01:05:30
Hinweise
Der Wertbereich eines Attributs oder Elements, das Inhalt der Zeitspanne enthält, hängt eng mit dem Dauerinhalt zusammen, wie in ISO 8601 beschrieben. Beim Erstellen eines Attributs oder Elements, das Einen Zeitrauminhalt enthält, werden die Attribut- oder Elementwerte gemäß der W3C-Spezifikation formatiert. Weitere Details finden Sie in der W3C-Spezifikation.
Verhalten ist beim Umwandeln in ein TimeSpan Attribut oder Element lax. Auch wenn der Attribut- oder Elementwert nicht exakt gemäß der W3C-Spezifikation formatiert ist, wird der Wert entsprechend in ein .TimeSpan
Weitere Informationen
Gilt für:
Explicit(XElement to UInt64)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A UInt64 , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen UInt64 Wert.
Der element Parameter ist null.
element ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit nicht signierten ganzzahligen Inhalten erstellt. Anschließend wird der Wert durch Umwandlung in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
value=18446744073709551615
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<Int32>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von Int32.
Gibt zurück
Eine Nullable<T> davon Int32 , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen Int32 Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit nicht signierten ganzzahligen Inhalten erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .Int32
XElement root = new XElement("Root",
new XElement("Value", 2147483647)
);
int? value = (int?)root.Element("Value");
Console.WriteLine("Nullable integer: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value>2147483647</Value>
</Root>
Dim value As Nullable(Of Integer) = CType(root.Element("Value"), Nullable(Of Integer))
Console.WriteLine("Nullable integer: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable integer: value=2147483647
Weitere Informationen
Gilt für:
Explicit(XElement to Single)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A Single , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen Single Wert.
Der element Parameter ist null.
element ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit einem Gleitkommainhalt mit einfacher Genauigkeit erstellt. Anschließend wird der Wert durch Umwandlung in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
value=3.402823E+38
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<Guid>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von Guid.
Gibt zurück
Eine Nullable<T> davon Guid , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen Guid Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit GUID-Inhalt erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .Guid
XElement root = new XElement("Root",
new XElement("Value", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"))
);
Guid? value = (Guid?)root.Element("Value");
Console.WriteLine("Nullable Guid: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value><%= New Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730") %></Value>
</Root>
Dim value As Nullable(Of Guid) = CType(root.Element("Value"), Nullable(Of Guid))
Console.WriteLine("Nullable Guid: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable Guid: value=3c1cc55b-baff-4b7a-9d17-077af3aa5730
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<Boolean>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von Boolean.
Gibt zurück
Eine Nullable<T> davon Boolean , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen Boolean Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit booleschen Inhalten erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .Boolean
XElement root = new XElement("Root",
new XElement("BoolValue1", true),
new XElement("BoolValue2", false));
bool? bool1 = (bool?)root.Element("BoolValue1");
bool? bool2 = (bool?)root.Element("BoolValue2");
Console.WriteLine("Nullable Boolean: value1={0}", bool1);
Console.WriteLine("Nullable Boolean: value2={0}", bool2);
Dim root As XElement = _
<Root>
<BoolValue1>true</BoolValue1>
<BoolValue2>false</BoolValue2>
</Root>
Dim value1 As Nullable(Of Boolean) = CType(root.Element("BoolValue1"), Nullable(Of Boolean))
Dim value2 As Nullable(Of Boolean) = CType(root.Element("BoolValue2"), Nullable(Of Boolean))
Console.WriteLine("Nullable Boolean: value1={0}", IIf(value1.HasValue, value1.ToString(), "null"))
Console.WriteLine("Nullable Boolean: value2={0}", IIf(value2.HasValue, value2.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable Boolean: value1=True
Nullable Boolean: value2=False
Hinweise
Bei der Konvertierung Nullable<T>Boolean von einem Attribut oder Element sind zulässige Werte "0", "1" und eine beliebige Zeichenfolge, die nach dem Kürzen und Konvertieren in Kleinbuchstaben "true" oder "false" erzeugt.
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<Decimal>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von Decimal.
Gibt zurück
Eine Nullable<T> davon Decimal , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen Decimal Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit Dezimalinhalt erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .Decimal
XElement root = new XElement("Root",
new XElement("Value", "79228162514264337593543950335")
);
decimal? value = (decimal?)root.Element("Value");
Console.WriteLine("Nullable decimal: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value>79228162514264337593543950335</Value>
</Root>
Dim value As Nullable(Of Decimal) = CType(root.Element("Value"), Nullable(Of Decimal))
Console.WriteLine("Nullable decimal: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable decimal: value=79228162514264337593543950335
Weitere Informationen
Gilt für:
Explicit(XElement to Boolean)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A Boolean , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen Boolean Wert.
Der element Parameter ist null.
Beispiele
Im folgenden Beispiel werden einige Elemente mit booleschen Werten erstellt. Es wandelt sie dann in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
(bool)BoolValue1=True
(bool)BoolValue2=False
Hinweise
Bei der Konvertierung Boolean aus einem Attribut oder Element sind zulässige Werte "0", "1" und eine beliebige Zeichenfolge, die nach dem Kürzen und Konvertieren in Kleinbuchstaben "true" oder "false" erzeugt.
Weitere Informationen
Gilt für:
Explicit(XElement to DateTime)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A DateTime , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen DateTime Wert.
Der element Parameter ist null.
element ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit Datums- und Uhrzeitinhalt erstellt. Anschließend wandelt sie in DateTime den Wert um.
// 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
<Root>2006-10-06T12:30:00</Root>
dt=10/6/2006 12:30:00 PM
-----
<OrderDate>October 6, 2006</OrderDate>
orderDate=10/6/2006
Hinweise
Der Wertbereich eines Attributs oder Elements, das Datums- und Uhrzeitinhalte enthält, hängt eng mit den Datums- und Uhrzeitangaben zusammen, die in ISO 8601 beschrieben werden. Beim Erstellen eines Attributs oder Elements, das Datums- und Uhrzeitinhalte enthält, werden die Attribut- oder Elementwerte gemäß der W3C-Spezifikation formatiert. Weitere Details finden Sie in der W3C-Spezifikation.
Verhalten ist beim Umwandeln in ein DateTime Attribut oder Element lax. Auch wenn der Attribut- oder Elementwert nicht exakt gemäß der W3C-Spezifikation formatiert ist, wird der Wert entsprechend in ein .DateTime
Dieser Konvertierungsoperator verwendet CultureInfo.InvariantCulture zum Konvertieren aus einem DateTime.
Weitere Informationen
Gilt für:
Explicit(XElement to DateTimeOffset)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XAttribute Werts in ein 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
Der XElement zu umwandelnde DateTimeOffsetIn .
Gibt zurück
A DateTimeOffset , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen DateTimeOffset Wert.
Der element Parameter ist null.
element ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit Datums- und Uhrzeitinhalt erstellt. Anschließend wird der Wert abgerufen DateTimeOffset .
XElement root = new XElement("Root",
new XElement("Child", new DateTimeOffset(new DateTime(2006, 10, 6, 12, 30, 0)))
);
Console.WriteLine(root);
DateTimeOffset dt = (DateTimeOffset)root.Element("Child");
Console.WriteLine("dt={0}", dt);
Dim root As XElement = _
<Root>
<Child><%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %></Child>
</Root>
Console.WriteLine(root)
Dim dt As DateTimeOffset = CType(root.<Child>(0), DateTimeOffset)
Console.WriteLine("dt={0}", dt)
Dieses Beispiel erzeugt die folgende Ausgabe:
<Root>
<Child>2006-10-06T12:30:00-07:00</Child>
</Root>
dt=10/6/2006 12:30:00 PM -07:00
Hinweise
Dieser Konvertierungsoperator verwendet die XmlConvert Klasse, um die Konvertierung durchzuführen.
Weitere Informationen
Gilt für:
Explicit(XElement to Double)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A Double , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen Double Wert.
Der element Parameter ist null.
element ist null.
Beispiele
Im folgenden Beispiel wird ein Attribut mit double Inhalt erstellt. Anschließend wird der Wert durch Umwandlung in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
value=1.79769313486231E+308
Weitere Informationen
Gilt für:
Explicit(XElement to Guid)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A Guid , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen Guid Wert.
Der element Parameter ist null.
element ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit einer GUID als Inhalt erstellt. Anschließend wird der Wert durch Umwandlung in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
value=3c1cc55b-baff-4b7a-9d17-077af3aa5730
Weitere Informationen
Gilt für:
Explicit(XElement to Decimal)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A Decimal , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen Decimal Wert.
Der element Parameter ist null.
element ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit einem Dezimalwert erstellt. Anschließend wird der Wert des Attributs durch Umwandlung in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
value=79228162514264337593543950335
Weitere Informationen
Gilt für:
Explicit(XElement to Int64)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A Int64 , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen Int64 Wert.
Der element Parameter ist null.
element ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit einer langen ganzzahligen Zahl als Inhalt erstellt. Anschließend wird der Wert des Elements durch Umwandlung in Int64das Element abgerufen.
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)
Dieses Beispiel erzeugt die folgende Ausgabe:
value=9223372036854775807
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<Double>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von Double.
Gibt zurück
Eine Nullable<T> davon Double , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen Double Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit Gleitkommainhalt mit doppelter Genauigkeit erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .Double
XElement root = new XElement("Root",
new XElement("Value", 1.79769313486231e308)
);
double? value = (double?)root.Element("Value");
Console.WriteLine("Nullable double: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value>1.79769313486231e308</Value>
</Root>
Dim value As Nullable(Of Double) = CType(root.Element("Value"), Nullable(Of Double))
Console.WriteLine("Nullable double: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable double: value=1.79769313486231E+308
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<DateTime>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zu gegossene Nullable<T> von DateTime.
Gibt zurück
Eine Nullable<T> davon DateTime , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen DateTime Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit einem Datum und einer Uhrzeit als Inhalt erstellt. Anschließend wird der Wert durch Umwandlung in Nullable<T> .DateTime
XElement root = new XElement("Root",
new XElement("Value", new DateTime(2006, 10, 6, 12, 30, 0))
);
DateTime? value = (DateTime?)root.Element("Value");
Console.WriteLine("Nullable DateTime: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
<Root>
<Value><%= New DateTime(2006, 10, 6, 12, 30, 0) %></Value>
</Root>
Dim value As Nullable(Of DateTime) = CType(root.Element("Value"), Nullable(Of DateTime))
Console.WriteLine("Nullable DateTime: value={0}", IIf(value.HasValue, value.ToString(), "null"))
Dieses Beispiel erzeugt die folgende Ausgabe:
Nullable DateTime: value=10/6/2006 12:30:00 PM
Hinweise
Der Wertbereich eines Attributs oder Elements, das Datums- und Uhrzeitinhalte enthält, hängt eng mit den Datums- und Uhrzeitangaben zusammen, die in ISO 8601 beschrieben werden. Beim Erstellen eines Attributs oder Elements, das Datums- und Uhrzeitinhalte enthält, werden die Attribut- oder Elementwerte gemäß der W3C-Spezifikation formatiert. Weitere Details finden Sie in der W3C-Spezifikation.
Das Verhalten ist beim Umwandeln in ein Nullable<T> Von DateTime einem Attribut oder Element lax. Auch wenn der Attribut- oder Elementwert nicht exakt gemäß der W3C-Spezifikation formatiert ist, wird der Wert entsprechend in eins Nullable<T>DateTimekonvertiert.
Dieser Konvertierungsoperator verwendet CultureInfo.InvariantCulture zum Konvertieren aus einem DateTime.
Weitere Informationen
Gilt für:
Explicit(XElement to Nullable<DateTimeOffset>)
Wichtig
Diese API ist nicht CLS-kompatibel.
Wandeln Sie den Wert dieses XElement Werts in eine Nullable<T> von 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)>]
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
Der XElement zum Umwandeln in eine Nullable<T> von DateTimeOffset.
Gibt zurück
Eine Nullable<T> davon DateTimeOffset , die den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element ist nicht null und enthält keinen gültigen DateTimeOffset Wert.
Beispiele
Im folgenden Beispiel wird ein Element mit Datums- und Uhrzeitinhalt erstellt. Anschließend wird der Wert in Nullable<T> den DateTimeOffset Wert umgegossen.
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)
Dieses Beispiel erzeugt die folgende Ausgabe:
<Root>
<Child>2006-10-06T12:30:00-07:00</Child>
</Root>
dt=10/6/2006 12:30:00 PM -07:00
Hinweise
Dieser Konvertierungsoperator verwendet die XmlConvert Klasse, um die Konvertierung durchzuführen.
Weitere Informationen
Gilt für:
Explicit(XElement to Int32)
Wichtig
Diese API ist nicht CLS-kompatibel.
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
Gibt zurück
A Int32 , das den Inhalt dieses XElementInhalts enthält.
- Attribute
Ausnahmen
Das Element enthält keinen gültigen Int32 Wert.
Der element Parameter ist null.
Beispiele
Im folgenden Beispiel wird ein Element mit einer ganzen Zahl als Inhalt erstellt. Anschließend wird der Wert durch Umwandlung in 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)
Dieses Beispiel erzeugt die folgende Ausgabe:
value=2147483647