XElement.Explicit Operador
Definición
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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.
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
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