XAttribute.Explicit Operador

Definição

Namespace:: System.Xml.Linq

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

Assembly:: System.Xml.Linq.dll

Assembly:: System.Xml.XDocument.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(XAttribute to Nullable<Int64>)	Converta o valor disso XAttribute em um Nullable<T> de Int64.
Explicit(XAttribute to Nullable<Single>)	Converta o valor disso XAttribute em um Nullable<T> de Single.
Explicit(XAttribute to Nullable<TimeSpan>)	Converta o valor disso XAttribute em um Nullable<T> de TimeSpan.
Explicit(XAttribute to Nullable<UInt32>)	Converta o valor disso XAttribute em um Nullable<T> de UInt32.
Explicit(XAttribute to Nullable<UInt64>)	Converta o valor disso XAttribute em um Nullable<T> de UInt64.
Explicit(XAttribute to TimeSpan)	Converta o valor disso XAttribute em um TimeSpan.
Explicit(XAttribute to String)	Converta o valor disso XAttribute em um String.
Explicit(XAttribute to Nullable<Int32>)	Converta o valor disso XAttribute em um Nullable<T> de Int32.
Explicit(XAttribute to UInt32)	Converta o valor disso XAttribute em um UInt32.
Explicit(XAttribute to UInt64)	Converta o valor disso XAttribute em um UInt64.
Explicit(XAttribute to Single)	Converta o valor disso XAttribute em um Single.
Explicit(XAttribute to Nullable<Guid>)	Converta o valor disso XAttribute em um Nullable<T> de Guid.
Explicit(XAttribute to Nullable<Decimal>)	Converta o valor disso XAttribute em um Nullable<T> de Decimal.
Explicit(XAttribute to Decimal)	Converta o valor disso XAttribute em um Decimal.
Explicit(XAttribute to Nullable<DateTimeOffset>)	Converta o valor disso XAttribute em um Nullable<T> de DateTimeOffset.
Explicit(XAttribute to Nullable<DateTime>)	Converta o valor disso XAttribute em um Nullable<T> de DateTime.
Explicit(XAttribute to Nullable<Boolean>)	Converta o valor disso XAttribute em um Nullable<T> de Boolean.
Explicit(XAttribute to Int64)	Converta o valor disso XAttribute em um Int64.
Explicit(XAttribute to Int32)	Converta o valor disso XAttribute em um Int32.
Explicit(XAttribute to Guid)	Converta o valor disso XAttribute em um Guid.
Explicit(XAttribute to Double)	Converta o valor disso XAttribute em um Double.
Explicit(XAttribute to Nullable<Double>)	Converta o valor disso XAttribute em um Nullable<T> de Double.
Explicit(XAttribute to DateTimeOffset)	Converta o valor disso XAttribute em um DateTimeOffset.
Explicit(XAttribute to DateTime)	Converta o valor disso XAttribute em um DateTime.
Explicit(XAttribute to Boolean)	Converta o valor disso XAttribute em um Boolean.

Explicit(XAttribute to Nullable<Int64>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de Int64.

public:
 static explicit operator Nullable<long>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator long?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<int64>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Long)

Parâmetros

attribute: XAttribute

O XAttribute para converter em um Nullable<T> de Int64.

Retornos

Nullable<Int64>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro longo. Em seguida, ele recupera o valor por conversão de Nullable<T>Int64.

XElement root = new XElement("Root",
    new XAttribute("Att", 9223372036854775807)
);
long? value = (long?)root.Attribute("Att");
Console.WriteLine("Nullable long: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="9223372036854775807"/>
Dim value As Nullable(Of Long) = CType(root.Attribute("Att"), Nullable(Of Long))
Console.WriteLine("Nullable long: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Este exemplo produz a seguinte saída:

Nullable long: value=9223372036854775807

Confira também

Aplica-se a

Explicit(XAttribute to Nullable<Single>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de Single.

public:
 static explicit operator Nullable<float>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator float?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<single>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Single)

Parâmetros

attribute: XAttribute

O XAttribute para lançar para Nullable<T>Single.

Retornos

Nullable<Single>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo 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 XAttribute("Att", 3.402823e38)
);
float? value = (float?)root.Attribute("Att");
Console.WriteLine("Nullable Single: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="3.402823E+38"/>
Dim value As Nullable(Of Single) = CType(root.Attribute("Att"), 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

Aplica-se a

Explicit(XAttribute to Nullable<TimeSpan>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de TimeSpan.

public:
 static explicit operator Nullable<TimeSpan>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator TimeSpan?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<TimeSpan>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of TimeSpan)

Parâmetros

attribute: XAttribute

O XAttribute para converter em um Nullable<T> de TimeSpan.

Retornos

Nullable<TimeSpan>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo 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 XAttribute("Att", new TimeSpan(1, 5, 30))
);
TimeSpan? value = (TimeSpan?)root.Attribute("Att");
Console.WriteLine("Nullable TimeSpan: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att=<%= New TimeSpan(1, 5, 30) %>/>
Dim value As Nullable(Of TimeSpan) = CType(root.Attribute("Att"), 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

Aplica-se a

Explicit(XAttribute to Nullable<UInt32>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de UInt32.

public:
 static explicit operator Nullable<System::UInt32>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator uint?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<uint32>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of UInteger)

Parâmetros

attribute: XAttribute

O XAttribute para converter em um Nullable<T> de UInt32.

Retornos

Nullable<UInt32>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo 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 XAttribute("Att", 4294967295)
);
uint? value = (uint?)root.Attribute("Att");
Console.WriteLine("Nullable uint: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="4294967295"/>
Dim value As Nullable(Of UInteger) = CType(root.Attribute("Att"), 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

Aplica-se a

Explicit(XAttribute to Nullable<UInt64>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de UInt64.

public:
 static explicit operator Nullable<System::UInt64>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator ulong?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<uint64>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of ULong)

Parâmetros

attribute: XAttribute

O XAttribute para converter em um Nullable<T> de UInt64.

Retornos

Nullable<UInt64>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo 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 XAttribute("Att", 9223372036854775807)
);
ulong? value = (ulong?)root.Attribute("Att");
Console.WriteLine("Nullable ulong: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="9223372036854775807"/>
Dim value As Nullable(Of ULong) = CType(root.Attribute("Att"), 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

Aplica-se a

Explicit(XAttribute to TimeSpan)

Importante

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

Converta o valor disso XAttribute em um TimeSpan.

public:
 static explicit operator TimeSpan(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator TimeSpan(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> TimeSpan

Public Shared Narrowing Operator CType (attribute As XAttribute) As TimeSpan

Parâmetros

attribute: XAttribute

O XAttribute para converter para TimeSpan.

Retornos

TimeSpan

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo com conteúdo de intervalo de tempo. Em seguida, recupera o valor por conversão em TimeSpan.

XElement root = new XElement("Root",
    new XAttribute("Att", new TimeSpan(1, 5, 30))
);
TimeSpan value = (TimeSpan)root.Attribute("Att");
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att=<%= New TimeSpan(1, 5, 30) %>/>
Dim value As TimeSpan = CType(root.Attribute("Att"), 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

Aplica-se a

Explicit(XAttribute to String)

Importante

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

Converta o valor disso XAttribute em um String.

public:
 static explicit operator System::String ^(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator string(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> string

Public Shared Narrowing Operator CType (attribute As XAttribute) As String

Parâmetros

attribute: XAttribute

O XAttribute para converter para String.

Retornos

String

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

Atributos: CLSCompliantAttribute

Exemplos

O exemplo a seguir cria um atributo com conteúdo de cadeia de caracteres. Em seguida, recupera o valor por conversão em String.

XElement root = new XElement("Root",
    new XAttribute("Att", "attribute content")
);
XAttribute att = root.Attribute("Att");
string str = (string)att;
Console.WriteLine("(string)att={0}", str);

Dim root As XElement = <Root Att="attribute content"/>
Dim att As XAttribute = root.Attribute("Att")
Dim str As String = CStr(att)
Console.WriteLine("(string)att={0}", str)

Este exemplo produz a seguinte saída:

(string)att=attribute content

Confira também

Aplica-se a

Explicit(XAttribute to Nullable<Int32>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de Int32.

public:
 static explicit operator Nullable<int>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator int?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<int>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Integer)

Parâmetros

attribute: XAttribute

O XAttribute para converter em um Nullable<T> de Int32.

Retornos

Nullable<Int32>

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

Atributos: CLSCompliantAttribute

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro. Em seguida, ele recupera o valor por conversão de Nullable<T>Int32.

XElement root = new XElement("Root",
    new XAttribute("Att", 2147483647)
);
int? value = (int?)root.Attribute("Att");
Console.WriteLine("Nullable int: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="2147483647"/>
Dim value As Nullable(Of Integer) = CType(root.Attribute("Att"), Nullable(Of Integer))
Console.WriteLine("Nullable int: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Este exemplo produz a seguinte saída:

Nullable int: value=2147483647

Confira também

Aplica-se a

Explicit(XAttribute to UInt32)

Importante

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

Converta o valor disso XAttribute em um UInt32.

public:
 static explicit operator System::UInt32(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator uint(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> uint32

Public Shared Narrowing Operator CType (attribute As XAttribute) As UInteger

Parâmetros

attribute: XAttribute

O XAttribute para converter para UInt32.

Retornos

UInt32

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro sem sinal. Em seguida, recupera o valor por conversão em UInt32.

XElement root = new XElement("Root",
    new XAttribute("Att", 4294967295)
);
uint value = (uint)root.Attribute("Att");
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att="4294967295"/>
Dim value As UInteger = CUInt(root.Attribute("Att"))
Console.WriteLine("value={0}", value)

Este exemplo produz a seguinte saída:

value=4294967295

Confira também

Aplica-se a

Explicit(XAttribute to UInt64)

Importante

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

Converta o valor disso XAttribute em um UInt64.

public:
 static explicit operator System::UInt64(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator ulong(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> uint64

Public Shared Narrowing Operator CType (attribute As XAttribute) As ULong

Parâmetros

attribute: XAttribute

O XAttribute para converter para UInt64.

Retornos

UInt64

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro longo sem sinal. Em seguida, recupera o valor por conversão em UInt64.

XElement root = new XElement("Root",
    new XAttribute("Att", 1844674407370955161)
);
ulong value = (ulong)root.Attribute("Att");
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att="1844674407370955161"/>
Dim value As ULong = CULng(root.Attribute("Att"))
Console.WriteLine("value={0}", value)

Este exemplo produz a seguinte saída:

value=1844674407370955161

Confira também

Aplica-se a

Explicit(XAttribute to Single)

Importante

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

Converta o valor disso XAttribute em um Single.

public:
 static explicit operator float(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator float(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> single

Public Shared Narrowing Operator CType (attribute As XAttribute) As Single

Parâmetros

attribute: XAttribute

O XAttribute para converter para Single.

Retornos

Single

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo 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",
    new XAttribute("Att", 3.402823e38)
);
float value = (float)root.Attribute("Att");
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att="3.402823E+38"/>
Dim value As Single = CSng(root.Attribute("Att"))
Console.WriteLine("value={0}", value)

Este exemplo produz a seguinte saída:

value=3.402823E+38

Confira também

Aplica-se a

Explicit(XAttribute to Nullable<Guid>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de Guid.

public:
 static explicit operator Nullable<Guid>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator Guid?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<Guid>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Guid)

Parâmetros

attribute: XAttribute

O XAttribute para converter em um Nullable<T> de Guid.

Retornos

Nullable<Guid>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo de guid. Em seguida, ele recupera o valor por conversão de Nullable<T>Guid.

XElement root = new XElement("Root",
    new XAttribute("Att", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"))
);
Guid? value = (Guid?)root.Attribute("Att");
Console.WriteLine("Nullable Guid: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att=<%= New Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730") %>/>
Dim value As Nullable(Of Guid) = CType(root.Attribute("Att"), 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

Aplica-se a

Explicit(XAttribute to Nullable<Decimal>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de Decimal.

public:
 static explicit operator Nullable<System::Decimal>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator decimal?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<decimal>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Decimal)

Parâmetros

attribute: XAttribute

O XAttribute para lançar para Nullable<T>Decimal.

Retornos

Nullable<Decimal>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo decimal. Em seguida, ele recupera o valor por conversão de Nullable<T>Decimal.

XElement root = new XElement("Root",
    new XAttribute("Att", "79228162514264337593543950335")
);
decimal? value = (decimal?)root.Attribute("Att");
Console.WriteLine("Nullable decimal: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="79228162514264337593543950335"/>
Dim value As Nullable(Of Decimal) = CType(root.Attribute("Att"), 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

Aplica-se a

Explicit(XAttribute to Decimal)

Importante

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

Converta o valor disso XAttribute em um Decimal.

public:
 static explicit operator System::Decimal(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator decimal(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> decimal

Public Shared Narrowing Operator CType (attribute As XAttribute) As Decimal

Parâmetros

attribute: XAttribute

O XAttribute para converter para Decimal.

Retornos

Decimal

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo com um valor decimal. Em seguida, recupera o valor do atributo convertendo em Decimal.

XElement root = new XElement("Root",
    new XAttribute("Att", "79228162514264337593543950335")
);
decimal value = (decimal)root.Attribute("Att");
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att="79228162514264337593543950335"/>
Dim value As Decimal = CDec(root.Attribute("Att"))
Console.WriteLine("value={0}", value)

Este exemplo produz a seguinte saída:

value=79228162514264337593543950335

Confira também

Aplica-se a

Explicit(XAttribute to Nullable<DateTimeOffset>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de DateTimeOffset.

public:
 static explicit operator Nullable<DateTimeOffset>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTimeOffset?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<DateTimeOffset>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of DateTimeOffset)

Parâmetros

attribute: XAttribute

O XAttribute para converter em um Nullable<T> de DateTimeOffset.

Retornos

Nullable<DateTimeOffset>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo com uma data e hora como conteúdo. Em seguida, ele recupera o valor por conversão de Nullable<T>DateTimeOffset.

XElement root = new XElement("Root",
    new XAttribute("Att", new DateTimeOffset(new DateTime(2006, 10, 6, 12, 30, 0)))
);
DateTimeOffset? value = (DateTimeOffset?)root.Attribute("Att");
Console.WriteLine("Nullable DateTimeOffset: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = _
    <Root
        Att=<%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %>/>
Dim value As Nullable(Of DateTimeOffset) = CType(root.Attribute("Att"), Nullable(Of DateTimeOffset))
Console.WriteLine("Nullable DateTimeOffset: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Este exemplo produz a seguinte saída:

Nullable DateTimeOffset: value=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.

Aplica-se a

Explicit(XAttribute to Nullable<DateTime>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de DateTime.

public:
 static explicit operator Nullable<DateTime>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTime?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<DateTime>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of DateTime)

Parâmetros

attribute: XAttribute

O XAttribute para converter em um Nullable<T> de DateTime.

Retornos

Nullable<DateTime>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo 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 XAttribute("Att", new DateTime(2006, 10, 6, 12, 30, 0))
);
DateTime? value = (DateTime?)root.Attribute("Att");
Console.WriteLine("Nullable DateTime: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att=<%= New DateTime(2006, 10, 6, 12, 30, 0) %>/>
Dim value As Nullable(Of DateTime) = CType(root.Attribute("Att"), 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 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 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

Aplica-se a

Explicit(XAttribute to Nullable<Boolean>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de Boolean.

public:
 static explicit operator Nullable<bool>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator bool?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<bool>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Boolean)

Parâmetros

attribute: XAttribute

O XAttribute para lançar para Nullable<T>Boolean.

Retornos

Nullable<Boolean>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo booliano. Em seguida, ele recupera o valor por conversão de Nullable<T>Boolean.

XElement root = new XElement("Root",
    new XAttribute("BoolValue1", true),
    new XAttribute("BoolValue2", false)
);
bool? bool1 = (bool?)root.Attribute("BoolValue1");
bool? bool2 = (bool?)root.Attribute("BoolValue2");
Console.WriteLine("Nullable boolean: BoolValue1={0}", bool1);
Console.WriteLine("Nullable boolean: BoolValue2={0}", bool2);

Dim root As XElement = <Root BoolValue1="true" BoolValue2="false"/>
Dim bool1 As Nullable(Of Boolean) = CType(root.Attribute("BoolValue1"), Nullable(Of Boolean))
Dim bool2 As Nullable(Of Boolean) = CType(root.Attribute("BoolValue2"), Nullable(Of Boolean))
Console.WriteLine("Nullable boolean: BoolValue1={0}", bool1)
Console.WriteLine("Nullable boolean: BoolValue2={0}", bool2)

Este exemplo produz a seguinte saída:

Nullable boolean: BoolValue1=True
Nullable boolean: 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

Aplica-se a

Explicit(XAttribute to Int64)

Importante

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

Converta o valor disso XAttribute em um Int64.

public:
 static explicit operator long(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator long(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> int64

Public Shared Narrowing Operator CType (attribute As XAttribute) As Long

Parâmetros

attribute: XAttribute

O XAttribute para converter para Int64.

Retornos

Int64

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo com um inteiro longo como conteúdo. Em seguida, recupera o valor do atributo convertendo em Int64.

XElement root = new XElement("Root",
    new XAttribute("Att", 9223372036854775807)
);
long value = (long)root.Attribute("Att");
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att="9223372036854775807"/>
Dim value As Long = CLng(root.Attribute("Att"))
Console.WriteLine("value={0}", value)

Este exemplo produz a seguinte saída:

value=9223372036854775807

Confira também

Aplica-se a

Explicit(XAttribute to Int32)

Importante

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

Converta o valor disso XAttribute em um Int32.

public:
 static explicit operator int(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator int(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> int

Public Shared Narrowing Operator CType (attribute As XAttribute) As Integer

Parâmetros

attribute: XAttribute

O XAttribute para converter para Int32.

Retornos

Int32

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo com um inteiro como conteúdo. Em seguida, recupera o valor por conversão em Int32.

XElement root = new XElement("Root",
    new XAttribute("Att", 2147483647)
);
int value = (int)root.Attribute("Att");
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att="2147483647"/>
Dim value As Integer = CInt(root.Attribute("Att"))
Console.WriteLine("value={0}", value)

Este exemplo produz a seguinte saída:

value=2147483647

Confira também

Aplica-se a

Explicit(XAttribute to Guid)

Importante

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

Converta o valor disso XAttribute em um Guid.

public:
 static explicit operator Guid(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator Guid(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Guid

Public Shared Narrowing Operator CType (attribute As XAttribute) As Guid

Parâmetros

attribute: XAttribute

O XAttribute para converter para Guid.

Retornos

Guid

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo com um GUID como conteúdo. Em seguida, recupera o valor por conversão em Guid.

XElement root = new XElement("Root",
    new XAttribute("Att", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"))
);
Guid value = (Guid)root.Attribute("Att");
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att=<%= New Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730") %>/>
Dim value As Guid = CType(root.Attribute("Att"), Guid)
Console.WriteLine("value={0}", value)

Este exemplo produz a seguinte saída:

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

Confira também

Aplica-se a

Explicit(XAttribute to Double)

Importante

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

Converta o valor disso XAttribute em um Double.

public:
 static explicit operator double(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator double(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> double

Public Shared Narrowing Operator CType (attribute As XAttribute) As Double

Parâmetros

attribute: XAttribute

O XAttribute para converter para Double.

Retornos

Double

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é 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",
    new XAttribute("Att", 1.79769313486231e308)
);
double value = (double)root.Attribute("Att");
Console.WriteLine("value={0}", value);

Dim root As XElement = <Root Att="1.79769313486231E+308"/>
Dim value As Double = CDbl(root.Attribute("Att"))
Console.WriteLine("value={0}", value)

Este exemplo produz a seguinte saída:

value=1.79769313486231E+308

Confira também

Aplica-se a

Explicit(XAttribute to Nullable<Double>)

Importante

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

Converta o valor disso XAttribute em um Nullable<T> de Double.

public:
 static explicit operator Nullable<double>(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator double?(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> Nullable<double>

Public Shared Narrowing Operator CType (attribute As XAttribute) As Nullable(Of Double)

Parâmetros

attribute: XAttribute

O XAttribute para lançar para Nullable<T>Double.

Retornos

Nullable<Double>

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

Exemplos

O exemplo a seguir cria um atributo 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 XAttribute("Att", 1.79769313486231e308)
);
double? value = (double?)root.Attribute("Att");
Console.WriteLine("Nullable double: value={0}", value == null ? "null" : value.ToString());

Dim root As XElement = <Root Att="1.79769313486231E+308"/>
Dim value As Nullable(Of Double) = CType(root.Attribute("Att"), 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

Aplica-se a

Explicit(XAttribute to DateTimeOffset)

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::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTimeOffset(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> DateTimeOffset

Public Shared Narrowing Operator CType (attribute As XAttribute) As DateTimeOffset

Parâmetros

attribute: XAttribute

O XAttribute para converter para DateTimeOffset.

Retornos

DateTimeOffset

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo com conteúdo de data e hora. Em seguida, ele o converte para DateTimeOffset recuperar o valor.

XElement root = new XElement("Root",
    new XAttribute("Att", new DateTimeOffset(new DateTime(2006, 10, 6, 12, 30, 0)))
);
Console.WriteLine(root);

// casting from a strictly formatted XML attribute
DateTimeOffset dt = (DateTimeOffset)root.Attribute("Att");
Console.WriteLine("dt={0}", dt);

Dim root As XElement = _
    <Root
        Att=<%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %>/>
Console.WriteLine(root)

' casting from a strictly formatted XML attribute
Dim dt As DateTimeOffset = CType(root.Attribute("Att"), DateTimeOffset)
Console.WriteLine("dt={0}", dt)

Este exemplo produz a seguinte saída:

<Root Att="2006-10-06T12:30:00-07:00" />
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(XAttribute to DateTime)

Importante

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

Converta o valor disso XAttribute em um DateTime.

public:
 static explicit operator DateTime(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator DateTime(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> DateTime

Public Shared Narrowing Operator CType (attribute As XAttribute) As DateTime

Parâmetros

attribute: XAttribute

O XAttribute para converter para DateTime.

Retornos

DateTime

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo 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 XAttribute("Att", new DateTime(2006, 10, 6, 12, 30, 0))
);
Console.WriteLine(root);

// casting from a strictly formatted XML attribute
DateTime dt = (DateTime)root.Attribute("Att");
Console.WriteLine("dt={0}", dt);
Console.WriteLine("-----");

// if root is formatted in some different way than the standard ISO 8601, if at all possible,
// the value is appropriately converted to DateTime

XAttribute dtAtt = new XAttribute("OrderDate", "October 6, 2006");
Console.WriteLine(dtAtt);
DateTime orderDate = (DateTime)dtAtt;
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 Att=<%= New DateTime(2006, 10, 6, 12, 30, 0) %>/>

Console.WriteLine(root)

' casting from a strictly formatted XML attribute
Dim dt As DateTime = CType(root.Attribute("Att"), DateTime)
Console.WriteLine("dt={0}", dt)
Console.WriteLine("-----")

' if root is formatted in some different way than the standard ISO 8601, if at all possible,
' the value is appropriately converted to DateTime
Dim dtAtt As XAttribute = New XAttribute("OrderDate", "October 6, 2006")
Console.WriteLine(dtAtt)
Dim orderDate As DateTime = CType(dtAtt, DateTime)
Console.WriteLine("OrderDate={0:d}", orderDate)

Este exemplo produz a seguinte saída:

<Root Att="2006-10-06T12:30:00" />
dt=10/6/2006 12:30:00 PM
-----
OrderDate="October 6, 2006"
OrderDate=10/6/2006

Comentários

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

Aplica-se a

Explicit(XAttribute to Boolean)

Importante

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

Converta o valor disso XAttribute em um Boolean.

public:
 static explicit operator bool(System::Xml::Linq::XAttribute ^ attribute);

[System.CLSCompliant(false)]
public static explicit operator bool(System.Xml.Linq.XAttribute attribute);

[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XAttribute -> bool

Public Shared Narrowing Operator CType (attribute As XAttribute) As Boolean

Parâmetros

attribute: XAttribute

O XAttribute para converter para Boolean.

Retornos

Boolean

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

Atributos: CLSCompliantAttribute

Exceções

FormatException

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

ArgumentNullException

O attribute parâmetro é null.

Exemplos

O exemplo a seguir cria um atributo com um Boolean valor e, em seguida, o converte em Boolean.

XElement root = new XElement("Root",
    new XAttribute("BoolValue", true)
);
bool bv = (bool)root.Attribute("BoolValue");
Console.WriteLine("(bool)BoolValue={0}", bv);

Dim root As XElement = <root BoolValue="true"/>
Dim bv As Boolean = CBool(root.Attribute("BoolValue"))
Console.WriteLine("(bool)BoolValue={0}", bv)

Este exemplo produz a seguinte saída:

(bool)BoolValue=True

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

Aplica-se a

Comentários

Esta página foi útil?