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;
49 static readonly string [] datetimeFormats = {
51 "yyyy-MM-ddTHH:mm:ss",
52 "yyyy-MM-ddTHH:mm:ss.f",
53 "yyyy-MM-ddTHH:mm:ss.ff",
54 "yyyy-MM-ddTHH:mm:ss.fff",
55 "yyyy-MM-ddTHH:mm:ss.ffff",
56 "yyyy-MM-ddTHH:mm:ss.fffff",
57 "yyyy-MM-ddTHH:mm:ss.ffffff",
58 "yyyy-MM-ddTHH:mm:ss.fffffff",
59 "yyyy-MM-ddTHH:mm:sszzz",
60 "yyyy-MM-ddTHH:mm:ss.fzzz",
61 "yyyy-MM-ddTHH:mm:ss.ffzzz",
62 "yyyy-MM-ddTHH:mm:ss.fffzzz",
63 "yyyy-MM-ddTHH:mm:ss.ffffzzz",
64 "yyyy-MM-ddTHH:mm:ss.fffffzzz",
65 "yyyy-MM-ddTHH:mm:ss.ffffffzzz",
66 "yyyy-MM-ddTHH:mm:ss.fffffffzzz",
67 "yyyy-MM-ddTHH:mm:ssZ",
68 "yyyy-MM-ddTHH:mm:ss.fZ",
69 "yyyy-MM-ddTHH:mm:ss.ffZ",
70 "yyyy-MM-ddTHH:mm:ss.fffZ",
71 "yyyy-MM-ddTHH:mm:ss.ffffZ",
72 "yyyy-MM-ddTHH:mm:ss.fffffZ",
73 "yyyy-MM-ddTHH:mm:ss.ffffffZ",
74 "yyyy-MM-ddTHH:mm:ss.fffffffZ",
91 "HH:mm:ss.fffffffzzz",
125 private static string TryDecoding (string s)
127 if (s == null || s.Length < 6)
132 c = (char) Int32.Parse (s.Substring (1, 4), NumberStyles.HexNumber, CultureInfo.InvariantCulture);
134 return s [0] + DecodeName (s.Substring (1));
138 return c.ToString ();
139 return c + DecodeName (s.Substring (6));
142 public static string DecodeName (string name)
144 if (name == null || name.Length == 0)
147 int pos = name.IndexOf ('_');
148 if (pos == -1 || pos + 6 >= name.Length)
151 if ((name [pos + 1] != 'X' && name [pos + 1] != 'x') || name [pos + 6] != '_')
152 return name [0] + DecodeName (name.Substring (1));
154 return name.Substring (0, pos) + TryDecoding (name.Substring (pos + 1));
157 public static string EncodeLocalName (string name)
162 string encoded = EncodeName (name);
163 int pos = encoded.IndexOf (':');
166 return encoded.Replace (":", encodedColon);
169 internal static bool IsInvalid (char c, bool firstOnlyLetter)
171 if (c == ':') // Special case. allowed in EncodeName, but encoded in EncodeLocalName
175 return !XmlChar.IsFirstNameChar (c);
177 return !XmlChar.IsNameChar (c);
180 private static string EncodeName (string name, bool nmtoken)
182 if (name == null || name.Length == 0)
185 StringBuilder sb = new StringBuilder ();
186 int length = name.Length;
187 for (int i = 0; i < length; i++) {
189 if (IsInvalid (c, i == 0 && !nmtoken))
190 sb.AppendFormat ("_x{0:X4}_", (int) c);
191 else if (c == '_' && i + 6 < length && name [i+1] == 'x' && name [i + 6] == '_')
192 sb.Append ("_x005F_");
196 return sb.ToString ();
199 public static string EncodeName (string name)
201 return EncodeName (name, false);
204 public static string EncodeNmToken (string name)
206 if (name == String.Empty)
207 throw new XmlException ("Invalid NmToken: ''");
208 return EncodeName (name, true);
211 // {true, false, 1, 0}
212 public static bool ToBoolean(string s)
214 s = s.Trim (XmlChar.WhitespaceChars);
226 throw new FormatException(s + " is not a valid boolean value");
230 // LAMESPEC: It has been documented as public, but is marked as internal.
231 internal static string ToBinHexString (byte [] buffer)
233 StringWriter w = new StringWriter ();
234 WriteBinHex (buffer, 0, buffer.Length, w);
235 return w.ToString ();
238 internal static void WriteBinHex (byte [] buffer, int index, int count, TextWriter w)
241 throw new ArgumentNullException ("buffer");
243 throw new ArgumentOutOfRangeException ("index", index, "index must be non negative integer.");
245 throw new ArgumentOutOfRangeException ("count", count, "count must be non negative integer.");
246 if (buffer.Length < index + count)
247 throw new ArgumentOutOfRangeException ("index and count must be smaller than the length of the buffer.");
249 // Copied from XmlTextWriter.WriteBinHex ()
250 int end = index + count;
251 for (int i = index; i < end; i++) {
252 int val = buffer [i];
256 w.Write ((char) (high + 55));
258 w.Write ((char) (high + 0x30));
260 w.Write ((char) (low + 55));
262 w.Write ((char) (low + 0x30));
266 public static byte ToByte(string s)
268 return Byte.Parse(s, CultureInfo.InvariantCulture);
271 public static char ToChar(string s)
273 return Char.Parse(s);
279 public static DateTime ToDateTime (string s)
281 return ToDateTime (s, datetimeFormats);
285 public static DateTime ToDateTime (string value, XmlDateTimeSerializationMode mode)
287 string modestr = null;
289 case XmlDateTimeSerializationMode.Local:
290 case XmlDateTimeSerializationMode.RoundTripKind:
292 return ToDateTime (value, "yyyy-MM-ddTHH:mm:ss.fffffffzzz");
293 case XmlDateTimeSerializationMode.Utc:
294 return ToDateTime (value, "yyyy-MM-ddTHH:mm:ss.fffffffZ").ToUniversalTime ();
295 case XmlDateTimeSerializationMode.Unspecified:
296 return ToDateTime (value, "yyyy-MM-ddTHH:mm:ss.fffffff");
300 public static DateTime ToDateTime(string s, string format)
302 DateTimeFormatInfo d = new DateTimeFormatInfo();
303 d.FullDateTimePattern = format;
304 return DateTime.Parse(s, d);
307 public static DateTime ToDateTime(string s, string[] formats)
309 DateTimeStyles style = DateTimeStyles.AllowLeadingWhite |
310 DateTimeStyles.AllowTrailingWhite;
311 return DateTime.ParseExact (s, formats, DateTimeFormatInfo.InvariantInfo, style);
314 public static Decimal ToDecimal(string s)
316 return Decimal.Parse(s, CultureInfo.InvariantCulture);
319 public static double ToDouble(string s)
322 throw new ArgumentNullException();
324 return Double.PositiveInfinity;
326 return Double.NegativeInfinity;
329 return Double.Parse (s, floatStyle, CultureInfo.InvariantCulture);
332 public static Guid ToGuid(string s)
337 public static short ToInt16(string s)
339 return Int16.Parse(s, CultureInfo.InvariantCulture);
342 public static int ToInt32(string s)
344 return Int32.Parse(s, CultureInfo.InvariantCulture);
347 public static long ToInt64(string s)
349 return Int64.Parse(s, CultureInfo.InvariantCulture);
352 [CLSCompliant (false)]
353 public static SByte ToSByte(string s)
355 return SByte.Parse(s, CultureInfo.InvariantCulture);
358 public static float ToSingle(string s)
361 throw new ArgumentNullException();
363 return Single.PositiveInfinity;
365 return Single.NegativeInfinity;
368 return Single.Parse(s, floatStyle, CultureInfo.InvariantCulture);
371 public static string ToString(Guid value)
373 return value.ToString("D", CultureInfo.InvariantCulture);
376 public static string ToString(int value)
378 return value.ToString(CultureInfo.InvariantCulture);
381 public static string ToString(short value)
383 return value.ToString(CultureInfo.InvariantCulture);
386 public static string ToString(byte value)
388 return value.ToString(CultureInfo.InvariantCulture);
391 public static string ToString(long value)
393 return value.ToString(CultureInfo.InvariantCulture);
396 public static string ToString(char value)
398 return value.ToString(CultureInfo.InvariantCulture);
401 public static string ToString(bool value)
403 if (value) return "true";
407 [CLSCompliant (false)]
408 public static string ToString(SByte value)
410 return value.ToString(CultureInfo.InvariantCulture);
413 public static string ToString(Decimal value)
415 return value.ToString (CultureInfo.InvariantCulture);
418 [CLSCompliant (false)]
419 public static string ToString(UInt64 value)
421 return value.ToString(CultureInfo.InvariantCulture);
424 public static string ToString (TimeSpan value)
426 StringBuilder builder = new StringBuilder ();
427 if (value.Ticks < 0) {
428 builder.Append ('-');
429 value = value.Negate ();
431 builder.Append ('P');
433 builder.Append (value.Days).Append ('D');
434 if (value.Days > 0 || value.Hours > 0 || value.Minutes > 0 || value.Seconds > 0 || value.Milliseconds > 0) {
437 builder.Append (value.Hours).Append ('H');
438 if (value.Minutes > 0)
439 builder.Append (value.Minutes).Append ('M');
440 if (value.Seconds > 0 || value.Milliseconds > 0) {
441 builder.Append (value.Seconds);
442 if (value.Milliseconds > 0)
443 builder.Append ('.').AppendFormat ("{0:000}", value.Milliseconds);
444 builder.Append ('S');
447 return builder.ToString ();
450 public static string ToString(double value)
452 if (Double.IsNegativeInfinity(value)) return "-INF";
453 if (Double.IsPositiveInfinity(value)) return "INF";
454 if (Double.IsNaN(value)) return "NaN";
456 return value.ToString("R", NumberFormatInfo.InvariantInfo);
458 return value.ToString(CultureInfo.InvariantCulture);
462 public static string ToString(float value)
464 if (Single.IsNegativeInfinity(value)) return "-INF";
465 if (Single.IsPositiveInfinity(value)) return "INF";
466 if (Single.IsNaN(value)) return "NaN";
468 return value.ToString("R", NumberFormatInfo.InvariantInfo);
470 return value.ToString(CultureInfo.InvariantCulture);
474 [CLSCompliant (false)]
475 public static string ToString(UInt32 value)
477 return value.ToString(CultureInfo.InvariantCulture);
480 [CLSCompliant (false)]
481 public static string ToString(UInt16 value)
483 return value.ToString(CultureInfo.InvariantCulture);
489 public static string ToString (DateTime value)
491 return value.ToString ("yyyy-MM-ddTHH:mm:ss.fffffffzzz", CultureInfo.InvariantCulture);
495 public static string ToString (DateTime value, XmlDateTimeSerializationMode mode)
497 string modestr = null;
499 case XmlDateTimeSerializationMode.Local:
500 case XmlDateTimeSerializationMode.RoundTripKind:
502 return value.ToString (
503 "yyyy-MM-ddTHH:mm:ss.fffffffzzz",
504 CultureInfo.InvariantCulture);
506 case XmlDateTimeSerializationMode.Utc:
507 return value.ToUniversalTime ().ToString (
508 "yyyy-MM-ddTHH:mm:ss.fffffffZ",
509 CultureInfo.InvariantCulture);
511 case XmlDateTimeSerializationMode.Unspecified:
512 return value.ToString (
513 "yyyy-MM-ddTHH:mm:ss.fffffff",
514 CultureInfo.InvariantCulture);
520 public static string ToString(DateTime value, string format)
522 return value.ToString(format, CultureInfo.InvariantCulture);
525 public static TimeSpan ToTimeSpan(string s)
528 throw new ArgumentException ("Invalid format string for duration schema datatype.");
533 bool minusValue = (start == 1);
535 if (s [start] != 'P')
536 throw new ArgumentException ("Invalid format string for duration schema datatype.");
549 while (i < s.Length) {
557 for (; i < s.Length; i++) {
558 if (!Char.IsDigit (s [i]))
561 int value = int.Parse (s.Substring (start, i - start), CultureInfo.InvariantCulture);
572 days += 365 * (value / 12) + 30 * (value % 12);
574 } else if (isTime && parseStep < 6) {
590 if (!isTime || parseStep > 4)
597 if (!isTime || parseStep > 6)
612 throw new ArgumentException ("Invalid format string for duration schema datatype.");
613 TimeSpan ts = new TimeSpan (days, hours, minutes, seconds);
614 return minusValue ? -ts : ts;
617 [CLSCompliant (false)]
618 public static UInt16 ToUInt16(string s)
620 return UInt16.Parse(s, CultureInfo.InvariantCulture);
623 [CLSCompliant (false)]
624 public static UInt32 ToUInt32(string s)
626 return UInt32.Parse(s, CultureInfo.InvariantCulture);
629 [CLSCompliant (false)]
630 public static UInt64 ToUInt64(string s)
632 return UInt64.Parse(s, CultureInfo.InvariantCulture);
635 public static string VerifyName (string name)
638 throw new ArgumentNullException("name");
640 if (!XmlChar.IsName (name))
641 throw new XmlException("'" + name + "' is not a valid XML Name");
646 public static string VerifyNCName (string ncname)
649 throw new ArgumentNullException("ncname");
651 if (!XmlChar.IsNCName (ncname))
652 throw new XmlException ("'" + ncname + "' is not a valid XML NCName");
657 public static string VerifyNMTOKEN (string name)
659 internal static string VerifyNMTOKEN (string name)
663 throw new ArgumentNullException("name");
665 if (!XmlChar.IsNmToken (name))
666 throw new XmlException("'" + name + "' is not a valid XML NMTOKEN");
671 // It is documented as public method, but in fact it is not.
672 internal static byte [] FromBinHexString (string s)
674 char [] chars = s.ToCharArray ();
675 byte [] bytes = new byte [chars.Length / 2 + chars.Length % 2];
676 FromBinHexString (chars, 0, chars.Length, bytes);
680 internal static int FromBinHexString (char [] chars, int offset, int charLength, byte [] buffer)
682 int bufIndex = offset;
683 for (int i = 0; i < charLength - 1; i += 2) {
684 buffer [bufIndex] = (chars [i] > '9' ?
685 (byte) (chars [i] - 'A' + 10) :
686 (byte) (chars [i] - '0'));
687 buffer [bufIndex] <<= 4;
688 buffer [bufIndex] += chars [i + 1] > '9' ?
689 (byte) (chars [i + 1] - 'A' + 10) :
690 (byte) (chars [i + 1] - '0');
693 if (charLength %2 != 0)
694 buffer [bufIndex++] = (byte)
695 ((chars [charLength - 1] > '9' ?
696 (byte) (chars [charLength - 1] - 'A' + 10) :
697 (byte) (chars [charLength - 1] - '0'))
700 return bufIndex - offset;