Partager via


XElement.Explicit Opérateur

Définition

Surcharges

Explicit(XElement to Nullable<Int64>)

Castez la valeur de ce XElement en Nullable<T> de Int64.

Explicit(XElement to Nullable<Single>)

Castez la valeur de ce XElement en Nullable<T> de Single.

Explicit(XElement to Nullable<TimeSpan>)

Castez la valeur de ce XElement en Nullable<T> de TimeSpan.

Explicit(XElement to Nullable<UInt32>)

Castez la valeur de ce XElement en Nullable<T> de UInt32.

Explicit(XElement to Nullable<UInt64>)

Castez la valeur de ce XElement en Nullable<T> de UInt64.

Explicit(XElement to UInt32)

Castez la valeur de ce XElement en UInt32.

Explicit(XElement to String)

Castez la valeur de ce XElement en String.

Explicit(XElement to TimeSpan)

Castez la valeur de ce XElement en TimeSpan.

Explicit(XElement to UInt64)

Castez la valeur de ce XElement en UInt64.

Explicit(XElement to Nullable<Int32>)

Castez la valeur de ce XElement en Nullable<T> de Int32.

Explicit(XElement to Single)

Castez la valeur de ce XElement en Single.

Explicit(XElement to Nullable<Guid>)

Castez la valeur de ce XElement en Nullable<T> de Guid.

Explicit(XElement to Nullable<Boolean>)

Castez la valeur de ce XElement en Nullable<T> de Boolean.

Explicit(XElement to Nullable<Decimal>)

Castez la valeur de ce XElement en Nullable<T> de Decimal.

Explicit(XElement to Boolean)

Castez la valeur de ce XElement en Boolean.

Explicit(XElement to DateTime)

Castez la valeur de ce XElement en DateTime.

Explicit(XElement to DateTimeOffset)

Castez la valeur de ce XAttribute en DateTimeOffset.

Explicit(XElement to Double)

Castez la valeur de ce XElement en Double.

Explicit(XElement to Guid)

Castez la valeur de ce XElement en Guid.

Explicit(XElement to Decimal)

Castez la valeur de ce XElement en Decimal.

Explicit(XElement to Int64)

Castez la valeur de ce XElement en Int64.

Explicit(XElement to Nullable<Double>)

Castez la valeur de ce XElement en Nullable<T> de Double.

Explicit(XElement to Nullable<DateTime>)

Castez la valeur de ce XElement en Nullable<T> de DateTime.

Explicit(XElement to Nullable<DateTimeOffset>)

Castez la valeur de ce XElement en Nullable<T> de DateTimeOffset.

Explicit(XElement to Int32)

Castez la valeur de ce XElement en Int32.

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<Int64>

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<Single>

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<TimeSpan>

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<UInt32>

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<UInt64>

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.

Castez la valeur de ce XElement 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 à caster en UInt32.

Retours

UInt32

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.

Castez la valeur de ce XElement 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)]
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 à caster en String.

Retours

String

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.

Castez la valeur de ce XElement 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 à caster en TimeSpan.

Retours

TimeSpan

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.

Castez la valeur de ce XElement 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 à caster en UInt64.

Retours

UInt64

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<Int32>

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.

Castez la valeur de ce XElement 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 à caster en Single.

Retours

Single

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<Guid>

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<Boolean>

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<Decimal>

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.

Castez la valeur de ce XElement 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 à caster en Boolean.

Retours

Boolean

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.

Castez la valeur de ce XElement 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 à caster en DateTime.

Retours

DateTime

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

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.

Castez la valeur de ce XElement 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 à caster en Double.

Retours

Double

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.

Castez la valeur de ce XElement 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 à caster en Guid.

Retours

Guid

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.

Castez la valeur de ce XElement 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 à caster en Decimal.

Retours

Decimal

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.

Castez la valeur de ce XElement 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 à caster en Int64.

Retours

Int64

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<Double>

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<DateTime>

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<DateTimeOffset>

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.

Castez la valeur de ce XElement 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 à caster en Int32.

Retours

Int32

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  

Voir aussi

S’applique à