2 // System.Xml.XmlConvert
5 // Dwivedi, Ajay kumar (Adwiv@Yahoo.com)
6 // Gonzalo Paniagua Javier (gonzalo@ximian.com)
7 // Alan Tam Siu Lung (Tam@SiuLung.com)
8 // Atsushi Enomoto (ginga@kit.hi-ho.ne.jp)
10 // (C) 2002 Ximian, Inc (http://www.ximian.com)
14 // Permission is hereby granted, free of charge, to any person obtaining
15 // a copy of this software and associated documentation files (the
16 // "Software"), to deal in the Software without restriction, including
17 // without limitation the rights to use, copy, modify, merge, publish,
18 // distribute, sublicense, and/or sell copies of the Software, and to
19 // permit persons to whom the Software is furnished to do so, subject to
20 // the following conditions:
22 // The above copyright notice and this permission notice shall be
23 // included in all copies or substantial portions of the Software.
25 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
26 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
27 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
28 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
29 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
30 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
31 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
36 using System.Globalization;
37 using System.Xml.Schema;
39 namespace System.Xml {
41 public class XmlConvert {
43 const string encodedColon = "_x003A_";
44 const NumberStyles floatStyle = NumberStyles.AllowCurrencySymbol |
45 NumberStyles.AllowExponent |
46 NumberStyles.AllowDecimalPoint |
47 NumberStyles.AllowLeadingSign |
48 NumberStyles.AllowLeadingWhite |
49 NumberStyles.AllowTrailingWhite;
51 const NumberStyles integerStyle = NumberStyles.Integer |
52 NumberStyles.AllowLeadingWhite |
53 NumberStyles.AllowTrailingWhite;
55 static readonly string [] datetimeFormats = {
58 "yyyy-MM-ddTHH:mm:sszzz",
59 "yyyy-MM-ddTHH:mm:ss.FFFFFFFzzz",
60 "yyyy-MM-ddTHH:mm:ssZ",
61 "yyyy-MM-ddTHH:mm:ss.FFFFFFFZ",
62 "yyyy-MM-ddTHH:mm:ss",
63 "yyyy-MM-ddTHH:mm:ss.FFFFFFF",
67 "HH:mm:ss.FFFFFFFzzz",
70 #else // it is not required in trunk but should make it easy to backport...
71 "yyyy-MM-ddTHH:mm:sszzz",
72 "yyyy-MM-ddTHH:mm:ss.fzzz",
73 "yyyy-MM-ddTHH:mm:ss.ffzzz",
74 "yyyy-MM-ddTHH:mm:ss.fffzzz",
75 "yyyy-MM-ddTHH:mm:ss.ffffzzz",
76 "yyyy-MM-ddTHH:mm:ss.fffffzzz",
77 "yyyy-MM-ddTHH:mm:ss.ffffffzzz",
78 "yyyy-MM-ddTHH:mm:ss.fffffffzzz",
79 "yyyy-MM-ddTHH:mm:ssZ",
80 "yyyy-MM-ddTHH:mm:ss.fZ",
81 "yyyy-MM-ddTHH:mm:ss.ffZ",
82 "yyyy-MM-ddTHH:mm:ss.fffZ",
83 "yyyy-MM-ddTHH:mm:ss.ffffZ",
84 "yyyy-MM-ddTHH:mm:ss.fffffZ",
85 "yyyy-MM-ddTHH:mm:ss.ffffffZ",
86 "yyyy-MM-ddTHH:mm:ss.fffffffZ",
87 "yyyy-MM-ddTHH:mm:ss",
88 "yyyy-MM-ddTHH:mm:ss.f",
89 "yyyy-MM-ddTHH:mm:ss.ff",
90 "yyyy-MM-ddTHH:mm:ss.fff",
91 "yyyy-MM-ddTHH:mm:ss.ffff",
92 "yyyy-MM-ddTHH:mm:ss.fffff",
93 "yyyy-MM-ddTHH:mm:ss.ffffff",
94 "yyyy-MM-ddTHH:mm:ss.fffffff",
110 "HH:mm:ss.ffffffzzz",
111 "HH:mm:ss.fffffffzzz",
144 static readonly string [] defaultDateTimeFormats = new string [] {
145 "yyyy-MM-ddTHH:mm:ss", // dateTime(1)
146 "yyyy-MM-ddTHH:mm:ss.FFFFFFF", // dateTime(2)
147 "yyyy-MM-dd", // date
149 "yyyy-MM", // gYearMonth
151 "--MM-dd", // gMonthDay
155 static readonly string [] roundtripDateTimeFormats;
156 static readonly string [] localDateTimeFormats;
157 static readonly string [] utcDateTimeFormats;
158 static readonly string [] unspecifiedDateTimeFormats;
162 int l = defaultDateTimeFormats.Length;
163 roundtripDateTimeFormats = new string [l];
164 localDateTimeFormats = new string [l];
165 utcDateTimeFormats = new string [l * 3];
166 unspecifiedDateTimeFormats = new string [l * 4];
167 for (int i = 0; i < l; i++) {
168 string s = defaultDateTimeFormats [i];
169 localDateTimeFormats [i] = s + "zzz";
170 roundtripDateTimeFormats [i] = s + 'K';
171 utcDateTimeFormats [i * 3] = s;
172 utcDateTimeFormats [i * 3 + 1] = s + 'Z';
173 utcDateTimeFormats [i * 3 + 2] = s + "zzz";
174 unspecifiedDateTimeFormats [i * 4] = s;
175 unspecifiedDateTimeFormats [i * 4 + 1] = localDateTimeFormats [i];
176 unspecifiedDateTimeFormats [i * 4 + 2] = roundtripDateTimeFormats [i];
177 unspecifiedDateTimeFormats [i * 4 + 3] = utcDateTimeFormats [i];
181 static DateTimeStyles _defaultStyle = DateTimeStyles.AllowLeadingWhite | DateTimeStyles.AllowTrailingWhite;
186 private static string TryDecoding (string s)
188 if (s == null || s.Length < 6)
193 c = (char) Int32.Parse (s.Substring (1, 4), NumberStyles.HexNumber, CultureInfo.InvariantCulture);
195 return s [0] + DecodeName (s.Substring (1));
199 return c.ToString ();
200 return c + DecodeName (s.Substring (6));
203 public static string DecodeName (string name)
205 if (name == null || name.Length == 0)
208 int pos = name.IndexOf ('_');
209 if (pos == -1 || pos + 6 >= name.Length)
212 if ((name [pos + 1] != 'X' && name [pos + 1] != 'x') || name [pos + 6] != '_')
213 return name [0] + DecodeName (name.Substring (1));
215 return name.Substring (0, pos) + TryDecoding (name.Substring (pos + 1));
218 public static string EncodeLocalName (string name)
223 string encoded = EncodeName (name);
224 int pos = encoded.IndexOf (':');
227 return encoded.Replace (":", encodedColon);
230 internal static bool IsInvalid (char c, bool firstOnlyLetter)
232 if (c == ':') // Special case. allowed in EncodeName, but encoded in EncodeLocalName
236 return !XmlChar.IsFirstNameChar (c);
238 return !XmlChar.IsNameChar (c);
241 private static string EncodeName (string name, bool nmtoken)
243 if (name == null || name.Length == 0)
246 StringBuilder sb = new StringBuilder ();
247 int length = name.Length;
248 for (int i = 0; i < length; i++) {
250 if (IsInvalid (c, i == 0 && !nmtoken))
251 sb.AppendFormat ("_x{0:X4}_", (int) c);
252 else if (c == '_' && i + 6 < length && name [i+1] == 'x' && name [i + 6] == '_')
253 sb.Append ("_x005F_");
257 return sb.ToString ();
260 public static string EncodeName (string name)
262 return EncodeName (name, false);
265 public static string EncodeNmToken (string name)
267 if (name == String.Empty)
268 throw new XmlException ("Invalid NmToken: ''");
269 return EncodeName (name, true);
272 // {true, false, 1, 0}
273 public static bool ToBoolean(string s)
275 s = s.Trim (XmlChar.WhitespaceChars);
287 throw new FormatException(s + " is not a valid boolean value");
291 // LAMESPEC: It has been documented as public, but is marked as internal.
292 internal static string ToBinHexString (byte [] buffer)
294 StringWriter w = new StringWriter ();
295 WriteBinHex (buffer, 0, buffer.Length, w);
296 return w.ToString ();
299 internal static void WriteBinHex (byte [] buffer, int index, int count, TextWriter w)
302 throw new ArgumentNullException ("buffer");
304 throw new ArgumentOutOfRangeException (
308 "index must be non negative integer.");
311 throw new ArgumentOutOfRangeException (
315 "count must be non negative integer.");
317 if (buffer.Length < index + count)
318 throw new ArgumentOutOfRangeException ("index and count must be smaller than the length of the buffer.");
320 // Copied from XmlTextWriter.WriteBinHex ()
321 int end = index + count;
322 for (int i = index; i < end; i++) {
323 int val = buffer [i];
327 w.Write ((char) (high + 55));
329 w.Write ((char) (high + 0x30));
331 w.Write ((char) (low + 55));
333 w.Write ((char) (low + 0x30));
337 public static byte ToByte(string s)
339 return Byte.Parse(s, NumberStyles.Integer, CultureInfo.InvariantCulture);
342 public static char ToChar(string s)
345 return Char.Parse(s);
348 throw new ArgumentNullException ("s");
351 throw new FormatException ("String contain more than one char");
360 public static DateTime ToDateTime (string s)
362 return ToDateTime (s, datetimeFormats);
366 public static DateTime ToDateTime (string value, XmlDateTimeSerializationMode mode)
370 case XmlDateTimeSerializationMode.Local:
371 dt = ToDateTime (value, localDateTimeFormats);
372 return dt == DateTime.MinValue || dt == DateTime.MaxValue ? dt : dt.ToLocalTime ();
373 case XmlDateTimeSerializationMode.RoundtripKind:
374 return ToDateTime (value, roundtripDateTimeFormats, _defaultStyle | DateTimeStyles.RoundtripKind);
375 case XmlDateTimeSerializationMode.Utc:
376 dt = ToDateTime (value, utcDateTimeFormats);
377 return dt == DateTime.MinValue || dt == DateTime.MaxValue ? dt : dt.ToUniversalTime ();
378 case XmlDateTimeSerializationMode.Unspecified:
379 return ToDateTime (value, unspecifiedDateTimeFormats);
381 return ToDateTime (value, defaultDateTimeFormats);
385 public static DateTime ToDateTime(string s, string format)
387 //DateTimeFormatInfo d = new DateTimeFormatInfo();
388 //d.FullDateTimePattern = format;
389 //return DateTime.Parse(s, d);
390 DateTimeStyles style = DateTimeStyles.AllowLeadingWhite |
391 DateTimeStyles.AllowTrailingWhite;
392 return DateTime.ParseExact (s, format, DateTimeFormatInfo.InvariantInfo, style);
395 public static DateTime ToDateTime(string s, string[] formats)
397 return ToDateTime (s, formats, _defaultStyle);
400 private static DateTime ToDateTime (string s, string [] formats, DateTimeStyles style)
402 return DateTime.ParseExact (s, formats, DateTimeFormatInfo.InvariantInfo, style);
405 public static Decimal ToDecimal(string s)
407 return Decimal.Parse(s, CultureInfo.InvariantCulture);
410 public static double ToDouble(string s)
413 throw new ArgumentNullException();
415 float f = TryParseStringFloatConstants (s);
419 return Double.Parse (s, floatStyle, CultureInfo.InvariantCulture);
422 static float TryParseStringFloatConstants (string s)
425 while (sidx < s.Length && Char.IsWhiteSpace (s [sidx]))
427 if (sidx == s.Length)
428 throw new FormatException ();
429 int sEndPos = s.Length - 1;
430 while (Char.IsWhiteSpace (s [sEndPos]))
433 if (TryParseStringConstant ("NaN", s, sidx, sEndPos))
435 if (TryParseStringConstant ("INF", s, sidx, sEndPos))
436 return Single.PositiveInfinity;
437 if (TryParseStringConstant ("-INF", s, sidx, sEndPos))
438 return Single.NegativeInfinity;
439 // Handle these here because Single.Parse("Infinity") is invalid while XmlConvert.ToSingle("Infinity") is valid.
440 if (TryParseStringConstant ("Infinity", s, sidx, sEndPos))
441 return Single.PositiveInfinity;
442 if (TryParseStringConstant ("-Infinity", s, sidx, sEndPos))
443 return Single.NegativeInfinity;
447 static bool TryParseStringConstant (string format, string s, int start, int end)
449 return end - start + 1 == format.Length && String.CompareOrdinal (format, 0, s, start, format.Length) == 0;
452 public static Guid ToGuid (string s)
456 } catch (FormatException ex) {
457 throw new FormatException (String.Format ("Invalid Guid input '{0}'", ex.InnerException));
461 public static short ToInt16(string s)
463 return Int16.Parse (s, integerStyle, CultureInfo.InvariantCulture);
466 public static int ToInt32(string s)
468 return Int32.Parse (s, integerStyle, CultureInfo.InvariantCulture);
471 public static long ToInt64(string s)
473 return Int64.Parse (s, integerStyle, CultureInfo.InvariantCulture);
476 [CLSCompliant (false)]
477 public static SByte ToSByte(string s)
479 return SByte.Parse(s, integerStyle, CultureInfo.InvariantCulture);
482 public static float ToSingle(string s)
485 throw new ArgumentNullException();
487 float f = TryParseStringFloatConstants (s);
491 return Single.Parse(s, floatStyle, CultureInfo.InvariantCulture);
494 public static string ToString(Guid value)
496 return value.ToString("D", CultureInfo.InvariantCulture);
499 public static string ToString(int value)
501 return value.ToString(CultureInfo.InvariantCulture);
504 public static string ToString(short value)
506 return value.ToString(CultureInfo.InvariantCulture);
509 public static string ToString(byte value)
511 return value.ToString(CultureInfo.InvariantCulture);
514 public static string ToString(long value)
516 return value.ToString(CultureInfo.InvariantCulture);
519 public static string ToString(char value)
521 return value.ToString(CultureInfo.InvariantCulture);
524 public static string ToString(bool value)
526 if (value) return "true";
530 [CLSCompliant (false)]
531 public static string ToString(SByte value)
533 return value.ToString(CultureInfo.InvariantCulture);
536 public static string ToString(Decimal value)
538 return value.ToString (CultureInfo.InvariantCulture);
541 [CLSCompliant (false)]
542 public static string ToString(UInt64 value)
544 return value.ToString(CultureInfo.InvariantCulture);
547 public static string ToString (TimeSpan value)
549 if (value == TimeSpan.Zero)
552 StringBuilder builder = new StringBuilder ();
553 if (value.Ticks < 0) {
554 builder.Append ('-');
555 value = value.Negate ();
557 builder.Append ('P');
559 builder.Append (value.Days).Append ('D');
560 long ticks = value.Ticks % TimeSpan.TicksPerMillisecond;
561 if (value.Days > 0 || value.Hours > 0 || value.Minutes > 0 || value.Seconds > 0 || value.Milliseconds > 0 || ticks > 0) {
564 builder.Append (value.Hours).Append ('H');
565 if (value.Minutes > 0)
566 builder.Append (value.Minutes).Append ('M');
567 if (value.Seconds > 0 || value.Milliseconds > 0 || ticks > 0) {
568 builder.Append (value.Seconds);
569 bool trimZero = true;
571 builder.Append ('.').AppendFormat ("{0:0000000}", value.Ticks % TimeSpan.TicksPerSecond);
572 else if (value.Milliseconds > 0)
573 builder.Append ('.').AppendFormat ("{0:000}", value.Milliseconds);
577 while (builder [builder.Length - 1] == '0')
578 builder.Remove (builder.Length - 1, 1);
580 builder.Append ('S');
583 return builder.ToString ();
586 public static string ToString(double value)
588 if (Double.IsNegativeInfinity(value)) return "-INF";
589 if (Double.IsPositiveInfinity(value)) return "INF";
590 if (Double.IsNaN(value)) return "NaN";
591 return value.ToString("R", CultureInfo.InvariantCulture);
594 public static string ToString(float value)
596 if (Single.IsNegativeInfinity(value)) return "-INF";
597 if (Single.IsPositiveInfinity(value)) return "INF";
598 if (Single.IsNaN(value)) return "NaN";
599 return value.ToString("R", CultureInfo.InvariantCulture);
602 [CLSCompliant (false)]
603 public static string ToString(UInt32 value)
605 return value.ToString(CultureInfo.InvariantCulture);
608 [CLSCompliant (false)]
609 public static string ToString(UInt16 value)
611 return value.ToString(CultureInfo.InvariantCulture);
617 public static string ToString (DateTime value)
619 return value.ToString ("yyyy-MM-ddTHH:mm:ss.fffffffzzz", CultureInfo.InvariantCulture);
623 public static string ToString (DateTime value, XmlDateTimeSerializationMode mode)
625 // Unlike usual DateTime formatting, it preserves
626 // MaxValue/MinValue as is.
628 case XmlDateTimeSerializationMode.Local:
629 return (value == DateTime.MinValue ? DateTime.MinValue : value == DateTime.MaxValue ? value : value.ToLocalTime ()).ToString (
630 "yyyy-MM-ddTHH:mm:ss.FFFFFFFzzz",
631 CultureInfo.InvariantCulture);
632 case XmlDateTimeSerializationMode.RoundtripKind:
633 return value.ToString (
634 "yyyy-MM-ddTHH:mm:ss.FFFFFFFK",
635 CultureInfo.InvariantCulture);
637 return value.ToString (
638 "yyyy-MM-ddTHH:mm:ss.FFFFFFFzzz",
639 CultureInfo.InvariantCulture);
640 case XmlDateTimeSerializationMode.Utc:
641 return (value == DateTime.MinValue ? DateTime.MinValue : value == DateTime.MaxValue ? value : value.ToUniversalTime ()).ToString (
642 "yyyy-MM-ddTHH:mm:ss.FFFFFFFZ",
643 CultureInfo.InvariantCulture);
644 case XmlDateTimeSerializationMode.Unspecified:
645 return value.ToString (
646 "yyyy-MM-ddTHH:mm:ss.FFFFFFF",
647 CultureInfo.InvariantCulture);
652 public static string ToString(DateTime value, string format)
654 return value.ToString(format, CultureInfo.InvariantCulture);
657 public static TimeSpan ToTimeSpan(string s)
659 s = s.Trim (XmlChar.WhitespaceChars);
661 throw new FormatException ("Invalid format string for duration schema datatype.");
666 bool minusValue = (start == 1);
668 if (s [start] != 'P')
669 throw new FormatException ("Invalid format string for duration schema datatype.");
679 int parsedDigits = 0;
684 while (i < s.Length) {
692 for (; i < s.Length; i++)
693 if (s [i] < '0' || '9' < s [i])
696 parsedDigits = i - start;
697 int value = int.Parse (s.Substring (start, i - start), CultureInfo.InvariantCulture);
698 if (parseStep == 7) {
699 // adjust to 7 digits so that it makes sense as millisecond digits
700 for (; parsedDigits > 7; parsedDigits--)
702 for (; parsedDigits < 7; parsedDigits++)
715 days += 365 * (value / 12) + 30 * (value % 12);
717 } else if (isTime && parseStep < 6) {
733 if (!isTime || parseStep > 4)
743 if (!isTime || parseStep > 7)
764 throw new FormatException ("Invalid format string for duration schema datatype.");
765 TimeSpan ts = new TimeSpan (days, hours, minutes, seconds);
767 return TimeSpan.FromTicks (- (ts.Ticks + ticks));
769 return TimeSpan.FromTicks (ts.Ticks + ticks);
772 [CLSCompliant (false)]
773 public static UInt16 ToUInt16(string s)
775 return UInt16.Parse(s, NumberStyles.Integer, CultureInfo.InvariantCulture);
778 [CLSCompliant (false)]
779 public static UInt32 ToUInt32(string s)
781 return UInt32.Parse(s, NumberStyles.Integer, CultureInfo.InvariantCulture);
784 [CLSCompliant (false)]
785 public static UInt64 ToUInt64(string s)
787 return UInt64.Parse(s, NumberStyles.Integer, CultureInfo.InvariantCulture);
790 public static string VerifyName (string name)
792 if (name == null || name.Length == 0)
793 throw new ArgumentNullException("name");
795 if (!XmlChar.IsName (name))
796 throw new XmlException("'" + name + "' is not a valid XML Name");
801 public static string VerifyNCName (string ncname)
803 if (ncname == null || ncname.Length == 0)
804 throw new ArgumentNullException("ncname");
806 if (!XmlChar.IsNCName (ncname))
807 throw new XmlException ("'" + ncname + "' is not a valid XML NCName");
812 public static string VerifyTOKEN (string name)
814 internal static string VerifyTOKEN (string name)
818 throw new ArgumentNullException("name");
820 if (name.Length == 0)
823 if (XmlChar.IsWhitespace (name [0]) ||
824 XmlChar.IsWhitespace (name [name.Length - 1]))
825 throw new XmlException ("Whitespace characters (#xA, #xD, #x9, #x20) are not allowed as leading or trailing whitespaces of xs:token.");
827 for (int i = 0; i < name.Length; i++)
828 if (XmlChar.IsWhitespace (name [i]) && name [i] != ' ')
829 throw new XmlException ("Either #xA, #xD or #x9 are not allowed inside xs:token.");
835 public static string VerifyNMTOKEN (string name)
837 internal static string VerifyNMTOKEN (string name)
841 throw new ArgumentNullException("name");
843 if (!XmlChar.IsNmToken (name))
844 throw new XmlException("'" + name + "' is not a valid XML NMTOKEN");
849 // It is documented as public method, but in fact it is not.
850 internal static byte [] FromBinHexString (string s)
852 char [] chars = s.ToCharArray ();
853 byte [] bytes = new byte [chars.Length / 2 + chars.Length % 2];
854 FromBinHexString (chars, 0, chars.Length, bytes);
858 internal static int FromBinHexString (char [] chars, int offset, int charLength, byte [] buffer)
860 int bufIndex = offset;
861 for (int i = 0; i < charLength - 1; i += 2) {
862 buffer [bufIndex] = (chars [i] > '9' ?
863 (byte) (chars [i] - 'A' + 10) :
864 (byte) (chars [i] - '0'));
865 buffer [bufIndex] <<= 4;
866 buffer [bufIndex] += chars [i + 1] > '9' ?
867 (byte) (chars [i + 1] - 'A' + 10) :
868 (byte) (chars [i + 1] - '0');
871 if (charLength %2 != 0)
872 buffer [bufIndex++] = (byte)
873 ((chars [charLength - 1] > '9' ?
874 (byte) (chars [charLength - 1] - 'A' + 10) :
875 (byte) (chars [charLength - 1] - '0'))
878 return bufIndex - offset;
881 #if NET_2_0 // actually NET_3_5
884 public static DateTimeOffset ToDateTimeOffset (string s)
886 return ToDateTimeOffset (s, datetimeFormats);
889 public static DateTimeOffset ToDateTimeOffset (string s, string format)
891 return DateTimeOffset.ParseExact (s, format, CultureInfo.InvariantCulture, DateTimeStyles.AssumeUniversal);
894 public static DateTimeOffset ToDateTimeOffset (string s, string [] formats)
896 DateTimeStyles style = DateTimeStyles.AllowLeadingWhite |
897 DateTimeStyles.AllowTrailingWhite |
898 DateTimeStyles.AssumeUniversal;
899 return DateTimeOffset.ParseExact (s, formats, CultureInfo.InvariantCulture, style);
902 public static string ToString (DateTimeOffset value)
904 return ToString (value, "yyyy-MM-ddTHH:mm:ss.FFFFFFFzzz");
907 public static string ToString (DateTimeOffset value, string format)
909 return value.ToString (format, CultureInfo.InvariantCulture);
913 // it is used only from 2.1 System.Xml.Serialization.dll from
914 // MS Silverlight SDK. We don't use it so far.
915 internal static Uri ToUri (string s)
917 return new Uri (s, UriKind.RelativeOrAbsolute);