XAttribute.Explicit Operador

Definição

Espaço de Nomes:: System.Xml.Linq

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

Assemblagem:: System.Xml.Linq.dll

Assemblagem:: System.Xml.XDocument.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Description
Explicit(XAttribute to Nullable<Int64>)	Atribui o valor disto XAttribute a Nullable<T> um de Int64.
Explicit(XAttribute to Nullable<Single>)	Atribui o valor disto XAttribute a Nullable<T> um de Single.
Explicit(XAttribute to Nullable<TimeSpan>)	Atribui o valor disto XAttribute a Nullable<T> um de TimeSpan.
Explicit(XAttribute to Nullable<UInt32>)	Atribui o valor disto XAttribute a Nullable<T> um de UInt32.
Explicit(XAttribute to Nullable<UInt64>)	Atribui o valor disto XAttribute a Nullable<T> um de UInt64.
Explicit(XAttribute to TimeSpan)	Atribui o valor disto XAttribute a um TimeSpan.
Explicit(XAttribute to String)	Atribui o valor disto XAttribute a um String.
Explicit(XAttribute to Nullable<Int32>)	Atribui o valor disto XAttribute a Nullable<T> um de Int32.
Explicit(XAttribute to UInt32)	Atribui o valor disto XAttribute a um UInt32.
Explicit(XAttribute to UInt64)	Atribui o valor disto XAttribute a um UInt64.
Explicit(XAttribute to Single)	Atribui o valor disto XAttribute a um Single.
Explicit(XAttribute to Nullable<Guid>)	Atribui o valor disto XAttribute a Nullable<T> um de Guid.
Explicit(XAttribute to Nullable<Decimal>)	Atribui o valor disto XAttribute a Nullable<T> um de Decimal.
Explicit(XAttribute to Decimal)	Atribui o valor disto XAttribute a um Decimal.
Explicit(XAttribute to Nullable<DateTimeOffset>)	Atribui o valor disto XAttribute a Nullable<T> um de DateTimeOffset.
Explicit(XAttribute to Nullable<DateTime>)	Atribui o valor disto XAttribute a Nullable<T> um de DateTime.
Explicit(XAttribute to Nullable<Boolean>)	Atribui o valor disto XAttribute a Nullable<T> um de Boolean.
Explicit(XAttribute to Int64)	Atribui o valor disto XAttribute a um Int64.
Explicit(XAttribute to Int32)	Atribui o valor disto XAttribute a um Int32.
Explicit(XAttribute to Guid)	Atribui o valor disto XAttribute a um Guid.
Explicit(XAttribute to Double)	Atribui o valor disto XAttribute a um Double.
Explicit(XAttribute to Nullable<Double>)	Atribui o valor disto XAttribute a Nullable<T> um de Double.
Explicit(XAttribute to DateTimeOffset)	Atribui o valor disto XAttribute a um DateTimeOffset.
Explicit(XAttribute to DateTime)	Atribui o valor disto XAttribute a um DateTime.
Explicit(XAttribute to Boolean)	Atribui o valor disto XAttribute a um Boolean.

Explicit(XAttribute to Nullable<Int64>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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 lançar para um Nullable<T> de Int64.

Devoluções

Nullable<Int64>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com conteúdo inteiro longo. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<Single>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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> de Single.

Devoluções

Nullable<Single>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com conteúdo de ponto flutuante de precisão simples. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<TimeSpan>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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 lançar para um Nullable<T> de TimeSpan.

Devoluções

Nullable<TimeSpan>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com conteúdo de intervalo temporal. Depois recupera o valor lançando para 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

Observações

O espaço de valores de um atributo ou elemento que contém conteúdo de intervalo temporal está intimamente relacionado com o conteúdo de duração, conforme descrito na ISO 8601. Ao criar um atributo ou elemento que contém conteúdo de intervalo temporal, os valores do atributo ou elemento são formatados de acordo com a especificação do W3C. Por favor, consulte a especificação do W3C para mais detalhes.

O comportamento é relaxado ao lançar para um Nullable<T> de TimeSpan a partir de um atributo ou elemento. Mesmo que o valor do atributo ou elemento não esteja formatado exatamente de acordo com a especificação do W3C, o valor é devidamente convertido para um Nullable<T> de TimeSpan.

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<UInt32>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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 lançar para um Nullable<T> de UInt32.

Devoluções

Nullable<UInt32>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com conteúdo inteiro sem sinal. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<UInt64>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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 lançar para um Nullable<T> de UInt64.

Devoluções

Nullable<UInt64>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com conteúdo inteiro longo sem sinal. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to TimeSpan)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para TimeSpan.

Devoluções

TimeSpan

A 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 seguinte cria um atributo com conteúdo de intervalo temporal. Depois recupera o valor lançando para 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

Observações

O comportamento é relaxado ao lançar para TimeSpan um de um atributo ou elemento. Mesmo que o valor do atributo ou elemento não esteja formatado exatamente de acordo com a especificação do W3C, o valor é devidamente convertido para um TimeSpan.

Ver também

Aplica-se a

Explicit(XAttribute to String)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para String.

Devoluções

String

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

Atributos: CLSCompliantAttribute

Exemplos

O exemplo seguinte cria um atributo com conteúdo de cadeia. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<Int32>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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 lançar para um Nullable<T> de Int32.

Devoluções

Nullable<Int32>

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

Atributos: CLSCompliantAttribute

Exemplos

O exemplo seguinte cria um atributo com conteúdo inteiro. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to UInt32)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para UInt32.

Devoluções

UInt32

A 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 seguinte cria um atributo com conteúdo inteiro sem sinal. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to UInt64)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para UInt64.

Devoluções

UInt64

A 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 seguinte cria um atributo com conteúdo inteiro longo sem sinal. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Single)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para Single.

Devoluções

Single

A 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 seguinte cria um atributo com conteúdo de ponto flutuante de precisão simples. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<Guid>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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 lançar para um Nullable<T> de Guid.

Devoluções

Nullable<Guid>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com conteúdo GUID. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<Decimal>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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> de Decimal.

Devoluções

Nullable<Decimal>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com conteúdo decimal. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Decimal)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para Decimal.

Devoluções

Decimal

A 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 seguinte cria um atributo com valor decimal. Depois, recupera o valor do atributo castando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<DateTimeOffset>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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 lançar para um Nullable<T> de DateTimeOffset.

Devoluções

Nullable<DateTimeOffset>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com uma data e hora como conteúdo. Depois recupera o valor lançando para 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

Observações

Este operador de conversão usa a XmlConvert classe para realizar a conversão.

Aplica-se a

Explicit(XAttribute to Nullable<DateTime>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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 lançar para um Nullable<T> de DateTime.

Devoluções

Nullable<DateTime>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com uma data e hora como conteúdo. Depois recupera o valor lançando para 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

Observações

O espaço de valores de um atributo ou elemento que contém conteúdo de data e hora está intimamente relacionado com as datas e horas descritas na ISO 8601. Ao criar um atributo ou elemento que contém conteúdo de data e hora, os valores do atributo ou elemento são formatados de acordo com a especificação do W3C. Consulte a especificação do W3C para mais detalhes.

O comportamento é relaxado ao lançar para um Nullable<T> de DateTime a partir de um atributo ou elemento. Mesmo que o valor do atributo ou elemento não esteja formatado exatamente de acordo com a especificação do W3C, o valor é devidamente convertido para um Nullable<T> de DateTime.

Este operador de conversão usa CultureInfo.InvariantCulture para converter a partir de um DateTime.

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<Boolean>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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> de Boolean.

Devoluções

Nullable<Boolean>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com conteúdo booleano. Depois recupera o valor lançando para 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

Observações

Ao converter para Boolean a partir de um atributo ou elemento, os valores permitidos são "0", "1" e qualquer cadeia que produza "verdadeiro" ou "falso" após corte e conversão para minúscula.

Ver também

Aplica-se a

Explicit(XAttribute to Int64)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para Int64.

Devoluções

Int64

A 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 seguinte cria um atributo com um inteiro longo como conteúdo. Depois, recupera o valor do atributo castando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Int32)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para Int32.

Devoluções

Int32

A 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 seguinte cria um atributo com um inteiro como conteúdo. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Guid)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para Guid.

Devoluções

Guid

A 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 seguinte cria um atributo com um GUID como conteúdo. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Double)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para Double.

Devoluções

Double

A 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 seguinte cria um atributo com Double conteúdo. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to Nullable<Double>)

Importante

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

Atribui o valor disto XAttribute a Nullable<T> um 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> de Double.

Devoluções

Nullable<Double>

Um Nullable<T> de 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 .

Exemplos

O exemplo seguinte cria um atributo com conteúdo de ponto flutuante de dupla precisão. Depois recupera o valor lançando para 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

Ver também

Aplica-se a

Explicit(XAttribute to DateTimeOffset)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para DateTimeOffset.

Devoluções

DateTimeOffset

A 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 seguinte cria um atributo com conteúdo de data e hora. Depois, lança-o 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

Observações

Este operador de conversão usa a XmlConvert classe para realizar a conversão.

Ver também

Aplica-se a

Explicit(XAttribute to DateTime)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para DateTime.

Devoluções

DateTime

A 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 seguinte cria um atributo com conteúdo de data e hora. Depois, lança-o 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

Observações

O comportamento é relaxado ao lançar para DateTime um de um atributo ou elemento. Mesmo que o valor do atributo ou elemento não esteja formatado exatamente de acordo com a especificação do W3C, o valor é devidamente convertido para um DateTime.

Este operador de conversão usa CultureInfo.InvariantCulture para converter a partir de um DateTime.

Ver também

Aplica-se a

Explicit(XAttribute to Boolean)

Importante

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

Atribui o valor disto XAttribute a 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 lançar para Boolean.

Devoluções

Boolean

A 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 seguinte cria um atributo com um Boolean valor, depois lança-o para 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

Observações

Ao converter para Boolean a partir de um atributo ou elemento, os valores permitidos são "0", "1" e qualquer cadeia que produza "verdadeiro" ou "falso" após corte e conversão para minúscula.

Ver também

Aplica-se a

Comentários

Esta página foi útil?