XElement.Explicit Operador
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
Explicit(XElement to Nullable<Int64>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de Int64.
Retornos
Um Nullable<T> de Int64 que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor Int64 válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo inteiro longo. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable ulong: value=9223372036854775807
Confira também
Aplica-se a
Explicit(XElement to Nullable<Single>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de Single.
Retornos
Um Nullable<T> de Single que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor Single válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo de ponto flutuante de precisão única. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable Single: value=3.402823E+38
Confira também
Aplica-se a
Explicit(XElement to Nullable<TimeSpan>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de TimeSpan.
Retornos
Um Nullable<T> de TimeSpan que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor TimeSpan válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo de intervalo de tempo. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable TimeSpan: value=01:05:30
Comentários
O espaço de valor de um atributo ou elemento que contém conteúdo de intervalo de tempo está intimamente relacionado ao conteúdo de duração, conforme descrito em ISO 8601. Ao criar um atributo ou elemento que contém conteúdo de intervalo de tempo, os valores de atributo ou elemento são formatados de acordo com a especificação W3C. Consulte a especificação W3C para obter mais detalhes.
O comportamento é frouxo ao converter em um Nullable<T> de TimeSpan de um atributo ou elemento. Mesmo que o atributo ou o valor do elemento não esteja formatado exatamente de acordo com a especificação W3C, o valor será convertido adequadamente em um Nullable<T> de TimeSpan.
Confira também
Aplica-se a
Explicit(XElement to Nullable<UInt32>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de UInt32.
Retornos
Um Nullable<T> de UInt32 que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor UInt32 válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo inteiro sem sinal. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable uint: value=4294967295
Confira também
Aplica-se a
Explicit(XElement to Nullable<UInt64>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de UInt64.
Retornos
Um Nullable<T> de UInt64 que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor UInt64 válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo inteiro longo sem sinal. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable ulong: value=9223372036854775807
Confira também
Aplica-se a
Explicit(XElement to UInt32)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um UInt32 que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor UInt32 válido.
O parâmetro element
é null
.
Exemplos
O exemplo a seguir cria um elemento com conteúdo inteiro sem sinal. Em seguida, ele recupera o valor convertendo em 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)
Esse exemplo gera a saída a seguir:
value=4294967295
Confira também
Aplica-se a
Explicit(XElement to String)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um String que contém o conteúdo deste XElement.
- Atributos
Exemplos
O exemplo a seguir cria um elemento com conteúdo de cadeia de caracteres. Em seguida, ele recupera o valor convertendo em 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)
Esse exemplo gera a saída a seguir:
(string)root=abc def ghi
Comentários
Se o XElement tiver filhos, o valor da cadeia de caracteres concatenada de todo o texto do elemento e do texto do descendente será retornado.
Confira também
Aplica-se a
Explicit(XElement to TimeSpan)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um TimeSpan que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor TimeSpan válido.
O parâmetro element
é null
.
Exemplos
O exemplo a seguir cria um elemento com conteúdo de intervalo de tempo. Em seguida, ele recupera o valor convertendo em 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)
Esse exemplo gera a saída a seguir:
value=01:05:30
Comentários
O espaço de valor de um atributo ou elemento que contém conteúdo de intervalo de tempo está intimamente relacionado ao conteúdo de duração, conforme descrito em ISO 8601. Ao criar um atributo ou elemento que contém conteúdo de intervalo de tempo, os valores de atributo ou elemento são formatados de acordo com a especificação W3C. Consulte a especificação W3C para obter mais detalhes.
O comportamento é frouxo ao converter em um TimeSpan de um atributo ou elemento. Mesmo que o atributo ou o valor do elemento não esteja formatado exatamente de acordo com a especificação W3C, o valor será convertido adequadamente em um TimeSpan.
Confira também
Aplica-se a
Explicit(XElement to UInt64)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um UInt64 que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor UInt64 válido.
O parâmetro element
é null
.
element
é null
.
Exemplos
O exemplo a seguir cria um elemento com conteúdo inteiro longo sem sinal. Em seguida, ele recupera o valor convertendo em 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)
Esse exemplo gera a saída a seguir:
value=18446744073709551615
Confira também
Aplica-se a
Explicit(XElement to Nullable<Int32>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de Int32.
Retornos
Um Nullable<T> de Int32 que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor Int32 válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo inteiro sem sinal. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable integer: value=2147483647
Confira também
Aplica-se a
Explicit(XElement to Single)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um Single que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor Single válido.
O parâmetro element
é null
.
element
é null
.
Exemplos
O exemplo a seguir cria um elemento com conteúdo de ponto flutuante de precisão única. Em seguida, ele recupera o valor convertendo em 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)
Esse exemplo gera a saída a seguir:
value=3.402823E+38
Confira também
Aplica-se a
Explicit(XElement to Nullable<Guid>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de Guid.
Retornos
Um Nullable<T> de Guid que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor Guid válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo guid. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable Guid: value=3c1cc55b-baff-4b7a-9d17-077af3aa5730
Confira também
Aplica-se a
Explicit(XElement to Nullable<Boolean>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de Boolean.
Retornos
Um Nullable<T> de Boolean que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor Boolean válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo booliano. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable Boolean: value1=True
Nullable Boolean: value2=False
Comentários
Ao converter para Nullable<T> de Boolean de um atributo ou elemento, os valores permitidos são "0", "1" e qualquer cadeia de caracteres que produz "true" ou "false" após o corte e a conversão em letras minúsculas.
Confira também
Aplica-se a
Explicit(XElement to Nullable<Decimal>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de Decimal.
Retornos
Um Nullable<T> de Decimal que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor Decimal válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo decimal. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable decimal: value=79228162514264337593543950335
Confira também
Aplica-se a
Explicit(XElement to Boolean)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um Boolean que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor Boolean válido.
O parâmetro element
é null
.
Exemplos
O exemplo a seguir cria alguns elementos com valores boolianos. Em seguida, ele os converte em 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)
Esse exemplo gera a saída a seguir:
(bool)BoolValue1=True
(bool)BoolValue2=False
Comentários
Ao converter para Boolean de um atributo ou elemento, os valores permitidos são "0", "1" e qualquer cadeia de caracteres que produz "true" ou "false" após a filtragem e conversão em letras minúsculas.
Confira também
Aplica-se a
Explicit(XElement to DateTime)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um DateTime que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor DateTime válido.
O parâmetro element
é null
.
element
é null
.
Exemplos
O exemplo a seguir cria um elemento com conteúdo de data e hora. Em seguida, ele o converte para DateTime para recuperar o 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)
Esse exemplo gera a saída a seguir:
<Root>2006-10-06T12:30:00</Root>
dt=10/6/2006 12:30:00 PM
-----
<OrderDate>October 6, 2006</OrderDate>
orderDate=10/6/2006
Comentários
O espaço de valor de um atributo ou elemento que contém conteúdo de data e hora está intimamente relacionado às datas e horas descritas no ISO 8601. Ao criar um atributo ou elemento que contenha conteúdo de data e hora, os valores de atributo ou elemento são formatados de acordo com a especificação W3C. Consulte a especificação W3C para obter mais detalhes.
O comportamento é frouxo ao converter em um DateTime de um atributo ou elemento. Mesmo que o atributo ou o valor do elemento não seja formatado exatamente de acordo com a especificação W3C, o valor será convertido adequadamente em um DateTime.
Esse operador de conversão usa CultureInfo.InvariantCulture para converter de um DateTime.
Confira também
Aplica-se a
Explicit(XElement to DateTimeOffset)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converta o valor deste XAttribute em um 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
O XElement a ser convertido em DateTimeOffset.
Retornos
Um DateTimeOffset que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor DateTimeOffset válido.
O parâmetro element
é null
.
element
é null
.
Exemplos
O exemplo a seguir cria um elemento com conteúdo de data e hora. Em seguida, ele converte para DateTimeOffset recuperar o 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)
Esse exemplo gera a saída a seguir:
<Root>
<Child>2006-10-06T12:30:00-07:00</Child>
</Root>
dt=10/6/2006 12:30:00 PM -07:00
Comentários
Esse operador de conversão usa a XmlConvert classe para fazer a conversão.
Confira também
Aplica-se a
Explicit(XElement to Double)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um Double que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor Double válido.
O parâmetro element
é null
.
element
é null
.
Exemplos
O exemplo a seguir cria um atributo com double
conteúdo. Em seguida, ele recupera o valor convertendo em 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)
Esse exemplo gera a saída a seguir:
value=1.79769313486231E+308
Confira também
Aplica-se a
Explicit(XElement to Guid)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um Guid que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor Guid válido.
O parâmetro element
é null
.
element
é null
.
Exemplos
O exemplo a seguir cria um elemento com um guid como conteúdo. Em seguida, ele recupera o valor convertendo em 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)
Esse exemplo gera a saída a seguir:
value=3c1cc55b-baff-4b7a-9d17-077af3aa5730
Confira também
Aplica-se a
Explicit(XElement to Decimal)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um Decimal que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor Decimal válido.
O parâmetro element
é null
.
element
é null
.
Exemplos
O exemplo a seguir cria um elemento com um valor decimal. Em seguida, ele recupera o valor do atributo convertendo em 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)
Esse exemplo gera a saída a seguir:
value=79228162514264337593543950335
Confira também
Aplica-se a
Explicit(XElement to Int64)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um Int64 que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor Int64 válido.
O parâmetro element
é null
.
element
é null
.
Exemplos
O exemplo a seguir cria um elemento com um inteiro longo como conteúdo. Em seguida, ele recupera o valor do elemento convertendo em 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)
Esse exemplo gera a saída a seguir:
value=9223372036854775807
Confira também
Aplica-se a
Explicit(XElement to Nullable<Double>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de Double.
Retornos
Um Nullable<T> de Double que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor Double válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo de ponto flutuante de precisão dupla. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable double: value=1.79769313486231E+308
Confira também
Aplica-se a
Explicit(XElement to Nullable<DateTime>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para Nullable<T> de DateTime.
Retornos
Um Nullable<T> de DateTime que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor DateTime válido.
Exemplos
O exemplo a seguir cria um elemento com uma data e hora como conteúdo. Em seguida, ele recupera o valor convertendo em 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"))
Esse exemplo gera a saída a seguir:
Nullable DateTime: value=10/6/2006 12:30:00 PM
Comentários
O espaço de valor de um atributo ou elemento que contém conteúdo de data e hora está intimamente relacionado às datas e horas descritas no ISO 8601. Ao criar um atributo ou elemento que contenha conteúdo de data e hora, os valores de atributo ou elemento são formatados de acordo com a especificação W3C. Consulte a especificação W3C para obter mais detalhes.
O comportamento é frouxo ao converter em um Nullable<T> de DateTime de de um atributo ou elemento. Mesmo que o atributo ou o valor do elemento não seja formatado exatamente de acordo com a especificação W3C, o valor será convertido adequadamente em um Nullable<T> de DateTime.
Esse operador de conversão usa CultureInfo.InvariantCulture para converter de um DateTime.
Confira também
Aplica-se a
Explicit(XElement to Nullable<DateTimeOffset>)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com CLS.
Converte o valor deste XElement em um 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
O XElement a ser convertido para um Nullable<T> de DateTimeOffset.
Retornos
Um Nullable<T> de DateTimeOffset que retém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não é null
e não contém um valor DateTimeOffset válido.
Exemplos
O exemplo a seguir cria um elemento com conteúdo de data e hora. Em seguida, ele converte para Nullable<T> de DateTimeOffset para recuperar o 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)
Esse exemplo gera a saída a seguir:
<Root>
<Child>2006-10-06T12:30:00-07:00</Child>
</Root>
dt=10/6/2006 12:30:00 PM -07:00
Comentários
Esse operador de conversão usa a XmlConvert classe para fazer a conversão.
Confira também
Aplica-se a
Explicit(XElement to Int32)
- Origem:
- XElement.cs
- Origem:
- XElement.cs
- Origem:
- XElement.cs
Importante
Esta API não está em conformidade com 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
Retornos
Um Int32 que contém o conteúdo deste XElement.
- Atributos
Exceções
O elemento não contém um valor Int32 válido.
O parâmetro element
é null
.
Exemplos
O exemplo a seguir cria um elemento com um inteiro como conteúdo. Em seguida, ele recupera o valor convertendo em 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)
Esse exemplo gera a saída a seguir:
value=2147483647