XElement.Explicit Operatore

Definizione

Overload

Explicit(XElement to Nullable<Int64>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Int64.

Explicit(XElement to Nullable<Single>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Single.

Explicit(XElement to Nullable<TimeSpan>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di TimeSpan.

Explicit(XElement to Nullable<UInt32>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di UInt32.

Explicit(XElement to Nullable<UInt64>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di UInt64.

Explicit(XElement to UInt32)

Esegue il cast del valore dell'oggetto XElement a un oggetto UInt32.

Explicit(XElement to String)

Esegue il cast del valore dell'oggetto XElement a un oggetto String.

Explicit(XElement to TimeSpan)

Esegue il cast del valore dell'oggetto XElement a un oggetto TimeSpan.

Explicit(XElement to UInt64)

Esegue il cast del valore dell'oggetto XElement a un oggetto UInt64.

Explicit(XElement to Nullable<Int32>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Int32.

Explicit(XElement to Single)

Esegue il cast del valore dell'oggetto XElement a un oggetto Single.

Explicit(XElement to Nullable<Guid>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Guid.

Explicit(XElement to Nullable<Boolean>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Boolean.

Explicit(XElement to Nullable<Decimal>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Decimal.

Explicit(XElement to Boolean)

Esegue il cast del valore dell'oggetto XElement a un oggetto Boolean.

Explicit(XElement to DateTime)

Esegue il cast del valore dell'oggetto XElement a un oggetto DateTime.

Explicit(XElement to DateTimeOffset)

Esegue il cast del valore dell'oggetto XAttribute a un oggetto DateTimeOffset.

Explicit(XElement to Double)

Esegue il cast del valore dell'oggetto XElement a un oggetto Double.

Explicit(XElement to Guid)

Esegue il cast del valore dell'oggetto XElement a un oggetto Guid.

Explicit(XElement to Decimal)

Esegue il cast del valore dell'oggetto XElement a un oggetto Decimal.

Explicit(XElement to Int64)

Esegue il cast del valore dell'oggetto XElement a un oggetto Int64.

Explicit(XElement to Nullable<Double>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Double.

Explicit(XElement to Nullable<DateTime>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di DateTime.

Explicit(XElement to Nullable<DateTimeOffset>)

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di DateTimeOffset.

Explicit(XElement to Int32)

Esegue il cast del valore dell'oggetto XElement a un oggetto Int32.

Explicit(XElement to Nullable<Int64>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Int64.

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

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di Int64.

Restituisce

Oggetto Nullable<T> di Int64 che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore Int64 valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto long integer. Recupera quindi il valore eseguendo il cast a Nullable<T> di Int64.

XElement root = new XElement("Root",
    new XElement("Value", 9223372036854775807)
);
ulong? value = (ulong?)root.Element("Value");
Console.WriteLine("Nullable ulong: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
        <Root>
            <Value>9223372036854775807</Value>
        </Root>
Dim value As Nullable(Of ULong) = CType(root.Element("Value"), Nullable(Of ULong))
Console.WriteLine("Nullable ulong: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

Nullable ulong: value=9223372036854775807

Vedi anche

Si applica a

Explicit(XElement to Nullable<Single>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Single.

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

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di Single.

Restituisce

Oggetto Nullable<T> di Single che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore Single valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto a virgola mobile e precisione singola. Recupera quindi il valore eseguendo il cast a Nullable<T> di Single.

XElement root = new XElement("Root",
    new XElement("Value", 3.402823e38)
);
float? value = (float?)root.Element("Value");
Console.WriteLine("Nullable Single: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
        <Root>
            <Value>3.402823e38</Value>
        </Root>
Dim value As Nullable(Of Single) = CType(root.Element("Value"), Nullable(Of Single))
Console.WriteLine("Nullable Single: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

Nullable Single: value=3.402823E+38

Vedi anche

Si applica a

Explicit(XElement to Nullable<TimeSpan>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di TimeSpan.

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

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di TimeSpan.

Restituisce

Oggetto Nullable<T> di TimeSpan che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore TimeSpan valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto dell'intervallo di tempo. Recupera quindi il valore eseguendo il cast a Nullable<T> di TimeSpan.

XElement root = new XElement("Root",
    new XElement("Value", new TimeSpan(1, 5, 30))
);
TimeSpan? value = (TimeSpan?)root.Element("Value");
Console.WriteLine("Nullable TimeSpan: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
    <Root>
        <Value><%= New TimeSpan(1, 5, 30) %></Value>
    </Root>
Dim value As Nullable(Of TimeSpan) = CType(root.Element("Value"), Nullable(Of TimeSpan))
Console.WriteLine("Nullable TimeSpan: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

Nullable TimeSpan: value=01:05:30

Commenti

Lo spazio dei valori di un attributo o di un elemento che contiene il contenuto dell'intervallo di tempo è strettamente correlato al contenuto della durata, come descritto in ISO 8601. Quando si crea un attributo o un elemento che contiene contenuto dell'intervallo di tempo, i valori dell'attributo o dell'elemento vengono formattati in base alla specifica W3C. Per altri dettagli, vedere la specifica W3C.

Il comportamento è lax durante il cast a da Nullable<T>TimeSpan un attributo o un elemento. Anche se il valore dell'attributo o dell'elemento non è formattato esattamente in base alla specifica W3C, il valore viene convertito in modo appropriato in un Nullable<T> di TimeSpan.

Vedi anche

Si applica a

Explicit(XElement to Nullable<UInt32>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di UInt32.

public:
 static explicit operator Nullable<System::UInt32>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator uint? (System.Xml.Linq.XElement element);
[System.CLSCompliant(false)]
public static explicit operator uint? (System.Xml.Linq.XElement? element);
[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<uint32>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of UInteger)

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di UInt32.

Restituisce

Oggetto Nullable<T> di UInt32 che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore UInt32 valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto intero senza segno. Recupera quindi il valore eseguendo il cast a Nullable<T> di UInt32.

XElement root = new XElement("Root",
    new XElement("Value", 4294967295)
);
uint? value = (uint?)root.Element("Value");
Console.WriteLine("Nullable uint: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
        <Root>
            <Value>4294967295</Value>
        </Root>
Dim value As Nullable(Of UInteger) = CType(root.Element("Value"), Nullable(Of UInteger))
Console.WriteLine("Nullable uint: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

Nullable uint: value=4294967295

Vedi anche

Si applica a

Explicit(XElement to Nullable<UInt64>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di UInt64.

public:
 static explicit operator Nullable<System::UInt64>(System::Xml::Linq::XElement ^ element);
[System.CLSCompliant(false)]
public static explicit operator ulong? (System.Xml.Linq.XElement element);
[System.CLSCompliant(false)]
public static explicit operator ulong? (System.Xml.Linq.XElement? element);
[<System.CLSCompliant(false)>]
static member op_Explicit : System.Xml.Linq.XElement -> Nullable<uint64>
Public Shared Narrowing Operator CType (element As XElement) As Nullable(Of ULong)

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di UInt64.

Restituisce

Oggetto Nullable<T> di UInt64 che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore UInt64 valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto long integer senza segno. Recupera quindi il valore eseguendo il cast a Nullable<T> di UInt64.

XElement root = new XElement("Root",
    new XElement("Value", 9223372036854775807)
);
ulong? value = (ulong?)root.Element("Value");
Console.WriteLine("Nullable ulong: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
        <Root>
            <Value>9223372036854775807</Value>
        </Root>

Dim value As Nullable(Of ULong) = CType(root.Element("Value"), Nullable(Of ULong))
Console.WriteLine("Nullable ulong: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

Nullable ulong: value=9223372036854775807

Vedi anche

Si applica a

Explicit(XElement to UInt32)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto UInt32.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto UInt32.

Restituisce

Oggetto UInt32 che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore UInt32 valido.

Il valore del parametro element è null.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto intero senza segno. Recupera quindi il valore eseguendo il cast in UInt32.

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

Nell'esempio viene prodotto l'output seguente:

value=4294967295

Vedi anche

Si applica a

Explicit(XElement to String)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto String.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto String.

Restituisce

Oggetto String che include il contenuto di XElement.

Attributi

Esempio

Nell'esempio seguente viene creato un elemento con contenuto stringa. Recupera quindi il valore eseguendo il cast in String.

XElement root = XElement.Parse("<Root>abc <b>def </b>ghi</Root>");
Console.WriteLine("(string)root={0}", (string)root);
Dim root As XElement = <Root>abc <b>def </b>ghi</Root>
Console.WriteLine("(string)root={0}", root.Value)

Nell'esempio viene prodotto l'output seguente:

(string)root=abc def ghi

Commenti

Se ha XElement elementi figlio, viene restituito il valore stringa concatenato di tutto il testo dell'elemento e il testo discendente.

Vedi anche

Si applica a

Explicit(XElement to TimeSpan)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto TimeSpan.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto TimeSpan.

Restituisce

Oggetto TimeSpan che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore TimeSpan valido.

Il valore del parametro element è null.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto di intervallo di tempo. Recupera quindi il valore eseguendo il cast in TimeSpan.

XElement root = new XElement("Root", new TimeSpan(1, 5, 30));
TimeSpan value = (TimeSpan)root;
Console.WriteLine("value={0}", value);
Dim root As XElement = <Root><%= New TimeSpan(1, 5, 30) %></Root>
Dim value As TimeSpan = CType(root, TimeSpan)
Console.WriteLine("value={0}", value)

Nell'esempio viene prodotto l'output seguente:

value=01:05:30

Commenti

Lo spazio dei valori di un attributo o di un elemento che contiene contenuto di intervallo di tempo è strettamente correlato al contenuto di durata, come descritto in ISO 8601. Quando si crea un attributo o un elemento contenente contenuto intervallo di tempo, i valori dell'attributo o dell'elemento vengono formattati per la specifica W3C. Per altre informazioni, vedere la specifica W3C.

Il comportamento è lax quando si esegue il cast a un oggetto da un attributo o un TimeSpan elemento. Anche se il valore dell'attributo o dell'elemento non è formattato esattamente per la specifica W3C, il valore viene convertito in modo appropriato in un TimeSpanoggetto .

Vedi anche

Si applica a

Explicit(XElement to UInt64)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto UInt64.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto UInt64.

Restituisce

Oggetto UInt64 che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore UInt64 valido.

Il valore del parametro element è null.

element è null.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto intero lungo senza segno. Recupera quindi il valore eseguendo il cast in UInt64.

XElement root = new XElement("Root", 18446744073709551615);
ulong value = (ulong)root;
Console.WriteLine("value={0}", value);
Dim root As XElement = <Root>18446744073709551615</Root>
Dim value As ULong = CULng(root)
Console.WriteLine("value={0}", value)

Nell'esempio viene prodotto l'output seguente:

value=18446744073709551615

Vedi anche

Si applica a

Explicit(XElement to Nullable<Int32>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Int32.

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

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di Int32.

Restituisce

Oggetto Nullable<T> di Int32 che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore Int32 valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto intero senza segno. Recupera quindi il valore eseguendo il cast a Nullable<T> di Int32.

XElement root = new XElement("Root",
    new XElement("Value", 2147483647)
);
int? value = (int?)root.Element("Value");
Console.WriteLine("Nullable integer: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
        <Root>
            <Value>2147483647</Value>
        </Root>
Dim value As Nullable(Of Integer) = CType(root.Element("Value"), Nullable(Of Integer))
Console.WriteLine("Nullable integer: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

Nullable integer: value=2147483647

Vedi anche

Si applica a

Explicit(XElement to Single)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Single.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto Single.

Restituisce

Oggetto Single che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore Single valido.

Il valore del parametro element è null.

element è null.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto a virgola mobile a precisione singola. Recupera quindi il valore eseguendo il cast in Single.

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

Nell'esempio viene prodotto l'output seguente:

value=3.402823E+38

Vedi anche

Si applica a

Explicit(XElement to Nullable<Guid>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Guid.

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

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di Guid.

Restituisce

Oggetto Nullable<T> di Guid che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore Guid valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto guid. Recupera quindi il valore eseguendo il cast a Nullable<T> di Guid.

XElement root = new XElement("Root",
    new XElement("Value", new Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730"))
);
Guid? value = (Guid?)root.Element("Value");
Console.WriteLine("Nullable Guid: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
    <Root>
        <Value><%= New Guid("3c1cc55b-baff-4b7a-9d17-077af3aa5730") %></Value>
    </Root>
Dim value As Nullable(Of Guid) = CType(root.Element("Value"), Nullable(Of Guid))
Console.WriteLine("Nullable Guid: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

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

Vedi anche

Si applica a

Explicit(XElement to Nullable<Boolean>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Boolean.

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

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di Boolean.

Restituisce

Oggetto Nullable<T> di Boolean che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore Boolean valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto booleano. Recupera quindi il valore eseguendo il cast a Nullable<T> di Boolean.

XElement root = new XElement("Root",
    new XElement("BoolValue1", true),
    new XElement("BoolValue2", false));
bool? bool1 = (bool?)root.Element("BoolValue1");
bool? bool2 = (bool?)root.Element("BoolValue2");
Console.WriteLine("Nullable Boolean: value1={0}", bool1);
Console.WriteLine("Nullable Boolean: value2={0}", bool2);
Dim root As XElement = _
        <Root>
            <BoolValue1>true</BoolValue1>
            <BoolValue2>false</BoolValue2>
        </Root>

Dim value1 As Nullable(Of Boolean) = CType(root.Element("BoolValue1"), Nullable(Of Boolean))
Dim value2 As Nullable(Of Boolean) = CType(root.Element("BoolValue2"), Nullable(Of Boolean))
Console.WriteLine("Nullable Boolean: value1={0}", IIf(value1.HasValue, value1.ToString(), "null"))
Console.WriteLine("Nullable Boolean: value2={0}", IIf(value2.HasValue, value2.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Quando si converte in da Nullable<T>Boolean un attributo o un elemento, i valori consentiti sono "0", "1" e qualsiasi stringa che produce "true" o "false" dopo l'eliminazione e la conversione in minuscolo.

Vedi anche

Si applica a

Explicit(XElement to Nullable<Decimal>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Decimal.

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

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di Decimal.

Restituisce

Oggetto Nullable<T> di Decimal che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore Decimal valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto decimale. Recupera quindi il valore eseguendo il cast a Nullable<T> di Decimal.

XElement root = new XElement("Root",
    new XElement("Value", "79228162514264337593543950335")
);
decimal? value = (decimal?)root.Element("Value");
Console.WriteLine("Nullable decimal: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
    <Root>
        <Value>79228162514264337593543950335</Value>
    </Root>
Dim value As Nullable(Of Decimal) = CType(root.Element("Value"), Nullable(Of Decimal))
Console.WriteLine("Nullable decimal: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

Nullable decimal: value=79228162514264337593543950335

Vedi anche

Si applica a

Explicit(XElement to Boolean)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Boolean.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto Boolean.

Restituisce

Oggetto Boolean che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore Boolean valido.

Il valore del parametro element è null.

Esempio

Nell'esempio seguente vengono creati alcuni elementi con valori booleani. Li casta quindi su Boolean.

XElement root = new XElement("Root",
    new XElement("BoolValue1", true),
    new XElement("BoolValue2", false)
);
bool bool1 = (bool)root.Element("BoolValue1");
bool bool2 = (bool)root.Element("BoolValue2");
Console.WriteLine("(bool)BoolValue1={0}", bool1);
Console.WriteLine("(bool)BoolValue2={0}", bool2);
Dim root As XElement = _
        <Root>
            <BoolValue1>true</BoolValue1>
            <BoolValue2>false</BoolValue2>
        </Root>
Dim bool1 As Boolean = CBool(root.Element("BoolValue1"))
Dim bool2 As Boolean = CBool(root.Element("BoolValue2"))
Console.WriteLine("(bool)BoolValue1={0}", bool1)
Console.WriteLine("(bool)BoolValue2={0}", bool2)

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Quando si esegue la conversione da Boolean un attributo o un elemento, i valori consentiti sono "0", "1" e qualsiasi stringa che produce "true" o "false" dopo il taglio e la conversione in minuscolo.

Vedi anche

Si applica a

Explicit(XElement to DateTime)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto DateTime.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto DateTime.

Restituisce

Oggetto DateTime che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore DateTime valido.

Il valore del parametro element è null.

element è null.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto di data e ora. Esegue quindi il cast per DateTime recuperare il valore.

// Behavior is strict when formatting an XML element or attribute from a DateTime,
// but behavior is lax when casting to a DateTime from an element or attribute.
XElement root = new XElement("Root", new DateTime(2006, 10, 6, 12, 30, 0));
Console.WriteLine(root);

// Cast from a strictly formatted XML element.
DateTime dt = (DateTime)root;
Console.WriteLine("dt={0}", dt);
Console.WriteLine("-----");

// If root is formatted in some different way:
XElement dtElement = new XElement("OrderDate", "October 6, 2006");
Console.WriteLine(dtElement);
DateTime orderDate = (DateTime)dtElement;
Console.WriteLine("orderDate={0:d}", orderDate);
' Behavior is strict when formatting an XML element or attribute from a DateTime,
' but behavior is lax when casting to a DateTime from an element or attribute.
Dim root As XElement = <Root><%= New DateTime(2006, 10, 6, 12, 30, 0) %></Root>
Console.WriteLine(root)

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

' If root is formatted in some different way:
Dim dtElement As XElement = <OrderDate>October 6, 2006</OrderDate>
Console.WriteLine(dtElement)
Dim orderDate As DateTime = CType(dtElement, DateTime)
Console.WriteLine("orderDate={0:d}", orderDate)

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Lo spazio valore di un attributo o di un elemento che contiene contenuto di data e ora è strettamente correlato alle date e alle ore descritte in ISO 8601. Quando si crea un attributo o un elemento che contiene contenuto di data e ora, i valori dell'attributo o dell'elemento vengono formattati per la specifica W3C. Per altre informazioni, vedere la specifica W3C.

Il comportamento è lax quando si esegue il cast a un oggetto da un attributo o un DateTime elemento. Anche se il valore dell'attributo o dell'elemento non è formattato esattamente per la specifica W3C, il valore viene convertito in modo appropriato in un DateTimeoggetto .

Questo operatore di conversione usa CultureInfo.InvariantCulture per convertire da un DateTimeoggetto .

Vedi anche

Si applica a

Explicit(XElement to DateTimeOffset)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XAttribute a un oggetto DateTimeOffset.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto DateTimeOffset.

Restituisce

Oggetto DateTimeOffset che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore DateTimeOffset valido.

Il valore del parametro element è null.

element è null.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto di data e ora. Esegue quindi il cast per DateTimeOffset recuperare il valore.

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

DateTimeOffset dt = (DateTimeOffset)root.Element("Child");
Console.WriteLine("dt={0}", dt);
Dim root As XElement = _
    <Root>
        <Child><%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %></Child>
    </Root>
Console.WriteLine(root)

Dim dt As DateTimeOffset = CType(root.<Child>(0), DateTimeOffset)
Console.WriteLine("dt={0}", dt)

Nell'esempio viene prodotto l'output seguente:

<Root>
  <Child>2006-10-06T12:30:00-07:00</Child>
</Root>
dt=10/6/2006 12:30:00 PM -07:00

Commenti

Questo operatore di conversione usa la XmlConvert classe per eseguire la conversione.

Vedi anche

Si applica a

Explicit(XElement to Double)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Double.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto Double.

Restituisce

Oggetto Double che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore Double valido.

Il valore del parametro element è null.

element è null.

Esempio

Nell'esempio seguente viene creato un attributo con double contenuto. Recupera quindi il valore eseguendo il cast in Double.

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

Nell'esempio viene prodotto l'output seguente:

value=1.79769313486231E+308

Vedi anche

Si applica a

Explicit(XElement to Guid)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Guid.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto Guid.

Restituisce

Oggetto Guid che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore Guid valido.

Il valore del parametro element è null.

element è null.

Esempio

Nell'esempio seguente viene creato un elemento con un guid come contenuto. Recupera quindi il valore eseguendo il cast in Guid.

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

Nell'esempio viene prodotto l'output seguente:

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

Vedi anche

Si applica a

Explicit(XElement to Decimal)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Decimal.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto Decimal.

Restituisce

Oggetto Decimal che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore Decimal valido.

Il valore del parametro element è null.

element è null.

Esempio

Nell'esempio seguente viene creato un elemento con un valore decimale. Recupera quindi il valore dell'attributo eseguendo il cast in Decimal.

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

Nell'esempio viene prodotto l'output seguente:

value=79228162514264337593543950335

Vedi anche

Si applica a

Explicit(XElement to Int64)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Int64.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto Int64.

Restituisce

Oggetto Int64 che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore Int64 valido.

Il valore del parametro element è null.

element è null.

Esempio

Nell'esempio seguente viene creato un elemento con un intero lungo come contenuto. Recupera quindi il valore dell'elemento eseguendo il cast in Int64.

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

Nell'esempio viene prodotto l'output seguente:

value=9223372036854775807

Vedi anche

Si applica a

Explicit(XElement to Nullable<Double>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di Double.

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

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di Double.

Restituisce

Oggetto Nullable<T> di Double che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore Double valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto a virgola mobile a precisione doppia. Recupera quindi il valore eseguendo il cast a Nullable<T> di Double.

XElement root = new XElement("Root",
    new XElement("Value", 1.79769313486231e308)
);
double? value = (double?)root.Element("Value");
Console.WriteLine("Nullable double: value={0}", value == null ? "null" : value.ToString());
Dim root As XElement = _
        <Root>
            <Value>1.79769313486231e308</Value>
        </Root>

Dim value As Nullable(Of Double) = CType(root.Element("Value"), Nullable(Of Double))
Console.WriteLine("Nullable double: value={0}", IIf(value.HasValue, value.ToString(), "null"))

Nell'esempio viene prodotto l'output seguente:

Nullable double: value=1.79769313486231E+308

Vedi anche

Si applica a

Explicit(XElement to Nullable<DateTime>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di DateTime.

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

Parametri

element
XElement

Oggetto XElement di cui per eseguire il cast a un oggetto Nullable<T> di DateTime.

Restituisce

Oggetto Nullable<T> di DateTime che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore DateTime valido.

Esempio

Nell'esempio seguente viene creato un elemento con una data e un'ora come contenuto. Recupera quindi il valore eseguendo il cast a Nullable<T> di DateTime.

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

Nell'esempio viene prodotto l'output seguente:

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

Commenti

Lo spazio valore di un attributo o di un elemento che contiene contenuto di data e ora è strettamente correlato alle date e alle ore descritte in ISO 8601. Quando si crea un attributo o un elemento che contiene contenuto di data e ora, i valori dell'attributo o dell'elemento vengono formattati per la specifica W3C. Per altre informazioni, vedere la specifica W3C.

Il comportamento è lax quando si esegue il cast a un oggetto da DateTime un attributo o un Nullable<T> elemento. Anche se il valore dell'attributo o dell'elemento non è formattato esattamente per la specifica W3C, il valore viene convertito in modo appropriato in un Nullable<T> oggetto di DateTime.

Questo operatore di conversione usa CultureInfo.InvariantCulture per convertire da un DateTimeoggetto .

Vedi anche

Si applica a

Explicit(XElement to Nullable<DateTimeOffset>)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Nullable<T> di DateTimeOffset.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto Nullable<T> di DateTimeOffset.

Restituisce

Oggetto Nullable<T> di DateTimeOffset che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non è null e non contiene un valore DateTimeOffset valido.

Esempio

Nell'esempio seguente viene creato un elemento con contenuto di data e ora. Esegue quindi il cast a Nullable<T> di DateTimeOffset per recuperare il valore.

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

DateTimeOffset? dt = (DateTimeOffset?)root.Element("Child");
Console.WriteLine("dt={0}", dt);
Dim root As XElement = _
    <Root>
        <Child><%= New DateTimeOffset(New DateTime(2006, 10, 6, 12, 30, 0)) %></Child>
    </Root>
Console.WriteLine(root)

Dim dt As Nullable(Of DateTimeOffset) = CType(root.<Child>(0), Nullable(Of DateTimeOffset))
Console.WriteLine("dt={0}", dt)

Nell'esempio viene prodotto l'output seguente:

<Root>
  <Child>2006-10-06T12:30:00-07:00</Child>
</Root>
dt=10/6/2006 12:30:00 PM -07:00

Commenti

Questo operatore di conversione usa la XmlConvert classe per eseguire la conversione.

Vedi anche

Si applica a

Explicit(XElement to Int32)

Importante

Questa API non è conforme a CLS.

Esegue il cast del valore dell'oggetto XElement a un oggetto Int32.

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

Parametri

element
XElement

Oggetto XElement di cui eseguire il cast a un oggetto Int32.

Restituisce

Oggetto Int32 che include il contenuto di XElement.

Attributi

Eccezioni

L'elemento non contiene un valore Int32 valido.

Il valore del parametro element è null.

Esempio

Nell'esempio seguente viene creato un elemento con un numero intero come contenuto. Recupera quindi il valore eseguendo il cast in Int32.

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

Nell'esempio viene prodotto l'output seguente:

value=2147483647

Vedi anche

Si applica a