XElement.Explicit Operador

Definición

Espacio de nombres:: System.Xml.Linq

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

Ensamblado:: System.Xml.Linq.dll

Ensamblado:: System.Xml.XDocument.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

Nombre	Description
Explicit(XElement to Nullable<Int64>)	Convierta el valor de esto XElement en un Nullable<T> de Int64.
Explicit(XElement to Nullable<Single>)	Convierta el valor de esto XElement en un Nullable<T> de Single.
Explicit(XElement to Nullable<TimeSpan>)	Convierta el valor de esto XElement en un Nullable<T> de TimeSpan.
Explicit(XElement to Nullable<UInt32>)	Convierta el valor de esto XElement en un Nullable<T> de UInt32.
Explicit(XElement to Nullable<UInt64>)	Convierta el valor de esto XElement en un Nullable<T> de UInt64.
Explicit(XElement to UInt32)	Convierta el valor de esto XElement en un UInt32.
Explicit(XElement to String)	Convierta el valor de esto XElement en un String.
Explicit(XElement to TimeSpan)	Convierta el valor de esto XElement en un TimeSpan.
Explicit(XElement to UInt64)	Convierta el valor de esto XElement en un UInt64.
Explicit(XElement to Nullable<Int32>)	Convierta el valor de esto XElement en un Nullable<T> de Int32.
Explicit(XElement to Single)	Convierta el valor de esto XElement en un Single.
Explicit(XElement to Nullable<Guid>)	Convierta el valor de esto XElement en un Nullable<T> de Guid.
Explicit(XElement to Nullable<Boolean>)	Convierta el valor de esto XElement en un Nullable<T> de Boolean.
Explicit(XElement to Nullable<Decimal>)	Convierta el valor de esto XElement en un Nullable<T> de Decimal.
Explicit(XElement to Boolean)	Convierta el valor de esto XElement en un Boolean.
Explicit(XElement to DateTime)	Convierta el valor de esto XElement en un DateTime.
Explicit(XElement to DateTimeOffset)	Convierta el valor de esto XAttribute en un DateTimeOffset.
Explicit(XElement to Double)	Convierta el valor de esto XElement en un Double.
Explicit(XElement to Guid)	Convierta el valor de esto XElement en un Guid.
Explicit(XElement to Decimal)	Convierta el valor de esto XElement en un Decimal.
Explicit(XElement to Int64)	Convierta el valor de este XElement en un Int64.
Explicit(XElement to Nullable<Double>)	Convierta el valor de esto XElement en un Nullable<T> de Double.
Explicit(XElement to Nullable<DateTime>)	Convierta el valor de esto XElement en un Nullable<T> de DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)	Convierta el valor de esto XElement en un Nullable<T> de DateTimeOffset.
Explicit(XElement to Int32)	Convierta el valor de este XElement en un Int32.

Explicit(XElement to Nullable<Int64>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<Int64>

Nullable<T> de Int64 que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<Single>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<Single>

Nullable<T> de Single que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<TimeSpan>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<TimeSpan>

Nullable<T> de TimeSpan que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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, los valores de atributo o elemento tienen el formato según la especificación W3C. Consulte la especificación W3C para obtener más detalles.

El comportamiento es lax al convertir a un Nullable<T> de TimeSpan desde un atributo o elemento. Incluso si el atributo o 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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<UInt32>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<UInt32>

Nullable<T> de UInt32 que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<UInt64>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<UInt64>

Nullable<T> de UInt64 que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to UInt32)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

que XElement se va a convertir en UInt32.

Devoluciones

UInt32

que UInt32 contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido UInt32 .

ArgumentNullException

El element parámetro 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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to String)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

Parámetros

element: XElement

que XElement se va a convertir en String.

Devoluciones

String

que String contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to TimeSpan)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

que XElement se va a convertir en TimeSpan.

Devoluciones

TimeSpan

que TimeSpan contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido TimeSpan .

ArgumentNullException

El element parámetro 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 comportamiento es lax al convertir a desde un TimeSpan atributo o elemento. Incluso si el atributo o valor de elemento no tiene el formato exacto según la especificación W3C, el valor se convierte adecuadamente en un TimeSpan.

Consulte también

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to UInt64)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

que XElement se va a convertir en UInt64.

Devoluciones

UInt64

que UInt64 contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido UInt64 .

ArgumentNullException

El element parámetro es null.

InvalidOperationException

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<Int32>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<Int32>

Nullable<T> de Int32 que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Single)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

que XElement se va a convertir en Single.

Devoluciones

Single

que Single contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido Single .

ArgumentNullException

El element parámetro es null.

InvalidOperationException

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<Guid>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<Guid>

Nullable<T> de Guid que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<Boolean>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<Boolean>

Nullable<T> de Boolean que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<Decimal>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<Decimal>

Nullable<T> de Decimal que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Boolean)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

que XElement se va a convertir en Boolean.

Devoluciones

Boolean

que Boolean contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido Boolean .

ArgumentNullException

El element parámetro 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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to DateTime)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

que XElement se va a convertir en DateTime.

Devoluciones

DateTime

que DateTime contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido DateTime .

ArgumentNullException

El element parámetro es null.

InvalidOperationException

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, los valores de atributo o elemento tienen formato según la especificación W3C. Consulte la especificación W3C para obtener más detalles.

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

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

Consulte también

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to DateTimeOffset)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XAttribute en un 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

que XElement se va a convertir en DateTimeOffset.

Devoluciones

DateTimeOffset

que DateTimeOffset contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido DateTimeOffset .

ArgumentNullException

El element parámetro es null.

InvalidOperationException

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Double)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

que XElement se va a convertir en Double.

Devoluciones

Double

que Double contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido Double .

ArgumentNullException

El element parámetro es null.

InvalidOperationException

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Guid)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

que XElement se va a convertir en Guid.

Devoluciones

Guid

que Guid contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido Guid .

ArgumentNullException

El element parámetro es null.

InvalidOperationException

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Decimal)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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

que XElement se va a convertir en Decimal.

Devoluciones

Decimal

que Decimal contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido Decimal .

ArgumentNullException

El element parámetro es null.

InvalidOperationException

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Int64)

Importante

Esta API no es conforme a CLS.

Convierta el valor de este XElement en un 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

que XElement se va a convertir en Int64.

Devoluciones

Int64

que Int64 contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido Int64 .

ArgumentNullException

El element parámetro es null.

InvalidOperationException

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<Double>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<Double>

Nullable<T> de Double que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<DateTime>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<DateTime>

Nullable<T> de DateTime que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

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 comportamiento es lax cuando se convierte a un Nullable<T> de DateTime desde un atributo o elemento. Incluso si el atributo o 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 un DateTime.

Consulte también

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Nullable<DateTimeOffset>)

Importante

Esta API no es conforme a CLS.

Convierta el valor de esto XElement en un 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)>]
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

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

Devoluciones

Nullable<DateTimeOffset>

Nullable<T> de DateTimeOffset que contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

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

Ejemplos

En el ejemplo siguiente se crea un elemento con contenido de fecha y hora. A continuación, convierte a Nullable<T> para DateTimeOffset 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

Información general sobre LINQ to XML

Se aplica a

Explicit(XElement to Int32)

Importante

Esta API no es conforme a CLS.

Convierta el valor de este XElement en un 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

que XElement se va a convertir en Int32.

Devoluciones

Int32

que Int32 contiene el contenido de este XElementobjeto .

Atributos: CLSCompliantAttribute

Excepciones

FormatException

El elemento no contiene un valor válido Int32 .

ArgumentNullException

El element parámetro 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

Información general sobre LINQ to XML

Se aplica a

Comentarios

¿Le ha resultado útil esta página?