XElement.Explicit Opérateur

Définition

Espace de noms:: System.Xml.Linq

Assemblys:: System.Xml.Linq.dll, System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: System.Xml.XDocument.dll

Assembly:: netstandard.dll

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

Nom	Description
Explicit(XElement to Nullable<Int64>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de Int64.
Explicit(XElement to Nullable<Single>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de Single.
Explicit(XElement to Nullable<TimeSpan>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de TimeSpan.
Explicit(XElement to Nullable<UInt32>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de UInt32.
Explicit(XElement to Nullable<UInt64>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de UInt64.
Explicit(XElement to UInt32)	Cassez la valeur de cette XElement valeur en UInt32.
Explicit(XElement to String)	Cassez la valeur de cette XElement valeur en String.
Explicit(XElement to TimeSpan)	Cassez la valeur de cette XElement valeur en TimeSpan.
Explicit(XElement to UInt64)	Cassez la valeur de cette XElement valeur en UInt64.
Explicit(XElement to Nullable<Int32>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de Int32.
Explicit(XElement to Single)	Cassez la valeur de cette XElement valeur en Single.
Explicit(XElement to Nullable<Guid>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de Guid.
Explicit(XElement to Nullable<Boolean>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de Boolean.
Explicit(XElement to Nullable<Decimal>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de Decimal.
Explicit(XElement to Boolean)	Cassez la valeur de cette XElement valeur en Boolean.
Explicit(XElement to DateTime)	Cassez la valeur de cette XElement valeur en DateTime.
Explicit(XElement to DateTimeOffset)	Cassez la valeur de cette XAttribute valeur en DateTimeOffset.
Explicit(XElement to Double)	Cassez la valeur de cette XElement valeur en Double.
Explicit(XElement to Guid)	Cassez la valeur de cette XElement valeur en Guid.
Explicit(XElement to Decimal)	Cassez la valeur de cette XElement valeur en Decimal.
Explicit(XElement to Int64)	Cassez la valeur de cette XElement valeur en Int64.
Explicit(XElement to Nullable<Double>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de Double.
Explicit(XElement to Nullable<DateTime>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)	Convertissez la valeur de cette XElement valeur en Nullable<T> un de DateTimeOffset.
Explicit(XElement to Int32)	Cassez la valeur de cette XElement valeur en Int32.

Explicit(XElement to Nullable<Int64>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>Int64.

Retours

Nullable<Int64>

Un Nullable<T> de Int64 ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide Int64 .

Exemples

L’exemple suivant crée un élément avec du contenu entier long. Il récupère ensuite la valeur en cas de conversion en 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"))

Cet exemple produit la sortie suivante :

Nullable ulong: value=9223372036854775807

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<Single>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>Single.

Retours

Nullable<Single>

Un Nullable<T> de Single ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide Single .

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

Cet exemple produit la sortie suivante :

Nullable Single: value=3.402823E+38

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<TimeSpan>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>TimeSpan.

Retours

Nullable<TimeSpan>

Un Nullable<T> de TimeSpan ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide TimeSpan .

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

Cet exemple produit la sortie suivante :

Nullable TimeSpan: value=01:05:30

Remarques

L’espace 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 en Nullable<T> un attribut TimeSpan 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 une Nullable<T> valeur de TimeSpan.

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<UInt32>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>UInt32.

Retours

Nullable<UInt32>

Un Nullable<T> de UInt32 ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide UInt32 .

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

Cet exemple produit la sortie suivante :

Nullable uint: value=4294967295

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<UInt64>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>UInt64.

Retours

Nullable<UInt64>

Un Nullable<T> de UInt64 ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide UInt64 .

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

Cet exemple produit la sortie suivante :

Nullable ulong: value=9223372036854775807

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to UInt32)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en UInt32.

Retours

UInt32

Qui UInt32 contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide UInt32 .

ArgumentNullException

Le element paramètre est 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

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to String)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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)>]
static member op_Explicit : System.Xml.Linq.XElement -> string

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

Paramètres

element: XElement

À XElement convertir en String.

Retours

String

Qui String contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

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 le nombre XElement d’enfants est atteint, la valeur de chaîne concaténée de l’ensemble du texte de l’élément et du texte du descendant est retournée.

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to TimeSpan)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en TimeSpan.

Retours

TimeSpan

Qui TimeSpan contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide TimeSpan .

ArgumentNullException

Le element paramètre est 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

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

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to UInt64)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en UInt64.

Retours

UInt64

Qui UInt64 contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide UInt64 .

ArgumentNullException

Le element paramètre est null.

InvalidOperationException

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

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<Int32>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>Int32.

Retours

Nullable<Int32>

Un Nullable<T> de Int32 ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide Int32 .

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

Cet exemple produit la sortie suivante :

Nullable integer: value=2147483647

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Single)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en Single.

Retours

Single

Qui Single contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide Single .

ArgumentNullException

Le element paramètre est null.

InvalidOperationException

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

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<Guid>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>Guid.

Retours

Nullable<Guid>

Un Nullable<T> de Guid ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide Guid .

Exemples

L’exemple suivant crée un élément avec du contenu guid. Il récupère ensuite la valeur en cas de conversion en 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"))

Cet exemple produit la sortie suivante :

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

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<Boolean>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>Boolean.

Retours

Nullable<Boolean>

Un Nullable<T> de Boolean ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide Boolean .

Exemples

L’exemple suivant crée un élément avec du contenu booléen. Il récupère ensuite la valeur en cas de conversion en 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"))

Cet exemple produit la sortie suivante :

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

Remarques

Lors de la conversion à Nullable<T> partir d’un Boolean 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

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<Decimal>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>Decimal.

Retours

Nullable<Decimal>

Un Nullable<T> de Decimal ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide Decimal .

Exemples

L’exemple suivant crée un élément avec du contenu décimal. Il récupère ensuite la valeur en cas de conversion en 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"))

Cet exemple produit la sortie suivante :

Nullable decimal: value=79228162514264337593543950335

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Boolean)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en Boolean.

Retours

Boolean

Qui Boolean contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide Boolean .

ArgumentNullException

Le element paramètre est null.

Exemples

L’exemple suivant crée des éléments avec des valeurs booléennes. Il les caste ensuite 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

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to DateTime)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en DateTime.

Retours

DateTime

Qui DateTime contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide DateTime .

ArgumentNullException

Le element paramètre est null.

InvalidOperationException

element a la valeur null.

Exemples

L’exemple suivant crée un élément avec du contenu de date et d’heure. Il le 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 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 DateTime 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 DateTime.

Cet opérateur de conversion utilise CultureInfo.InvariantCulture pour convertir à partir d’un DateTime.

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to DateTimeOffset)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XAttribute valeur 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 convertir en DateTimeOffset.

Retours

DateTimeOffset

Qui DateTimeOffset contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide DateTimeOffset .

ArgumentNullException

Le element paramètre est null.

InvalidOperationException

element a la valeur null.

Exemples

L’exemple suivant crée un élément avec du contenu de date et d’heure. Il effectue ensuite un cast 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

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Double)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en Double.

Retours

Double

Qui Double contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide Double .

ArgumentNullException

Le element paramètre est null.

InvalidOperationException

element a la valeur null.

Exemples

L’exemple suivant crée un attribut avec double du contenu. Il récupère ensuite la valeur en cas de conversion en 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)

Cet exemple produit la sortie suivante :

value=1.79769313486231E+308

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Guid)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en Guid.

Retours

Guid

Qui Guid contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide Guid .

ArgumentNullException

Le element paramètre est null.

InvalidOperationException

element a la valeur null.

Exemples

L’exemple suivant crée un élément avec un guid en tant que contenu. Il récupère ensuite la valeur en cas de conversion en 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)

Cet exemple produit la sortie suivante :

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

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Decimal)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en Decimal.

Retours

Decimal

Qui Decimal contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide Decimal .

ArgumentNullException

Le element paramètre est null.

InvalidOperationException

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 cas de conversion 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

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Int64)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en Int64.

Retours

Int64

Qui Int64 contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide Int64 .

ArgumentNullException

Le element paramètre est null.

InvalidOperationException

element a la valeur null.

Exemples

L’exemple suivant crée un élément avec un entier long en tant que contenu. Il récupère ensuite la valeur de l’élément en cas de conversion en 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)

Cet exemple produit la sortie suivante :

value=9223372036854775807

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<Double>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>Double.

Retours

Nullable<Double>

Un Nullable<T> de Double ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide Double .

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 conversion en 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"))

Cet exemple produit la sortie suivante :

Nullable double: value=1.79769313486231E+308

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<DateTime>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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 convertir en Nullable<T>DateTime.

Retours

Nullable<DateTime>

Un Nullable<T> de DateTime ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide DateTime .

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 conversion en 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"))

Cet exemple produit la sortie suivante :

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

Remarques

Le comportement est lax lors de la conversion en un Nullable<T> attribut DateTime 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 une Nullable<T> valeur de DateTime.

Cet opérateur de conversion utilise CultureInfo.InvariantCulture pour convertir à partir d’un DateTime.

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Nullable<DateTimeOffset>)

Important

Cette API n’est pas conforme CLS.

Convertissez la valeur de cette XElement valeur en Nullable<T> un 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)>]
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

La XElement conversion en Nullable<T> un de DateTimeOffset.

Retours

Nullable<DateTimeOffset>

Un Nullable<T> de DateTimeOffset ces éléments contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément n’est pas null et ne contient pas de valeur valide DateTimeOffset .

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> celui-ci DateTimeOffset pour 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

Vue d’ensemble de LINQ to XML

S’applique à

Explicit(XElement to Int32)

Important

Cette API n’est pas conforme CLS.

Cassez la valeur de cette XElement valeur en 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

Paramètres

element: XElement

À XElement convertir en Int32.

Retours

Int32

Qui Int32 contient le contenu de ce XElement.

Attributs: CLSCompliantAttribute

Exceptions

FormatException

L’élément ne contient pas de valeur valide Int32 .

ArgumentNullException

Le element paramètre est null.

Exemples

L’exemple suivant crée un élément avec un entier en tant que contenu. Il récupère ensuite la valeur en cas de conversion en 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)

Cet exemple produit la sortie suivante :

value=2147483647

Voir aussi

Vue d’ensemble de LINQ to XML

S’applique à

Commentaires

Cette page a-t-elle été utile ?