XAttribute Explicit Conversion (XAttribute to DateTime)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Cast the value of this XAttribute to a DateTime.
Assembly: System.Xml.Linq (in System.Xml.Linq.dll)
Parameters
- attribute
- Type: System.Xml.Linq.XAttribute
The XAttribute to cast to DateTime.
| Exception | Condition |
|---|---|
| FormatException | The attribute does not contain a valid DateTime value. |
| ArgumentNullException | The attribute parameter is null. |
The value space of an attribute or element that contains date and time content is closely related to the dates and times described in ISO 8601. When creating an attribute or element that contains date and time content, the attribute or element values are formatted per the W3C specification. See the W3C specification for more details.
Behavior is lax when casting to a DateTime from an attribute or element. Even if the attribute or element value is not formatted exactly per the W3C specification, the value is appropriately converted to a DateTime.
This conversion operator uses CultureInfo.InvariantCulture to convert from a DateTime.
The following example creates an attribute with date and time content. It then casts it to DateTime to retrieve the value.
StringBuilder output = new StringBuilder(); XElement root = new XElement("Root", new XAttribute("Att", new DateTimeOffset(new DateTime(2006, 10, 6, 12, 30, 0))) ); output.Append(root + Environment.NewLine); // casting from a strictly formatted XML attribute DateTimeOffset dt = (DateTimeOffset)root.Attribute("Att"); output.Append("dt=" + dt + Environment.NewLine); OutputTextBlock.Text = output.ToString();