XElement.Explicit Opérateur
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
Explicit(XElement to Nullable<Int64>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de Int64.
Retours
Nullable<T> de Int64 qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur Int64 valide.
Exemples
L’exemple suivant crée un élément avec du contenu entier long. Il récupère ensuite la valeur en cas de Int64conversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable ulong: value=9223372036854775807
Voir aussi
S’applique à
Explicit(XElement to Nullable<Single>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de Single.
Retours
Nullable<T> de Single qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur Single valide.
Exemples
L’exemple suivant crée un élément avec un contenu à virgule flottante simple précision. Il récupère ensuite la valeur en cas de Singleconversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable Single: value=3.402823E+38
Voir aussi
S’applique à
Explicit(XElement to Nullable<TimeSpan>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de TimeSpan.
Retours
Nullable<T> de TimeSpan qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur TimeSpan valide.
Exemples
L’exemple suivant crée un élément avec du contenu d’intervalle de temps. Il récupère ensuite la valeur en cas de TimeSpanconversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable TimeSpan: value=01:05:30
Remarques
L’espace de valeur d’un attribut ou d’un élément qui contient du contenu d’intervalle de temps est étroitement lié au contenu de durée, comme décrit dans ISO 8601. Lors de la création d’un attribut ou d’un élément qui contient du contenu d’intervalle de temps, les valeurs d’attribut ou d’élément sont mises en forme conformément à la spécification W3C. Pour plus d’informations, consultez la spécification W3C.
Le comportement est lax lors de TimeSpan la conversion vers un Nullable<T> attribut ou un élément. Même si la valeur de l’attribut ou de l’élément n’est pas mise en forme exactement conformément à la spécification W3C, la valeur est correctement convertie en une Nullable<T> valeur de TimeSpan.
Voir aussi
S’applique à
Explicit(XElement to Nullable<UInt32>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de UInt32.
Retours
Nullable<T> de UInt32 qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur UInt32 valide.
Exemples
L’exemple suivant crée un élément avec du contenu entier non signé. Il récupère ensuite la valeur en cas de UInt32conversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable uint: value=4294967295
Voir aussi
S’applique à
Explicit(XElement to Nullable<UInt64>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de UInt64.
Retours
Nullable<T> de UInt64 qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur UInt64 valide.
Exemples
L’exemple suivant crée un élément avec un contenu entier long non signé. Il récupère ensuite la valeur en cas de UInt64conversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable ulong: value=9223372036854775807
Voir aussi
S’applique à
Explicit(XElement to UInt32)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
UInt32 qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur UInt32 valide.
Le paramètre element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec du contenu entier non signé. Il récupère ensuite la valeur en cas de conversion en 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)
Cet exemple produit la sortie suivante :
value=4294967295
Voir aussi
S’applique à
Explicit(XElement to String)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
String qui contient le contenu de ce XElement.
- Attributs
Exemples
L’exemple suivant crée un élément avec du contenu de chaîne. Il récupère ensuite la valeur en cas de conversion en 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)
Cet exemple produit la sortie suivante :
(string)root=abc def ghi
Remarques
Si l’élément XElement a des enfants, la valeur de chaîne concaténée de tout le texte de l’élément et le texte du descendant est retournée.
Voir aussi
S’applique à
Explicit(XElement to TimeSpan)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
TimeSpan qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur TimeSpan valide.
Le paramètre element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec du contenu d’intervalle de temps. Il récupère ensuite la valeur en cas de conversion en 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)
Cet exemple produit la sortie suivante :
value=01:05:30
Remarques
L’espace de valeur d’un attribut ou d’un élément qui contient du contenu d’intervalle de temps est étroitement lié au contenu de durée, comme décrit dans ISO 8601. Lors de la création d’un attribut ou d’un élément qui contient du contenu d’intervalle de temps, les valeurs d’attribut ou d’élément sont mises en forme conformément à la spécification W3C. Pour plus d’informations, consultez la spécification W3C.
Le comportement est lax lors de la conversion vers un TimeSpan attribut ou un élément. Même si l’attribut ou la valeur de l’élément n’est pas mis en forme exactement conformément à la spécification W3C, la valeur est correctement convertie en un TimeSpan.
Voir aussi
S’applique à
Explicit(XElement to UInt64)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
UInt64 qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur UInt64 valide.
Le paramètre element
a la valeur null
.
element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec un contenu entier long non signé. Il récupère ensuite la valeur en cas de conversion en 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)
Cet exemple produit la sortie suivante :
value=18446744073709551615
Voir aussi
S’applique à
Explicit(XElement to Nullable<Int32>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de Int32.
Retours
Nullable<T> de Int32 qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur Int32 valide.
Exemples
L’exemple suivant crée un élément avec du contenu entier non signé. Il récupère ensuite la valeur en cas de Int32conversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable integer: value=2147483647
Voir aussi
S’applique à
Explicit(XElement to Single)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
Single qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur Single valide.
Le paramètre element
a la valeur null
.
element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec un contenu à virgule flottante simple précision. Il récupère ensuite la valeur en cas de conversion en 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)
Cet exemple produit la sortie suivante :
value=3.402823E+38
Voir aussi
S’applique à
Explicit(XElement to Nullable<Guid>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de Guid.
Retours
Nullable<T> de Guid qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur Guid valide.
Exemples
L’exemple suivant crée un élément avec du contenu guid. Il récupère ensuite la valeur en cas de Guidconversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable Guid: value=3c1cc55b-baff-4b7a-9d17-077af3aa5730
Voir aussi
S’applique à
Explicit(XElement to Nullable<Boolean>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de Boolean.
Retours
Nullable<T> de Boolean qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur Boolean valide.
Exemples
L’exemple suivant crée un élément avec du contenu booléen. Elle récupère ensuite la valeur en mettant en Nullable<T> Booleanvaleur .
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"))
Cet exemple produit la sortie suivante :
Nullable Boolean: value1=True
Nullable Boolean: value2=False
Remarques
Lors de Boolean la conversion à Nullable<T> partir d’un attribut ou d’un élément, les valeurs autorisées sont « 0 », « 1 » et toute chaîne qui produit « true » ou « false » après la suppression et la conversion en minuscules.
Voir aussi
S’applique à
Explicit(XElement to Nullable<Decimal>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de Decimal.
Retours
Nullable<T> de Decimal qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur Decimal valide.
Exemples
L’exemple suivant crée un élément avec du contenu décimal. Il récupère ensuite la valeur en cas de Decimalconversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable decimal: value=79228162514264337593543950335
Voir aussi
S’applique à
Explicit(XElement to Boolean)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
Boolean qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur Boolean valide.
Le paramètre element
a la valeur null
.
Exemples
L’exemple suivant crée des éléments avec des valeurs booléennes. Il les a ensuite convertis en 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)
Cet exemple produit la sortie suivante :
(bool)BoolValue1=True
(bool)BoolValue2=False
Remarques
Lors de la conversion à Boolean partir d’un attribut ou d’un élément, les valeurs autorisées sont « 0 », « 1 » et toute chaîne qui produit « true » ou « false » après le découpage et la conversion en minuscules.
Voir aussi
S’applique à
Explicit(XElement to DateTime)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
DateTime qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur DateTime valide.
Le paramètre element
a la valeur null
.
element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec du contenu date et heure. Il la caste ensuite pour DateTime récupérer la valeur.
// 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)
Cet exemple produit la sortie suivante :
<Root>2006-10-06T12:30:00</Root>
dt=10/6/2006 12:30:00 PM
-----
<OrderDate>October 6, 2006</OrderDate>
orderDate=10/6/2006
Remarques
L’espace de valeur d’un attribut ou d’un élément qui contient du contenu de date et d’heure est étroitement lié aux dates et heures décrites dans ISO 8601. Lors de la création d’un attribut ou d’un élément qui contient du contenu de date et d’heure, les valeurs d’attribut ou d’élément sont mises en forme par spécification W3C. Pour plus d’informations, consultez la spécification W3C.
Le comportement est lax lors de la conversion vers un DateTime attribut ou un élément. Même si la valeur d’attribut ou d’élément n’est pas mise en forme exactement par la spécification W3C, la valeur est convertie de manière appropriée en un DateTime.
Cet opérateur de conversion utilise CultureInfo.InvariantCulture pour convertir à partir d’un DateTime.
Voir aussi
S’applique à
Explicit(XElement to DateTimeOffset)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XAttribute en 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
Paramètres
- element
- XElement
XElement à caster en DateTimeOffset.
Retours
DateTimeOffset qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur DateTimeOffset valide.
Le paramètre element
a la valeur null
.
element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec du contenu date et heure. Elle est ensuite castée pour DateTimeOffset récupérer la valeur.
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)
Cet exemple produit la sortie suivante :
<Root>
<Child>2006-10-06T12:30:00-07:00</Child>
</Root>
dt=10/6/2006 12:30:00 PM -07:00
Remarques
Cet opérateur de conversion utilise la XmlConvert classe pour effectuer la conversion.
Voir aussi
S’applique à
Explicit(XElement to Double)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
Double qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur Double valide.
Le paramètre element
a la valeur null
.
element
a la valeur null
.
Exemples
L’exemple suivant crée un attribut avec double
du contenu. Elle récupère ensuite la valeur en mettant en Doublevaleur .
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)
Cet exemple produit la sortie suivante :
value=1.79769313486231E+308
Voir aussi
S’applique à
Explicit(XElement to Guid)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
Guid qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur Guid valide.
Le paramètre element
a la valeur null
.
element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec un guid en tant que contenu. Elle récupère ensuite la valeur en mettant en Guidvaleur .
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)
Cet exemple produit la sortie suivante :
value=3c1cc55b-baff-4b7a-9d17-077af3aa5730
Voir aussi
S’applique à
Explicit(XElement to Decimal)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
Decimal qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur Decimal valide.
Le paramètre element
a la valeur null
.
element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec une valeur décimale. Il récupère ensuite la valeur de l’attribut en le mettant en 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)
Cet exemple produit la sortie suivante :
value=79228162514264337593543950335
Voir aussi
S’applique à
Explicit(XElement to Int64)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
Int64 qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur Int64 valide.
Le paramètre element
a la valeur null
.
element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec un entier long sous forme de contenu. Il récupère ensuite la valeur de l’élément en le faisant passer Int64en .
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)
Cet exemple produit la sortie suivante :
value=9223372036854775807
Voir aussi
S’applique à
Explicit(XElement to Nullable<Double>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de Double.
Retours
Nullable<T> de Double qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur Double valide.
Exemples
L’exemple suivant crée un élément avec du contenu à virgule flottante double précision. Il récupère ensuite la valeur en cas de Doubleconversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable double: value=1.79769313486231E+308
Voir aussi
S’applique à
Explicit(XElement to Nullable<DateTime>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de DateTime.
Retours
Nullable<T> de DateTime qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur DateTime valide.
Exemples
L’exemple suivant crée un élément avec une date et une heure en tant que contenu. Il récupère ensuite la valeur en cas de DateTimeconversion en Nullable<T> .
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"))
Cet exemple produit la sortie suivante :
Nullable DateTime: value=10/6/2006 12:30:00 PM
Remarques
L’espace de valeur d’un attribut ou d’un élément qui contient le contenu de date et d’heure est étroitement lié aux dates et heures décrites dans ISO 8601. Lors de la création d’un attribut ou d’un élément qui contient du contenu de date et d’heure, les valeurs d’attribut ou d’élément sont mises en forme conformément à la spécification W3C. Pour plus d’informations, consultez la spécification W3C.
Le comportement est lax lors de DateTime la conversion vers un Nullable<T> attribut ou un élément. Même si la valeur de l’attribut ou de l’élément n’est pas mise en forme exactement conformément à la spécification W3C, la valeur est correctement convertie en une Nullable<T> valeur de DateTime.
Cet opérateur de conversion utilise CultureInfo.InvariantCulture pour convertir à partir d’un DateTime.
Voir aussi
S’applique à
Explicit(XElement to Nullable<DateTimeOffset>)
Important
Cette API n’est pas conforme CLS.
Castez la valeur de ce XElement en Nullable<T> de 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)
Paramètres
- element
- XElement
XElement à caster en Nullable<T> de DateTimeOffset.
Retours
Nullable<T> de DateTimeOffset qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément n’est pas null
et ne contient pas de valeur DateTimeOffset valide.
Exemples
L’exemple suivant crée un élément avec du contenu de date et d’heure. Il effectue ensuite un cast vers Nullable<T> lequel DateTimeOffset récupérer la valeur.
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)
Cet exemple produit la sortie suivante :
<Root>
<Child>2006-10-06T12:30:00-07:00</Child>
</Root>
dt=10/6/2006 12:30:00 PM -07:00
Remarques
Cet opérateur de conversion utilise la XmlConvert classe pour effectuer la conversion.
Voir aussi
S’applique à
Explicit(XElement to Int32)
Important
Cette API n’est pas conforme CLS.
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
Paramètres
Retours
Int32 qui contient le contenu de ce XElement.
- Attributs
Exceptions
L'élément ne contient pas de valeur Int32 valide.
Le paramètre element
a la valeur null
.
Exemples
L’exemple suivant crée un élément avec un entier sous forme de contenu. Elle récupère ensuite la valeur en mettant en Int32valeur .
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)
Cet exemple produit la sortie suivante :
value=2147483647