XElement.Explicit Operador

Definición

Sobrecargas

Explicit(XElement to Nullable<Int64>)

El valor de XElement se convierte en un objeto Nullable<T> de Int64.

Explicit(XElement to Nullable<Single>)

El valor de XElement se convierte en un objeto Nullable<T> de Single.

Explicit(XElement to Nullable<TimeSpan>)

El valor de XElement se convierte en un objeto Nullable<T> de TimeSpan.

Explicit(XElement to Nullable<UInt32>)

El valor de XElement se convierte en un objeto Nullable<T> de UInt32.

Explicit(XElement to Nullable<UInt64>)

El valor de XElement se convierte en un objeto Nullable<T> de UInt64.

Explicit(XElement to UInt32)

Convierte el valor de XElement en UInt32.

Explicit(XElement to String)

Convierte el valor de XElement en String.

Explicit(XElement to TimeSpan)

Convierte el valor de XElement en TimeSpan.

Explicit(XElement to UInt64)

Convierte el valor de XElement en UInt64.

Explicit(XElement to Nullable<Int32>)

El valor de XElement se convierte en un objeto Nullable<T> de Int32.

Explicit(XElement to Single)

Convierte el valor de XElement en Single.

Explicit(XElement to Nullable<Guid>)

El valor de XElement se convierte en un objeto Nullable<T> de Guid.

Explicit(XElement to Nullable<Boolean>)

El valor de XElement se convierte en un objeto Nullable<T> de Boolean.

Explicit(XElement to Nullable<Decimal>)

El valor de XElement se convierte en un objeto Nullable<T> de Decimal.

Explicit(XElement to Boolean)

Convierte el valor de XElement en Boolean.

Explicit(XElement to DateTime)

Convierte el valor de XElement en DateTime.

Explicit(XElement to DateTimeOffset)

Convierte el valor de XAttribute en DateTimeOffset.

Explicit(XElement to Double)

Convierte el valor de XElement en Double.

Explicit(XElement to Guid)

Convierte el valor de XElement en Guid.

Explicit(XElement to Decimal)

Convierte el valor de XElement en Decimal.

Explicit(XElement to Int64)

Convierte el valor de XElement en Int64.

Explicit(XElement to Nullable<Double>)

El valor de XElement se convierte en un objeto Nullable<T> de Double.

Explicit(XElement to Nullable<DateTime>)

El valor de XElement se convierte en un objeto Nullable<T> de DateTime.

Explicit(XElement to Nullable<DateTimeOffset>)

El valor de XElement se convierte en un objeto Nullable<T> de DateTimeOffset.

Explicit(XElement to Int32)

Convierte el valor de XElement en Int32.

Explicit(XElement to Nullable<Int64>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de Int64.

Devoluciones

Nullable<T> de Int64 que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor Int64 válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido entero largo. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

Nullable ulong: value=9223372036854775807

Consulte también

Se aplica a

Explicit(XElement to Nullable<Single>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de Single.

Devoluciones

Nullable<T> de Single que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor Single válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de punto flotante de precisión única. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

Nullable Single: value=3.402823E+38

Consulte también

Se aplica a

Explicit(XElement to Nullable<TimeSpan>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de TimeSpan.

Devoluciones

Nullable<T> de TimeSpan que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor TimeSpan válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de intervalo de tiempo. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

Nullable TimeSpan: value=01:05:30

Comentarios

El espacio de valor de un atributo o elemento que contiene contenido de intervalo de tiempo está estrechamente relacionado con el contenido de duración, tal como se describe en ISO 8601. Al crear un atributo o elemento que contiene contenido de intervalo de tiempo, se da formato a los valores de atributo o elemento según la especificación W3C. Consulte la especificación W3C para obtener más detalles.

El comportamiento es lax al convertir a Nullable<T> un de TimeSpan desde un atributo o elemento. Incluso si el atributo o el valor de elemento no tiene el formato exacto según la especificación W3C, el valor se convierte adecuadamente en un Nullable<T> de TimeSpan.

Consulte también

Se aplica a

Explicit(XElement to Nullable<UInt32>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de UInt32.

Devoluciones

Nullable<T> de UInt32 que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor UInt32 válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido entero sin signo. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

Nullable uint: value=4294967295

Consulte también

Se aplica a

Explicit(XElement to Nullable<UInt64>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de UInt64.

Devoluciones

Nullable<T> de UInt64 que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor UInt64 válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido entero largo sin signo. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

Nullable ulong: value=9223372036854775807

Consulte también

Se aplica a

Explicit(XElement to UInt32)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en UInt32.

Devoluciones

UInt32 con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor UInt32 válido.

El parámetro element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido entero sin signo. A continuación, recupera el valor mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

value=4294967295

Consulte también

Se aplica a

Explicit(XElement to String)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en String.

Devoluciones

String con el contenido de este objeto XElement.

Atributos

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de cadena. A continuación, recupera el valor mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

(string)root=abc def ghi

Comentarios

Si tiene XElement elementos secundarios, se devuelve el valor de cadena concatenado de todo el texto del elemento y el texto del descendiente.

Consulte también

Se aplica a

Explicit(XElement to TimeSpan)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en TimeSpan.

Devoluciones

TimeSpan con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor TimeSpan válido.

El parámetro element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de intervalo de tiempo. A continuación, recupera el valor mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

value=01:05:30

Comentarios

El espacio de valor de un atributo o elemento que contiene contenido de intervalo de tiempo está estrechamente relacionado con el contenido de duración, tal como se describe en ISO 8601. Al crear un atributo o elemento que contiene contenido de intervalo de tiempo, se da formato a los valores de atributo o elemento según la especificación W3C. Consulte la especificación W3C para obtener más detalles.

El comportamiento es lax al convertir a TimeSpan desde un atributo o elemento. Incluso si el atributo o el valor del elemento no tiene el formato exacto según la especificación W3C, el valor se convierte adecuadamente en .TimeSpan

Consulte también

Se aplica a

Explicit(XElement to UInt64)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en UInt64.

Devoluciones

UInt64 con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor UInt64 válido.

El parámetro element es null.

element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido entero largo sin signo. A continuación, recupera el valor mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

value=18446744073709551615

Consulte también

Se aplica a

Explicit(XElement to Nullable<Int32>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de Int32.

Devoluciones

Nullable<T> de Int32 que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor Int32 válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido entero sin signo. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

Nullable integer: value=2147483647

Consulte también

Se aplica a

Explicit(XElement to Single)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en Single.

Devoluciones

Single con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor Single válido.

El parámetro element es null.

element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de punto flotante de precisión única. A continuación, recupera el valor mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

value=3.402823E+38

Consulte también

Se aplica a

Explicit(XElement to Nullable<Guid>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de Guid.

Devoluciones

Nullable<T> de Guid que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor Guid válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido guid. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

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

Consulte también

Se aplica a

Explicit(XElement to Nullable<Boolean>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de Boolean.

Devoluciones

Nullable<T> de Boolean que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor Boolean válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido booleano. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

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

Comentarios

Al convertir a Nullable<T> desde Boolean un atributo o elemento, los valores permitidos son "0", "1" y cualquier cadena que genere "true" o "false" después de recortar y convertir en minúsculas.

Consulte también

Se aplica a

Explicit(XElement to Nullable<Decimal>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de Decimal.

Devoluciones

Nullable<T> de Decimal que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor Decimal válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido decimal. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

Nullable decimal: value=79228162514264337593543950335

Consulte también

Se aplica a

Explicit(XElement to Boolean)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en Boolean.

Devoluciones

Boolean con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor Boolean válido.

El parámetro element es null.

Ejemplos

En el ejemplo siguiente se crean algunos elementos con valores booleanos. A continuación, los convierte 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)

Este ejemplo produce el siguiente resultado:

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

Comentarios

Al convertir a Boolean desde un atributo o elemento, los valores permitidos son "0", "1" y cualquier cadena que genere "true" o "false" después de recortar y convertir en minúsculas.

Consulte también

Se aplica a

Explicit(XElement to DateTime)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en DateTime.

Devoluciones

DateTime con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor DateTime válido.

El parámetro element es null.

element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de fecha y hora. A continuación, lo convierte en DateTime para recuperar el valor.

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

Este ejemplo produce el siguiente resultado:

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

Comentarios

El espacio de valor de un atributo o elemento que contiene contenido de fecha y hora está estrechamente relacionado con las fechas y horas descritas en ISO 8601. Al crear un atributo o elemento que contiene contenido de fecha y hora, se da formato a los valores de atributo o elemento según la especificación W3C. Consulte la especificación W3C para obtener más detalles.

El comportamiento es lax al convertir a DateTime desde un atributo o elemento. Incluso si el atributo o el valor del elemento no tiene el formato exacto según la especificación W3C, el valor se convierte adecuadamente en .DateTime

Este operador de conversión usa CultureInfo.InvariantCulture para convertir de .DateTime

Consulte también

Se aplica a

Explicit(XElement to DateTimeOffset)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en DateTimeOffset.

Devoluciones

DateTimeOffset con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor DateTimeOffset válido.

El parámetro element es null.

element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de fecha y hora. A continuación, convierte en DateTimeOffset para recuperar el valor.

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)

Este ejemplo produce el siguiente resultado:

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

Comentarios

Este operador de conversión usa la XmlConvert clase para realizar la conversión.

Consulte también

Se aplica a

Explicit(XElement to Double)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en Double.

Devoluciones

Double con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor Double válido.

El parámetro element es null.

element es null.

Ejemplos

En el ejemplo siguiente se crea un atributo con double contenido. A continuación, recupera el valor mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

value=1.79769313486231E+308

Consulte también

Se aplica a

Explicit(XElement to Guid)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en Guid.

Devoluciones

Guid con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor Guid válido.

El parámetro element es null.

element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con un guid como contenido. A continuación, recupera el valor mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

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

Consulte también

Se aplica a

Explicit(XElement to Decimal)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en Decimal.

Devoluciones

Decimal con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor Decimal válido.

El parámetro element es null.

element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con un valor decimal. A continuación, recupera el valor del atributo mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

value=79228162514264337593543950335

Consulte también

Se aplica a

Explicit(XElement to Int64)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en Int64.

Devoluciones

Int64 con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor Int64 válido.

El parámetro element es null.

element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con un entero largo como contenido. A continuación, recupera el valor del elemento mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

value=9223372036854775807

Consulte también

Se aplica a

Explicit(XElement to Nullable<Double>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de Double.

Devoluciones

Nullable<T> de Double que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor Double válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de punto flotante de precisión doble. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

Nullable double: value=1.79769313486231E+308

Consulte también

Se aplica a

Explicit(XElement to Nullable<DateTime>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en Nullable<T> de DateTime.

Devoluciones

Nullable<T> de DateTime que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor DateTime válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con una fecha y hora como contenido. A continuación, recupera el valor mediante la conversión a Nullable<T> de 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"))

Este ejemplo produce el siguiente resultado:

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

Comentarios

El espacio de valor de un atributo o elemento que contiene contenido de fecha y hora está estrechamente relacionado con las fechas y horas descritas en ISO 8601. Al crear un atributo o elemento que contiene contenido de fecha y hora, se da formato a los valores de atributo o elemento según la especificación W3C. Consulte la especificación W3C para obtener más detalles.

El comportamiento es lax al convertir a Nullable<T> un de DateTime desde un atributo o elemento. Incluso si el atributo o el valor de elemento no tiene el formato exacto según la especificación W3C, el valor se convierte adecuadamente en un Nullable<T> de DateTime.

Este operador de conversión usa CultureInfo.InvariantCulture para convertir de .DateTime

Consulte también

Se aplica a

Explicit(XElement to Nullable<DateTimeOffset>)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

El valor de XElement se convierte en un objeto 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)

Parámetros

element
XElement

XElement que se va a convertir en objeto Nullable<T> de DateTimeOffset.

Devoluciones

Nullable<T> de DateTimeOffset que incluye el contenido de este XElement.

Atributos

Excepciones

El elemento no es null y no contiene un valor DateTimeOffset válido.

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de fecha y hora. A continuación, convierte en Nullable<T> de DateTimeOffset para recuperar el valor.

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)

Este ejemplo produce el siguiente resultado:

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

Comentarios

Este operador de conversión usa la XmlConvert clase para realizar la conversión.

Consulte también

Se aplica a

Explicit(XElement to Int32)

Source:
XElement.cs
Source:
XElement.cs
Source:
XElement.cs

Importante

Esta API no es conforme a CLS.

Convierte el valor de 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

Parámetros

element
XElement

XElement que se va a convertir en Int32.

Devoluciones

Int32 con el contenido de este objeto XElement.

Atributos

Excepciones

El elemento no contiene un valor Int32 válido.

El parámetro element es null.

Ejemplos

En el ejemplo siguiente se crea un elemento con un entero como contenido. A continuación, recupera el valor mediante la conversión a 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)

Este ejemplo produce el siguiente resultado:

value=2147483647

Consulte también

Se aplica a