Прочитать на английском

Поделиться через


XElement.Explicit Оператор

Определение

Перегрузки

Explicit(XElement to Nullable<Int64>)

Приведение значения данного элемента XElement к Nullable<T>Int64.

Explicit(XElement to Nullable<Single>)

Приведение значения данного элемента XElement к Nullable<T>Single.

Explicit(XElement to Nullable<TimeSpan>)

Приведение значения данного элемента XElement к Nullable<T>TimeSpan.

Explicit(XElement to Nullable<UInt32>)

Приведение значения данного элемента XElement к Nullable<T>UInt32.

Explicit(XElement to Nullable<UInt64>)

Приведение значения данного элемента XElement к Nullable<T>UInt64.

Explicit(XElement to UInt32)

Приведение значение данного элемента XElement к UInt32.

Explicit(XElement to String)

Приведение значение данного элемента XElement к String.

Explicit(XElement to TimeSpan)

Приведение значение данного элемента XElement к TimeSpan.

Explicit(XElement to UInt64)

Приведение значение данного элемента XElement к UInt64.

Explicit(XElement to Nullable<Int32>)

Приведение значения данного элемента XElement к Nullable<T>Int32.

Explicit(XElement to Single)

Приведение значение данного элемента XElement к Single.

Explicit(XElement to Nullable<Guid>)

Приведение значения данного элемента XElement к Nullable<T>Guid.

Explicit(XElement to Nullable<Boolean>)

Приведение значения данного элемента XElement к Nullable<T>Boolean.

Explicit(XElement to Nullable<Decimal>)

Приведение значения данного элемента XElement к Nullable<T>Decimal.

Explicit(XElement to Boolean)

Приведение значение данного элемента XElement к Boolean.

Explicit(XElement to DateTime)

Приведение значение данного элемента XElement к DateTime.

Explicit(XElement to DateTimeOffset)

Приведение значение данного элемента XAttribute к DateTimeOffset.

Explicit(XElement to Double)

Приведение значение данного элемента XElement к Double.

Explicit(XElement to Guid)

Приведение значение данного элемента XElement к Guid.

Explicit(XElement to Decimal)

Приведение значение данного элемента XElement к Decimal.

Explicit(XElement to Int64)

Приведение значения данного элемента XElement к Int64.

Explicit(XElement to Nullable<Double>)

Приведение значения данного элемента XElement к Nullable<T>Double.

Explicit(XElement to Nullable<DateTime>)

Приведение значения данного элемента XElement к Nullable<T>DateTime.

Explicit(XElement to Nullable<DateTimeOffset>)

Приведение значения данного элемента XElement к Nullable<T>DateTimeOffset.

Explicit(XElement to Int32)

Приведение значения данного элемента XElement к Int32.

Explicit(XElement to Nullable<Int64>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>Int64.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для Int64.

Возвращаемое значение

Nullable<Int64>

Nullable<T> для Int64, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа Int64.

Примеры

В следующем примере создается элемент с длинным целым содержимым. Затем он извлекает значение путем приведения к Nullable<T> Int64.

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

В этом примере выводятся следующие данные:

Nullable ulong: value=9223372036854775807  

См. также раздел

Применяется к

Explicit(XElement to Nullable<Single>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>Single.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для Single.

Возвращаемое значение

Nullable<Single>

Nullable<T> для Single, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа Single.

Примеры

В следующем примере создается элемент с содержимым одиночной точности с плавающей запятой. Затем он извлекает значение путем приведения к Nullable<T> Single.

XElement root = new XElement("Root",   
    new XElement("Value", 3.402823e38)  
);  
float? value = (float?)root.Element("Value");  
Console.WriteLine("Nullable Single: value={0}", value == null ? "null" : value.ToString());  

В этом примере выводятся следующие данные:

Nullable Single: value=3.402823E+38  

См. также раздел

Применяется к

Explicit(XElement to Nullable<TimeSpan>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>TimeSpan.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для TimeSpan.

Возвращаемое значение

Nullable<TimeSpan>

Nullable<T> для TimeSpan, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа TimeSpan.

Примеры

В следующем примере создается элемент с содержимым интервала времени. Затем он извлекает значение путем приведения к Nullable<T> TimeSpan.

XElement root = new XElement("Root",  
    new XElement("Value", new TimeSpan(1, 5, 30))  
);  
TimeSpan? value = (TimeSpan?)root.Element("Value");  
Console.WriteLine("Nullable TimeSpan: value={0}", value == null ? "null" : value.ToString());  

В этом примере выводятся следующие данные:

Nullable TimeSpan: value=01:05:30  

Комментарии

Пространство значений атрибута или элемента, содержащего содержимое интервала времени, тесно связано с содержимым длительности, как описано в iso 8601. При создании атрибута или элемента, содержащего содержимое интервала времени, значения атрибута или элемента форматируются в спецификации W3C. Дополнительные сведения см. в спецификации W3C.

Поведение является слабым при приведении к элементу Nullable<T> из атрибута TimeSpan или элемента. Даже если значение атрибута или элемента не отформатировано точно в соответствии со спецификацией W3C, значение правильно преобразуется в значение Nullable<T> TimeSpan.

См. также раздел

Применяется к

Explicit(XElement to Nullable<UInt32>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>UInt32.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для UInt32.

Возвращаемое значение

Nullable<UInt32>

Nullable<T> для UInt32, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа UInt32.

Примеры

В следующем примере создается элемент с неподписанным целым содержимым. Затем он извлекает значение путем приведения к Nullable<T> UInt32.

XElement root = new XElement("Root",   
    new XElement("Value", 4294967295)  
);  
uint? value = (uint?)root.Element("Value");  
Console.WriteLine("Nullable uint: value={0}", value == null ? "null" : value.ToString());  

В этом примере выводятся следующие данные:

Nullable uint: value=4294967295  

См. также раздел

Применяется к

Explicit(XElement to Nullable<UInt64>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>UInt64.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для UInt64.

Возвращаемое значение

Nullable<UInt64>

Nullable<T> для UInt64, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа UInt64.

Примеры

В следующем примере создается элемент с несписанным длинным целым числом. Затем он извлекает значение путем приведения к Nullable<T> UInt64.

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

В этом примере выводятся следующие данные:

Nullable ulong: value=9223372036854775807  

См. также раздел

Применяется к

Explicit(XElement to UInt32)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к UInt32.

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

Параметры

element
XElement

Элемент XElement для приведения к UInt32.

Возвращаемое значение

UInt32

Объект UInt32 с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа UInt32.

Параметр element имеет значение null.

Примеры

В следующем примере создается элемент с неподписанным целым содержимым. Затем он извлекает значение путем приведения к UInt32.

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

В этом примере выводятся следующие данные:

value=4294967295  

См. также раздел

Применяется к

Explicit(XElement to String)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к String.

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

Параметры

element
XElement

Элемент XElement для приведения к String.

Возвращаемое значение

String

Объект String с содержимым данного элемента XElement.

Атрибуты

Примеры

В следующем примере создается элемент со строковым содержимым. Затем он извлекает значение путем приведения к String.

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

В этом примере выводятся следующие данные:

(string)root=abc def ghi  

Комментарии

Если у него есть дочерние XElement элементы, возвращается сцепленное строковое значение всего текста элемента и текста потомка.

См. также раздел

Применяется к

Explicit(XElement to TimeSpan)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к TimeSpan.

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

Параметры

element
XElement

Элемент XElement для приведения к TimeSpan.

Возвращаемое значение

TimeSpan

Объект TimeSpan с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа TimeSpan.

Параметр element имеет значение null.

Примеры

В следующем примере создается элемент с содержимым интервала времени. Затем он извлекает значение путем приведения к TimeSpan.

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

В этом примере выводятся следующие данные:

value=01:05:30  

Комментарии

Пространство значений атрибута или элемента, содержащего содержимое интервала времени, тесно связано с содержимым длительности, как описано в iso 8601. При создании атрибута или элемента, содержащего содержимое интервала времени, значения атрибута или элемента форматируются в спецификации W3C. Дополнительные сведения см. в спецификации W3C.

Поведение является слабым при приведении к TimeSpan атрибуту или элементу. Даже если значение атрибута или элемента не отформатировано точно в соответствии со спецификацией W3C, значение правильно преобразуется в TimeSpan.

См. также раздел

Применяется к

Explicit(XElement to UInt64)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к UInt64.

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

Параметры

element
XElement

Элемент XElement для приведения к UInt64.

Возвращаемое значение

UInt64

Объект UInt64 с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа UInt64.

Параметр element имеет значение null.

element имеет значение null.

Примеры

В следующем примере создается элемент с несписанным длинным целым числом. Затем он извлекает значение путем приведения к UInt64.

XElement root = new XElement("Root", 18446744073709551615);  
ulong value = (ulong)root;  
Console.WriteLine("value={0}", value);  

В этом примере выводятся следующие данные:

value=18446744073709551615  

См. также раздел

Применяется к

Explicit(XElement to Nullable<Int32>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>Int32.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для Int32.

Возвращаемое значение

Nullable<Int32>

Nullable<T> для Int32, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа Int32.

Примеры

В следующем примере создается элемент с неподписанным целым содержимым. Затем он извлекает значение путем приведения к Nullable<T> Int32.

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

В этом примере выводятся следующие данные:

Nullable integer: value=2147483647  

См. также раздел

Применяется к

Explicit(XElement to Single)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к Single.

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

Параметры

element
XElement

Элемент XElement для приведения к Single.

Возвращаемое значение

Single

Объект Single с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа Single.

Параметр element имеет значение null.

element имеет значение null.

Примеры

В следующем примере создается элемент с содержимым одиночной точности с плавающей запятой. Затем он извлекает значение путем приведения к Single.

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

В этом примере выводятся следующие данные:

value=3.402823E+38  

См. также раздел

Применяется к

Explicit(XElement to Nullable<Guid>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>Guid.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для Guid.

Возвращаемое значение

Nullable<Guid>

Nullable<T> для Guid, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа Guid.

Примеры

В следующем примере создается элемент с содержимым GUID. Затем он извлекает значение путем приведения к Nullable<T> Guid.

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

В этом примере выводятся следующие данные:

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

См. также раздел

Применяется к

Explicit(XElement to Nullable<Boolean>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>Boolean.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для Boolean.

Возвращаемое значение

Nullable<Boolean>

Nullable<T> для Boolean, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа Boolean.

Примеры

В следующем примере создается элемент с логическим содержимым. Затем он получает значение путем приведения к Nullable<T> Boolean.

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

В этом примере выводятся следующие данные:

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

Комментарии

При преобразовании Nullable<T> Boolean из атрибута или элемента допустимые значения: "0", "1" и любая строка, которая создает значение "true" или "false" после усечения и преобразования в нижний регистр.

См. также раздел

Применяется к

Explicit(XElement to Nullable<Decimal>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>Decimal.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для Decimal.

Возвращаемое значение

Nullable<Decimal>

Nullable<T> для Decimal, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа Decimal.

Примеры

В следующем примере создается элемент с десятичным содержимым. Затем он извлекает значение путем приведения к Nullable<T> Decimal.

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

В этом примере выводятся следующие данные:

Nullable decimal: value=79228162514264337593543950335  

См. также раздел

Применяется к

Explicit(XElement to Boolean)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к Boolean.

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

Параметры

element
XElement

Элемент XElement для приведения к Boolean.

Возвращаемое значение

Boolean

Объект Boolean с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа Boolean.

Параметр element имеет значение null.

Примеры

В следующем примере создаются некоторые элементы с логическими значениями. Затем он бросает их в 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);  

В этом примере выводятся следующие данные:

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

Комментарии

При преобразовании Boolean из атрибута или элемента допустимые значения: "0", "1" и любая строка, которая создает значение "true" или "false" после усечения и преобразования в нижний регистр.

См. также раздел

Применяется к

Explicit(XElement to DateTime)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к DateTime.

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

Параметры

element
XElement

Элемент XElement для приведения к DateTime.

Возвращаемое значение

DateTime

Объект DateTime с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа DateTime.

Параметр element имеет значение null.

element имеет значение null.

Примеры

В следующем примере создается элемент с содержимым даты и времени. Затем он приводит его к получению DateTime значения.

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

В этом примере выводятся следующие данные:

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

Комментарии

Пространство значений атрибута или элемента, содержащего содержимое даты и времени, тесно связано с датами и временем, описанными в стандарте ISO 8601. При создании атрибута или элемента, содержащего содержимое даты и времени, значения атрибута или элемента форматируются в спецификации W3C. Дополнительные сведения см. в спецификации W3C.

Поведение является слабым при приведении к DateTime атрибуту или элементу. Даже если значение атрибута или элемента не отформатировано точно в соответствии со спецификацией W3C, значение соответствующим образом преобразуется в .DateTime

Этот оператор преобразования используется CultureInfo.InvariantCulture для преобразования из .DateTime

См. также раздел

Применяется к

Explicit(XElement to DateTimeOffset)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XAttribute к DateTimeOffset.

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

Параметры

element
XElement

Элемент XElement для приведения к DateTimeOffset.

Возвращаемое значение

DateTimeOffset

Объект DateTimeOffset с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа DateTimeOffset.

Параметр element имеет значение null.

element имеет значение null.

Примеры

В следующем примере создается элемент с содержимым даты и времени. Затем он приводит к получению DateTimeOffset значения.

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

В этом примере выводятся следующие данные:

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

Комментарии

Этот оператор преобразования использует XmlConvert класс для преобразования.

См. также раздел

Применяется к

Explicit(XElement to Double)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к Double.

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

Параметры

element
XElement

Элемент XElement для приведения к Double.

Возвращаемое значение

Double

Объект Double с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа Double.

Параметр element имеет значение null.

element имеет значение null.

Примеры

В следующем примере создается атрибут с double содержимым. Затем он извлекает значение путем приведения к Double.

XElement root = new XElement("Root", 1.79769313486231e308);  
double value = (double)root;  
Console.WriteLine("value={0}", value);  

В этом примере выводятся следующие данные:

value=1.79769313486231E+308  

См. также раздел

Применяется к

Explicit(XElement to Guid)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к Guid.

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

Параметры

element
XElement

Элемент XElement для приведения к Guid.

Возвращаемое значение

Guid

Объект Guid с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа Guid.

Параметр element имеет значение null.

element имеет значение null.

Примеры

В следующем примере создается элемент с guid в виде содержимого. Затем он извлекает значение путем приведения к Guid.

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

В этом примере выводятся следующие данные:

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

См. также раздел

Применяется к

Explicit(XElement to Decimal)

Важно!

Этот API несовместим с CLS.

Приведение значение данного элемента XElement к Decimal.

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

Параметры

element
XElement

Элемент XElement для приведения к Decimal.

Возвращаемое значение

Decimal

Объект Decimal с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа Decimal.

Параметр element имеет значение null.

element имеет значение null.

Примеры

В следующем примере создается элемент с десятичным значением. Затем он получает значение атрибута путем приведения к Decimal.

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

В этом примере выводятся следующие данные:

value=79228162514264337593543950335  

См. также раздел

Применяется к

Explicit(XElement to Int64)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Int64.

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

Параметры

element
XElement

Элемент XElement для приведения к Int64.

Возвращаемое значение

Int64

Объект Int64 с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа Int64.

Параметр element имеет значение null.

element имеет значение null.

Примеры

В следующем примере создается элемент с длинным целым числом в виде содержимого. Затем он получает значение элемента путем приведения к Int64.

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

В этом примере выводятся следующие данные:

value=9223372036854775807  

См. также раздел

Применяется к

Explicit(XElement to Nullable<Double>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>Double.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для Double.

Возвращаемое значение

Nullable<Double>

Nullable<T> для Double, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа Double.

Примеры

В следующем примере создается элемент с содержимым двойной точности с плавающей запятой. Затем он извлекает значение путем приведения к Nullable<T> Double.

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

В этом примере выводятся следующие данные:

Nullable double: value=1.79769313486231E+308  

См. также раздел

Применяется к

Explicit(XElement to Nullable<DateTime>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>DateTime.

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

Параметры

element
XElement

Элемент XElement для приведения к Nullable<T> для DateTime.

Возвращаемое значение

Nullable<DateTime>

Nullable<T> для DateTime, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа DateTime.

Примеры

В следующем примере создается элемент с датой и временем в качестве содержимого. Затем он извлекает значение путем приведения к Nullable<T> DateTime.

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

В этом примере выводятся следующие данные:

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

Комментарии

Пространство значений атрибута или элемента, содержащего содержимое даты и времени, тесно связано с датами и временем, описанными в ISO 8601. При создании атрибута или элемента, содержащего содержимое даты и времени, значения атрибута или элемента форматируются в спецификации W3C. Дополнительные сведения см. в спецификации W3C.

Поведение является слабым при приведении к элементу Nullable<T> из атрибута DateTime или элемента. Даже если значение атрибута или элемента не отформатировано точно в соответствии со спецификацией W3C, значение правильно преобразуется в значение Nullable<T> DateTime.

Этот оператор преобразования используется CultureInfo.InvariantCulture для преобразования из DateTime.

См. также раздел

Применяется к

Explicit(XElement to Nullable<DateTimeOffset>)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Nullable<T>DateTimeOffset.

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

Параметры

element
XElement

Элемент XElement для приведения к значению Nullable<T>DateTimeOffset.

Возвращаемое значение

Nullable<DateTimeOffset>

Nullable<T> для DateTimeOffset, содержащий данные этого элемента XElement.

Атрибуты

Исключения

Элемент не равен null и не содержит и допустимое значение типа DateTimeOffset.

Примеры

В следующем примере создается элемент с содержимым даты и времени. Затем он приводит к Nullable<T> получению DateTimeOffset значения.

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

В этом примере выводятся следующие данные:

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

Комментарии

Этот оператор преобразования использует XmlConvert класс для преобразования.

См. также раздел

Применяется к

Explicit(XElement to Int32)

Важно!

Этот API несовместим с CLS.

Приведение значения данного элемента XElement к Int32.

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

Параметры

element
XElement

Элемент XElement для приведения к Int32.

Возвращаемое значение

Int32

Объект Int32 с содержимым данного элемента XElement.

Атрибуты

Исключения

Элемент не содержит допустимое значение типа Int32.

Параметр element имеет значение null.

Примеры

В следующем примере создается элемент с целым числом в виде содержимого. Затем он извлекает значение путем приведения к Int32.

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

В этом примере выводятся следующие данные:

value=2147483647  

См. также раздел

Применяется к