Compartilhar via


XElement.Explicit Operador

Definição

Sobrecargas

Explicit(XElement to Nullable<Int64>)

Converte o valor deste XElement em um Nullable<T> de Int64.

Explicit(XElement to Nullable<Single>)

Converte o valor deste XElement em um Nullable<T> de Single.

Explicit(XElement to Nullable<TimeSpan>)

Converte o valor deste XElement em um Nullable<T> de TimeSpan.

Explicit(XElement to Nullable<UInt32>)

Converte o valor deste XElement em um Nullable<T> de UInt32.

Explicit(XElement to Nullable<UInt64>)

Converte o valor deste XElement em um Nullable<T> de UInt64.

Explicit(XElement to UInt32)

Converta o valor deste XElement em um UInt32.

Explicit(XElement to String)

Converta o valor deste XElement em um String.

Explicit(XElement to TimeSpan)

Converta o valor deste XElement em um TimeSpan.

Explicit(XElement to UInt64)

Converta o valor deste XElement em um UInt64.

Explicit(XElement to Nullable<Int32>)

Converte o valor deste XElement em um Nullable<T> de Int32.

Explicit(XElement to Single)

Converta o valor deste XElement em um Single.

Explicit(XElement to Nullable<Guid>)

Converte o valor deste XElement em um Nullable<T> de Guid.

Explicit(XElement to Nullable<Boolean>)

Converte o valor deste XElement em um Nullable<T> de Boolean.

Explicit(XElement to Nullable<Decimal>)

Converte o valor deste XElement em um Nullable<T> de Decimal.

Explicit(XElement to Boolean)

Converta o valor deste XElement em um Boolean.

Explicit(XElement to DateTime)

Converta o valor deste XElement em um DateTime.

Explicit(XElement to DateTimeOffset)

Converta o valor deste XAttribute em um DateTimeOffset.

Explicit(XElement to Double)

Converta o valor deste XElement em um Double.

Explicit(XElement to Guid)

Converta o valor deste XElement em um Guid.

Explicit(XElement to Decimal)

Converta o valor deste XElement em um Decimal.

Explicit(XElement to Int64)

Converta o valor deste XElement em um Int64.

Explicit(XElement to Nullable<Double>)

Converte o valor deste XElement em um Nullable<T> de Double.

Explicit(XElement to Nullable<DateTime>)

Converte o valor deste XElement em um Nullable<T> de DateTime.

Explicit(XElement to Nullable<DateTimeOffset>)

Converte o valor deste XElement em um Nullable<T> de DateTimeOffset.

Explicit(XElement to Int32)

Converta o valor deste XElement em um Int32.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em UInt32.

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.

Converta o valor deste XElement em um String.

public:
 static explicit operator System::String ^(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator string (System.Xml.Linq.XElement element);
[System.CLSCompliant(false)]
public static explicit operator string? (System.Xml.Linq.XElement? element);
[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XElement -> string
Public Shared Narrowing Operator CType (element As XElement) As String

Parâmetros

element
XElement

O XElement a ser convertido em String.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em TimeSpan.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em UInt64.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em Single.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em Boolean.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em DateTime.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em Double.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em Guid.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em Decimal.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em Int64.

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.

Converta o valor deste XElement em um 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

O XElement a ser convertido em Int32.

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

Confira também

Aplica-se a