XAttribute.Explicit Operador

Definição

Sobrecargas

Explicit(XAttribute to Nullable<Int64>)

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

Explicit(XAttribute to Nullable<Single>)

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

Explicit(XAttribute to Nullable<TimeSpan>)

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

Explicit(XAttribute to Nullable<UInt32>)

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

Explicit(XAttribute to Nullable<UInt64>)

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

Explicit(XAttribute to TimeSpan)

Converta o valor deste XAttribute em um TimeSpan.

Explicit(XAttribute to String)

Converta o valor deste XAttribute em um String.

Explicit(XAttribute to Nullable<Int32>)

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

Explicit(XAttribute to UInt32)

Converta o valor deste XAttribute em um UInt32.

Explicit(XAttribute to UInt64)

Converta o valor deste XAttribute em um UInt64.

Explicit(XAttribute to Single)

Converta o valor deste XAttribute em um Single.

Explicit(XAttribute to Nullable<Guid>)

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

Explicit(XAttribute to Nullable<Decimal>)

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

Explicit(XAttribute to Decimal)

Converta o valor deste XAttribute em um Decimal.

Explicit(XAttribute to Nullable<DateTimeOffset>)

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

Explicit(XAttribute to Nullable<DateTime>)

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

Explicit(XAttribute to Nullable<Boolean>)

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

Explicit(XAttribute to Int64)

Converta o valor deste XAttribute em um Int64.

Explicit(XAttribute to Int32)

Converta o valor deste XAttribute em um Int32.

Explicit(XAttribute to Guid)

Converta o valor deste XAttribute em um Guid.

Explicit(XAttribute to Double)

Converta o valor deste XAttribute em um Double.

Explicit(XAttribute to Nullable<Double>)

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

Explicit(XAttribute to DateTimeOffset)

Converta o valor deste XAttribute em um DateTimeOffset.

Explicit(XAttribute to DateTime)

Converta o valor deste XAttribute em um DateTime.

Explicit(XAttribute to Boolean)

Converta o valor deste XAttribute em um Boolean.

Explicit(XAttribute to Nullable<Int64>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para um Nullable<T> de Int64.

Retornos

Nullable<Int64>

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

Atributos

Exceções

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro longo. Em seguida, ele recupera o valor convertendo em 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());  

Esse exemplo gera a saída a seguir:

Nullable long: value=9223372036854775807  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<Single>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para Nullable<T> de Single.

Retornos

Nullable<Single>

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

Atributos

Exceções

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo de ponto flutuante de precisão única. Em seguida, ele recupera o valor convertendo em 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());  

Esse exemplo gera a saída a seguir:

Nullable Single: value=3.402823E+38  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<TimeSpan>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para um Nullable<T> de TimeSpan.

Retornos

Nullable<TimeSpan>

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

Atributos

Exceções

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo de intervalo de tempo. Em seguida, ele recupera o valor convertendo em 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());  

Esse exemplo gera a saída a seguir:

Nullable TimeSpan: value=01:05:30  

Comentários

O espaço de valor de um atributo ou elemento que contém conteúdo de intervalo de tempo está intimamente relacionado ao conteúdo de duração, conforme descrito 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 para um Nullable<T> de TimeSpan um atributo ou elemento. Mesmo que o valor do atributo ou elemento não esteja formatado exatamente de acordo com a especificação W3C, o valor será convertido adequadamente em um Nullable<T> de TimeSpan.

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<UInt32>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para um Nullable<T> de UInt32.

Retornos

Nullable<UInt32>

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

Atributos

Exceções

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro sem sinal. Em seguida, ele recupera o valor convertendo em 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());  

Esse exemplo gera a saída a seguir:

Nullable uint: value=4294967295  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<UInt64>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para um Nullable<T> de UInt64.

Retornos

Nullable<UInt64>

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

Atributos

Exceções

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro longo sem sinal. Em seguida, ele recupera o valor convertendo em 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());  

Esse exemplo gera a saída a seguir:

Nullable ulong: value=9223372036854775807  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to TimeSpan)

Importante

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

Converta o valor deste XAttribute em um TimeSpan.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em TimeSpan.

Retornos

TimeSpan

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

Atributos

Exceções

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

O parâmetro attribute é null.

Exemplos

O exemplo a seguir cria um atributo com conteúdo de intervalo de tempo. Em seguida, ele 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);  

Esse exemplo gera a saída a seguir:

value=01:05:30  

Comentários

O espaço de valor de um atributo ou elemento que contém conteúdo de intervalo de tempo está intimamente relacionado ao conteúdo de duração, conforme descrito 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 para um TimeSpan de um atributo ou elemento. Mesmo que o valor do atributo ou do elemento não seja formatado exatamente de acordo com a especificação do W3C, o valor será convertido adequadamente em um TimeSpan.

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to String)

Importante

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

Converta o valor deste XAttribute em um String.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em String.

Retornos

String

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

Atributos

Exemplos

O exemplo a seguir cria um atributo com conteúdo de cadeia de caracteres. Em seguida, ele recupera o valor convertendo 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);  

Esse exemplo gera a saída a seguir:

(string)att=attribute content  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<Int32>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para um Nullable<T> de Int32.

Retornos

Nullable<Int32>

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

Atributos

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro. Em seguida, ele recupera o valor convertendo em 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());  

Esse exemplo gera a saída a seguir:

Nullable int: value=2147483647  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to UInt32)

Importante

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

Converta o valor deste XAttribute em um UInt32.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em UInt32.

Retornos

UInt32

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

Atributos

Exceções

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

O parâmetro attribute é null.

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro sem sinal. Em seguida, ele 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);  

Esse exemplo gera a saída a seguir:

value=4294967295  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to UInt64)

Importante

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

Converta o valor deste XAttribute em um UInt64.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em UInt64.

Retornos

UInt64

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

Atributos

Exceções

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

O parâmetro attribute é null.

Exemplos

O exemplo a seguir cria um atributo com conteúdo inteiro longo sem sinal. Em seguida, ele 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);  

Esse exemplo gera a saída a seguir:

value=1844674407370955161  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Single)

Importante

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

Converta o valor deste XAttribute em um Single.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em Single.

Retornos

Single

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

Atributos

Exceções

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

O parâmetro attribute é null.

Exemplos

O exemplo a seguir cria um atributo com conteúdo de ponto flutuante de precisão única. Em seguida, ele recupera o valor convertendo em Single.

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

Esse exemplo gera a saída a seguir:

value=3.402823E+38  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<Guid>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para um Nullable<T> de Guid.

Retornos

Nullable<Guid>

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

Atributos

Exceções

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo guid. Em seguida, ele recupera o valor convertendo em 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());  

Esse exemplo gera a saída a seguir:

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

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<Decimal>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para Nullable<T> de Decimal.

Retornos

Nullable<Decimal>

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

Atributos

Exceções

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo decimal. Em seguida, ele recupera o valor convertendo em 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());  

Esse exemplo gera a saída a seguir:

Nullable decimal: value=79228162514264337593543950335  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Decimal)

Importante

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

Converta o valor deste XAttribute em um Decimal.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em Decimal.

Retornos

Decimal

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

Atributos

Exceções

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

O parâmetro attribute é null.

Exemplos

O exemplo a seguir cria um atributo com um valor decimal. Em seguida, ele recupera o valor do atributo por conversão em Decimal.

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

Esse exemplo gera a saída a seguir:

value=79228162514264337593543950335  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<DateTimeOffset>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para um Nullable<T> de DateTimeOffset.

Retornos

Nullable<DateTimeOffset>

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

Atributos

Exceções

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

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());  

Esse exemplo gera a saída a seguir:

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

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<DateTime>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para um Nullable<T> de DateTime.

Retornos

Nullable<DateTime>

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

Atributos

Exceções

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

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());  

Esse exemplo gera a saída a seguir:

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

Comentários

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

O comportamento é frouxo ao converter para um Nullable<T> de DateTime um atributo ou elemento. Mesmo que o valor do atributo ou do elemento não seja 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

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<Boolean>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para Nullable<T> de Boolean.

Retornos

Nullable<Boolean>

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

Atributos

Exceções

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

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);  

Esse exemplo gera a saída a seguir:

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 produz "true" ou "false" após a divisão e conversão em minúsculas.

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Int64)

Importante

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

Converta o valor deste XAttribute em um Int64.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em Int64.

Retornos

Int64

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

Atributos

Exceções

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

O parâmetro attribute é null.

Exemplos

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

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

Esse exemplo gera a saída a seguir:

value=9223372036854775807  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Int32)

Importante

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

Converta o valor deste XAttribute em um Int32.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em Int32.

Retornos

Int32

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

Atributos

Exceções

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

O parâmetro attribute é null.

Exemplos

O exemplo a seguir cria um atributo com um inteiro como conteúdo. Em seguida, ele 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);  

Esse exemplo gera a saída a seguir:

value=2147483647  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Guid)

Importante

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

Converta o valor deste XAttribute em um Guid.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em Guid.

Retornos

Guid

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

Atributos

Exceções

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

O parâmetro attribute é null.

Exemplos

O exemplo a seguir cria um atributo com um GUID como conteúdo. Em seguida, ele 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);  

Esse exemplo gera a saída a seguir:

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

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Double)

Importante

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

Converta o valor deste XAttribute em um Double.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em Double.

Retornos

Double

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

Atributos

Exceções

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

O parâmetro attribute é null.

Exemplos

O exemplo a seguir cria um atributo com Double conteúdo. Em seguida, ele 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);  

Esse exemplo gera a saída a seguir:

value=1.79769313486231E+308  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Nullable<Double>)

Importante

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

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

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido para Nullable<T> de Double.

Retornos

Nullable<Double>

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

Atributos

Exceções

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

Exemplos

O exemplo a seguir cria um atributo com conteúdo de ponto flutuante de precisão dupla. Em seguida, ele recupera o valor convertendo em 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());  

Esse exemplo gera a saída a seguir:

Nullable double: value=1.79769313486231E+308  

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to DateTimeOffset)

Importante

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

Converta o valor deste XAttribute em um DateTimeOffset.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em DateTimeOffset.

Retornos

DateTimeOffset

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

Atributos

Exceções

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

O parâmetro attribute é 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);  

Esse exemplo gera a saída a seguir:

<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

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to DateTime)

Importante

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

Converta o valor deste XAttribute em um DateTime.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em DateTime.

Retornos

DateTime

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

Atributos

Exceções

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

O parâmetro attribute é 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);  

Esse exemplo gera a saída a seguir:

<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 espaço de valor de um atributo ou elemento que contém conteúdo de data e hora está intimamente relacionado às datas e horas descritas no ISO 8601. Ao criar um atributo ou elemento que contenha conteúdo de data e hora, os valores de atributo ou elemento são formatados de acordo com a especificação W3C. Consulte a especificação 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 seja 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

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Explicit(XAttribute to Boolean)

Importante

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

Converta o valor deste XAttribute em um Boolean.

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

Parâmetros

attribute
XAttribute

O XAttribute a ser convertido em Boolean.

Retornos

Boolean

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

Atributos

Exceções

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

O parâmetro attribute é 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);  

Esse exemplo gera a saída a seguir:

(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 produz "true" ou "false" após a divisão e conversão em minúsculas.

Confira também

Aplica-se a

.NET 7 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0