XElement.Explicit Operador

Definição

Namespace:: System.Xml.Linq

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

Assemblies:: netstandard.dll, System.Xml.XDocument.dll

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

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

Nome	Description
Explicit(XElement to Nullable<Int64>)	Converta o valor disso XElement em um Nullable<T> de Int64.
Explicit(XElement to Nullable<Single>)	Converta o valor disso XElement em um Nullable<T> de Single.
Explicit(XElement to Nullable<TimeSpan>)	Converta o valor disso XElement em um Nullable<T> de TimeSpan.
Explicit(XElement to Nullable<UInt32>)	Converta o valor disso XElement em um Nullable<T> de UInt32.
Explicit(XElement to Nullable<UInt64>)	Converta o valor disso XElement em um Nullable<T> de UInt64.
Explicit(XElement to UInt32)	Converta o valor disso XElement em um UInt32.
Explicit(XElement to String)	Converta o valor disso XElement em um String.
Explicit(XElement to TimeSpan)	Converta o valor disso XElement em um TimeSpan.
Explicit(XElement to UInt64)	Converta o valor disso XElement em um UInt64.
Explicit(XElement to Nullable<Int32>)	Converta o valor disso XElement em um Nullable<T> de Int32.
Explicit(XElement to Single)	Converta o valor disso XElement em um Single.
Explicit(XElement to Nullable<Guid>)	Converta o valor disso XElement em um Nullable<T> de Guid.
Explicit(XElement to Nullable<Boolean>)	Converta o valor disso XElement em um Nullable<T> de Boolean.
Explicit(XElement to Nullable<Decimal>)	Converta o valor disso XElement em um Nullable<T> de Decimal.
Explicit(XElement to Boolean)	Converta o valor disso XElement em um Boolean.
Explicit(XElement to DateTime)	Converta o valor disso XElement em um DateTime.
Explicit(XElement to DateTimeOffset)	Converta o valor disso XAttribute em um DateTimeOffset.
Explicit(XElement to Double)	Converta o valor disso XElement em um Double.
Explicit(XElement to Guid)	Converta o valor disso XElement em um Guid.
Explicit(XElement to Decimal)	Converta o valor disso XElement em um Decimal.
Explicit(XElement to Int64)	Converta o valor disso XElement em um Int64.
Explicit(XElement to Nullable<Double>)	Converta o valor disso XElement em um Nullable<T> de Double.
Explicit(XElement to Nullable<DateTime>)	Converta o valor disso XElement em um Nullable<T> de DateTime.
Explicit(XElement to Nullable<DateTimeOffset>)	Converta o valor disso XElement em um Nullable<T> de DateTimeOffset.
Explicit(XElement to Int32)	Converta o valor disso XElement em um Int32.

Explicit(XElement to Nullable<Int64>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>Int64.

Retornos

Nullable<Int64>

Um Nullable<T> deles Int64 contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido Int64 .

Exemplos

O exemplo a seguir cria um elemento com conteúdo inteiro longo. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

Nullable ulong: value=9223372036854775807

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<Single>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>Single.

Retornos

Nullable<Single>

Um Nullable<T> deles Single contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido Single .

Exemplos

O exemplo a seguir cria um elemento com conteúdo de ponto flutuante de precisão única. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

Nullable Single: value=3.402823E+38

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<TimeSpan>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>TimeSpan.

Retornos

Nullable<TimeSpan>

Um Nullable<T> deles TimeSpan contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido TimeSpan .

Exemplos

O exemplo a seguir cria um elemento com conteúdo de intervalo de tempo. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

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 no 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 do W3C para obter mais detalhes.

O comportamento é frouxo ao converter em um Nullable<T> de TimeSpan um atributo ou elemento. Mesmo que o valor do atributo ou do elemento não esteja formatado exatamente de acordo com a especificação do W3C, o valor será convertido adequadamente em um Nullable<T> de TimeSpan.

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<UInt32>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>UInt32.

Retornos

Nullable<UInt32>

Um Nullable<T> deles UInt32 contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido UInt32 .

Exemplos

O exemplo a seguir cria um elemento com conteúdo inteiro sem sinal. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

Nullable uint: value=4294967295

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<UInt64>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>UInt64.

Retornos

Nullable<UInt64>

Um Nullable<T> deles UInt64 contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido UInt64 .

Exemplos

O exemplo a seguir cria um elemento com conteúdo inteiro longo sem sinal. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

Nullable ulong: value=9223372036854775807

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to UInt32)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para UInt32.

Retornos

UInt32

Um UInt32 que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido UInt32 .

ArgumentNullException

O element parâmetro é null.

Exemplos

O exemplo a seguir cria um elemento com conteúdo inteiro sem sinal. Em seguida, recupera o valor por conversão 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)

Este exemplo produz a seguinte saída:

value=4294967295

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to String)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para String.

Retornos

String

Um String que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exemplos

O exemplo a seguir cria um elemento com conteúdo de cadeia de caracteres. Em seguida, recupera o valor por conversão 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)

Este exemplo produz a seguinte saída:

(string)root=abc def ghi

Comentários

Se houver XElement filhos, o valor da cadeia de caracteres concatenada de todo o texto do elemento e do texto do descendente será retornado.

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to TimeSpan)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para TimeSpan.

Retornos

TimeSpan

Um TimeSpan que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido TimeSpan .

ArgumentNullException

O element parâmetro é null.

Exemplos

O exemplo a seguir cria um elemento com conteúdo de intervalo de tempo. Em seguida, recupera o valor por conversão 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)

Este exemplo produz a seguinte saída:

value=01:05:30

Comentários

O comportamento é frouxo ao converter em um TimeSpan de um atributo ou elemento. Mesmo que o valor do atributo ou do elemento não esteja formatado exatamente de acordo com a especificação do W3C, o valor será convertido adequadamente em um TimeSpan.

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to UInt64)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para UInt64.

Retornos

UInt64

Um UInt64 que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido UInt64 .

ArgumentNullException

O element parâmetro é null.

InvalidOperationException

element é null.

Exemplos

O exemplo a seguir cria um elemento com conteúdo inteiro longo sem sinal. Em seguida, recupera o valor por conversão 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)

Este exemplo produz a seguinte saída:

value=18446744073709551615

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<Int32>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>Int32.

Retornos

Nullable<Int32>

Um Nullable<T> deles Int32 contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido Int32 .

Exemplos

O exemplo a seguir cria um elemento com conteúdo inteiro sem sinal. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

Nullable integer: value=2147483647

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Single)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para Single.

Retornos

Single

Um Single que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido Single .

ArgumentNullException

O element parâmetro é null.

InvalidOperationException

element é null.

Exemplos

O exemplo a seguir cria um elemento com conteúdo de ponto flutuante de precisão única. Em seguida, recupera o valor por conversão 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)

Este exemplo produz a seguinte saída:

value=3.402823E+38

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<Guid>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>Guid.

Retornos

Nullable<Guid>

Um Nullable<T> deles Guid contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido Guid .

Exemplos

O exemplo a seguir cria um elemento com conteúdo de guid. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

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

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<Boolean>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>Boolean.

Retornos

Nullable<Boolean>

Um Nullable<T> deles Boolean contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido Boolean .

Exemplos

O exemplo a seguir cria um elemento com conteúdo booliano. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

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

Comentários

Ao converter de Nullable<T>Boolean um atributo ou elemento, os valores permitidos são "0", "1" e qualquer cadeia de caracteres que produza "true" ou "false" após o corte e conversão em letras minúsculas.

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<Decimal>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>Decimal.

Retornos

Nullable<Decimal>

Um Nullable<T> deles Decimal contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido Decimal .

Exemplos

O exemplo a seguir cria um elemento com conteúdo decimal. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

Nullable decimal: value=79228162514264337593543950335

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Boolean)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para Boolean.

Retornos

Boolean

Um Boolean que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido Boolean .

ArgumentNullException

O element parâmetro é null.

Exemplos

O exemplo a seguir cria alguns elementos com valores boolianos. Em seguida, ele os lança para 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 exemplo produz a seguinte saída:

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

Comentários

Ao converter em Boolean um atributo ou elemento, os valores permitidos são "0", "1" e qualquer cadeia de caracteres que produza "true" ou "false" após o corte e conversão em letras minúsculas.

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to DateTime)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para DateTime.

Retornos

DateTime

Um DateTime que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido DateTime .

ArgumentNullException

O element parâmetro é null.

InvalidOperationException

element é null.

Exemplos

O exemplo a seguir cria um elemento com conteúdo de data e hora. Em seguida, ele o converte para DateTime 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)

Este exemplo produz a seguinte saída:

<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 contém 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 do W3C para obter mais detalhes.

O comportamento é frouxo ao converter em um DateTime de um atributo ou elemento. Mesmo que o valor do atributo ou do elemento não esteja formatado exatamente de acordo com a especificação do 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

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to DateTimeOffset)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para DateTimeOffset.

Retornos

DateTimeOffset

Um DateTimeOffset que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido DateTimeOffset .

ArgumentNullException

O element parâmetro é null.

InvalidOperationException

element é null.

Exemplos

O exemplo a seguir cria um elemento com conteúdo de data e hora. Em seguida, ele é convertido 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)

Este exemplo produz a seguinte saída:

<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

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Double)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para Double.

Retornos

Double

Um Double que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido Double .

ArgumentNullException

O element parâmetro é null.

InvalidOperationException

element é null.

Exemplos

O exemplo a seguir cria um atributo com double conteúdo. Em seguida, recupera o valor por conversão 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)

Este exemplo produz a seguinte saída:

value=1.79769313486231E+308

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Guid)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para Guid.

Retornos

Guid

Um Guid que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido Guid .

ArgumentNullException

O element parâmetro é null.

InvalidOperationException

element é null.

Exemplos

O exemplo a seguir cria um elemento com um guid como conteúdo. Em seguida, recupera o valor por conversão 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)

Este exemplo produz a seguinte saída:

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

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Decimal)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para Decimal.

Retornos

Decimal

Um Decimal que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido Decimal .

ArgumentNullException

O element parâmetro é null.

InvalidOperationException

element é null.

Exemplos

O exemplo a seguir cria um elemento com um valor decimal. Em seguida, 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)

Este exemplo produz a seguinte saída:

value=79228162514264337593543950335

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Int64)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para Int64.

Retornos

Int64

Um Int64 que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido Int64 .

ArgumentNullException

O element parâmetro é null.

InvalidOperationException

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)

Este exemplo produz a seguinte saída:

value=9223372036854775807

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<Double>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>Double.

Retornos

Nullable<Double>

Um Nullable<T> deles Double contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido Double .

Exemplos

O exemplo a seguir cria um elemento com conteúdo de ponto flutuante de precisão dupla. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

Nullable double: value=1.79769313486231E+308

Confira também

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<DateTime>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para lançar para Nullable<T>DateTime.

Retornos

Nullable<DateTime>

Um Nullable<T> deles DateTime contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido DateTime .

Exemplos

O exemplo a seguir cria um elemento com uma data e hora como conteúdo. Em seguida, ele recupera o valor por conversão de Nullable<T>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 exemplo produz a seguinte saída:

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

Comentários

O comportamento é frouxo ao converter em um Nullable<T> de DateTime um atributo ou elemento. Mesmo que o valor do atributo ou do elemento não esteja formatado exatamente de acordo com a especificação do 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

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Nullable<DateTimeOffset>)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter em um Nullable<T> de DateTimeOffset.

Retornos

Nullable<DateTimeOffset>

Um Nullable<T> deles DateTimeOffset contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não null é e não contém um valor válido DateTimeOffset .

Exemplos

O exemplo a seguir cria um elemento com conteúdo de data e hora. Em seguida, ele é convertido para Nullable<T>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 Nullable(Of DateTimeOffset) = CType(root.<Child>(0), Nullable(Of DateTimeOffset))
Console.WriteLine("dt={0}", dt)

Este exemplo produz a seguinte saída:

<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

Visão geral de LINQ to XML

Aplica-se a

Explicit(XElement to Int32)

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Origem:: XElement.cs

Importante

Esta API não está em conformidade com CLS.

Converta o valor disso 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 para converter para Int32.

Retornos

Int32

Um Int32 que contém o conteúdo deste XElement.

Atributos: CLSCompliantAttribute

Exceções

FormatException

O elemento não contém um valor válido Int32 .

ArgumentNullException

O element parâmetro é null.

Exemplos

O exemplo a seguir cria um elemento com um inteiro como conteúdo. Em seguida, recupera o valor por conversão 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)

Este exemplo produz a seguinte saída:

value=2147483647

Confira também

Visão geral de LINQ to XML

Aplica-se a

Comentários

Esta página foi útil?