class/corlib/System.IO/File.cs

   1 //
   2 // System.IO.File.cs
   3 //
   4 //
   5 // Authors:
   6 //   Miguel de Icaza (miguel@ximian.com)
   7 //   Jim Richardson  (develop@wtfo-guru.com)
   8 //   Dan Lewis       (dihlewis@yahoo.co.uk)
   9 //   Ville Palo      (vi64pa@kolumbus.fi)
  10 //
  11 // Copyright 2002 Ximian, Inc. http://www.ximian.com
  12 // Copyright (C) 2001 Moonlight Enterprises, All Rights Reserved
  13 // Copyright (C) 2004, 2006 Novell, Inc (http://www.novell.com)
  14 //
  15 // Permission is hereby granted, free of charge, to any person obtaining
  16 // a copy of this software and associated documentation files (the
  17 // "Software"), to deal in the Software without restriction, including
  18 // without limitation the rights to use, copy, modify, merge, publish,
  19 // distribute, sublicense, and/or sell copies of the Software, and to
  20 // permit persons to whom the Software is furnished to do so, subject to
  21 // the following conditions:
  22 //
  23 // The above copyright notice and this permission notice shall be
  24 // included in all copies or substantial portions of the Software.
  25 //
  26 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  27 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  28 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
  29 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
  30 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  31 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  32 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  33 //
  34
  35 using System;
  36 using System.Text;
  37 using System.Collections.Generic;
  38 using System.Runtime.InteropServices;
  39
  40 #if NET_2_1
  41 using System.Security;
  42 #else
  43 using System.Security.AccessControl;
  44 #endif
  45
  46 namespace System.IO
  47 {
  48         [ComVisible (true)]
  49         public static class File
  50         {
  51                 static void ValidatePath (string path)
  52                 {
  53                         if (path == null)
  54                                 throw new ArgumentNullException ("path");
  55                         if (path.Length == 0)
  56                                 throw new ArgumentException ("path");
  57 #if MOONLIGHT && !DEBUG
  58                         // On Moonlight (SL4+) this is possible, with limitations, in "Elevated Trust"
  59                         throw new SecurityException ("we're not ready to enable this SL4 feature yet");
  60 #endif
  61                 }
  62
  63                 public static void AppendAllText (string path, string contents)
  64                 {
  65                         ValidatePath (path);
  66
  67                         using (TextWriter w = new StreamWriter (path, true)) {
  68                                 w.Write (contents);
  69                         }
  70                 }
  71
  72                 public static void AppendAllText (string path, string contents, Encoding encoding)
  73                 {
  74                         ValidatePath (path);
  75
  76                         using (TextWriter w = new StreamWriter (path, true, encoding)) {
  77                                 w.Write (contents);
  78                         }
  79                 }
  80
  81                 public static StreamWriter AppendText (string path)
  82                 {
  83                         return new StreamWriter (path, true);
  84                 }
  85
  86                 public static void Copy (string sourceFileName, string destFileName)
  87                 {
  88                         Copy (sourceFileName, destFileName, false);
  89                 }
  90
  91                 public static void Copy (string sourceFileName, string destFileName, bool overwrite)
  92                 {
  93                         MonoIOError error;
  94
  95                         if (sourceFileName == null)
  96                                 throw new ArgumentNullException ("sourceFileName");
  97                         if (destFileName == null)
  98                                 throw new ArgumentNullException ("destFileName");
  99                         if (sourceFileName.Length == 0)
 100                                 throw new ArgumentException ("An empty file name is not valid.", "sourceFileName");
 101                         if (sourceFileName.Trim ().Length == 0 || sourceFileName.IndexOfAny (Path.InvalidPathChars) != -1)
 102                                 throw new ArgumentException ("The file name is not valid.");
 103                         if (destFileName.Length == 0)
 104                                 throw new ArgumentException ("An empty file name is not valid.", "destFileName");
 105                         if (destFileName.Trim ().Length == 0 || destFileName.IndexOfAny (Path.InvalidPathChars) != -1)
 106                                 throw new ArgumentException ("The file name is not valid.");
 107
 108                         if (!MonoIO.Exists (sourceFileName, out error))
 109                                 throw new FileNotFoundException (Locale.GetText ("{0} does not exist", sourceFileName), sourceFileName);
 110                         if ((GetAttributes (sourceFileName) & FileAttributes.Directory) == FileAttributes.Directory)
 111                                 throw new ArgumentException (Locale.GetText ("{0} is a directory", sourceFileName));
 112
 113                         if (MonoIO.Exists (destFileName, out error)) {
 114                                 if ((GetAttributes (destFileName) & FileAttributes.Directory) == FileAttributes.Directory)
 115                                         throw new ArgumentException (Locale.GetText ("{0} is a directory", destFileName));
 116                                 if (!overwrite)
 117                                         throw new IOException (Locale.GetText ("{0} already exists", destFileName));
 118                         }
 119
 120                         string DirName = Path.GetDirectoryName (destFileName);
 121                         if (DirName != String.Empty && !Directory.Exists (DirName))
 122                                 throw new DirectoryNotFoundException (Locale.GetText ("Destination directory not found: {0}",DirName));
 123
 124                         if (!MonoIO.CopyFile (sourceFileName, destFileName, overwrite, out error)) {
 125                                 string p = Locale.GetText ("{0}\" or \"{1}", sourceFileName, destFileName);
 126                                 throw MonoIO.GetException (p, error);
 127                         }
 128                 }
 129
 130                 public static FileStream Create (string path)
 131                 {
 132                         return Create (path, 8192);
 133                 }
 134
 135                 public static FileStream Create (string path, int bufferSize)
 136                 {
 137                         return new FileStream (path, FileMode.Create, FileAccess.ReadWrite,
 138                                 FileShare.None, bufferSize);
 139                 }
 140
 141 #if !NET_2_1
 142                 [MonoLimitation ("FileOptions are ignored")]
 143                 public static FileStream Create (string path, int bufferSize,
 144                                                  FileOptions options)
 145                 {
 146                         return Create (path, bufferSize, options, null);
 147                 }
 148
 149                 [MonoLimitation ("FileOptions and FileSecurity are ignored")]
 150                 public static FileStream Create (string path, int bufferSize,
 151                                                  FileOptions options,
 152                                                  FileSecurity fileSecurity)
 153                 {
 154                         return new FileStream (path, FileMode.Create, FileAccess.ReadWrite,
 155                                 FileShare.None, bufferSize, options);
 156                 }
 157 #endif
 158
 159                 public static StreamWriter CreateText (string path)
 160                 {
 161                         return new StreamWriter (path, false);
 162                 }
 163
 164                 public static void Delete (string path)
 165                 {
 166                         if (path == null)
 167                                 throw new ArgumentNullException("path");
 168                         if (path.Trim().Length == 0 || path.IndexOfAny(Path.InvalidPathChars) >= 0)
 169                                 throw new ArgumentException("path");
 170                         if (Directory.Exists (path))
 171                                 throw new UnauthorizedAccessException(Locale.GetText ("{0} is a directory", path));
 172
 173                         string DirName = Path.GetDirectoryName(path);
 174                         if (DirName != String.Empty && !Directory.Exists (DirName))
 175                                 throw new DirectoryNotFoundException (Locale.GetText ("Could not find a part of the path \"{0}\".", path));
 176
 177                         MonoIOError error;
 178
 179                         if (!MonoIO.DeleteFile (path, out error)){
 180                                 if (error != MonoIOError.ERROR_FILE_NOT_FOUND)
 181                                         throw MonoIO.GetException (path, error);
 182                         }
 183                 }
 184
 185                 public static bool Exists (string path)
 186                 {
 187                         // For security reasons no exceptions are
 188                         // thrown, only false is returned if there is
 189                         // any problem with the path or permissions.
 190                         // Minimizes what information can be
 191                         // discovered by using this method.
 192                         if (path == null || path.Trim().Length == 0
 193                             || path.IndexOfAny(Path.InvalidPathChars) >= 0) {
 194                                 return false;
 195                         }
 196
 197                         MonoIOError error;
 198                         return MonoIO.ExistsFile (path, out error);
 199                 }
 200
 201 #if !NET_2_1
 202                 public static FileSecurity GetAccessControl (string path)
 203                 {
 204                         throw new NotImplementedException ();
 205                 }
 206
 207                 public static FileSecurity GetAccessControl (string path, AccessControlSections includeSections)
 208                 {
 209                         throw new NotImplementedException ();
 210                 }
 211 #endif
 212
 213                 public static FileAttributes GetAttributes (string path)
 214                 {
 215                         if (path == null)
 216                                 throw new ArgumentNullException("path");
 217                         if (path.Trim ().Length == 0)
 218                                 throw new ArgumentException (Locale.GetText ("Path is empty"));
 219                         if (path.IndexOfAny (Path.InvalidPathChars) >= 0)
 220                                 throw new ArgumentException (Locale.GetText ("Path contains invalid chars"));
 221
 222                         MonoIOError error;
 223                         FileAttributes attrs;
 224
 225                         attrs = MonoIO.GetFileAttributes (path, out error);
 226                         if (error != MonoIOError.ERROR_SUCCESS)
 227                                 throw MonoIO.GetException (path, error);
 228                         return attrs;
 229                 }
 230
 231                 public static DateTime GetCreationTime (string path)
 232                 {
 233                         MonoIOStat stat;
 234                         MonoIOError error;
 235                         CheckPathExceptions (path);
 236
 237                         if (!MonoIO.GetFileStat (path, out stat, out error)) {
 238                                 if (error == MonoIOError.ERROR_PATH_NOT_FOUND || error == MonoIOError.ERROR_FILE_NOT_FOUND)
 239                                         return DefaultLocalFileTime;
 240                                 else
 241                                         throw new IOException (path);
 242                         }
 243                         return DateTime.FromFileTime (stat.CreationTime);
 244                 }
 245
 246                 public static DateTime GetCreationTimeUtc (string path)
 247                 {
 248                         return GetCreationTime (path).ToUniversalTime ();
 249                 }
 250
 251                 public static DateTime GetLastAccessTime (string path)
 252                 {
 253                         MonoIOStat stat;
 254                         MonoIOError error;
 255                         CheckPathExceptions (path);
 256
 257                         if (!MonoIO.GetFileStat (path, out stat, out error)) {
 258                                 if (error == MonoIOError.ERROR_PATH_NOT_FOUND || error == MonoIOError.ERROR_FILE_NOT_FOUND)
 259                                         return DefaultLocalFileTime;
 260                                 else
 261                                         throw new IOException (path);
 262                         }
 263                         return DateTime.FromFileTime (stat.LastAccessTime);
 264                 }
 265
 266                 public static DateTime GetLastAccessTimeUtc (string path)
 267                 {
 268                         return GetLastAccessTime (path).ToUniversalTime ();
 269                 }
 270
 271                 public static DateTime GetLastWriteTime (string path)
 272                 {
 273                         MonoIOStat stat;
 274                         MonoIOError error;
 275                         CheckPathExceptions (path);
 276
 277                         if (!MonoIO.GetFileStat (path, out stat, out error)) {
 278                                 if (error == MonoIOError.ERROR_PATH_NOT_FOUND || error == MonoIOError.ERROR_FILE_NOT_FOUND)
 279                                         return DefaultLocalFileTime;
 280                                 else
 281                                         throw new IOException (path);
 282                         }
 283                         return DateTime.FromFileTime (stat.LastWriteTime);
 284                 }
 285
 286                 public static DateTime GetLastWriteTimeUtc (string path)
 287                 {
 288                         return GetLastWriteTime (path).ToUniversalTime ();
 289                 }
 290
 291                 public static void Move (string sourceFileName, string destFileName)
 292                 {
 293                         MonoIOError error;
 294
 295                         if (sourceFileName == null)
 296                                 throw new ArgumentNullException ("sourceFileName");
 297                         if (destFileName == null)
 298                                 throw new ArgumentNullException ("destFileName");
 299                         if (sourceFileName.Length == 0)
 300                                 throw new ArgumentException ("An empty file name is not valid.", "sourceFileName");
 301                         if (sourceFileName.Trim ().Length == 0 || sourceFileName.IndexOfAny (Path.InvalidPathChars) != -1)
 302                                 throw new ArgumentException ("The file name is not valid.");
 303                         if (destFileName.Length == 0)
 304                                 throw new ArgumentException ("An empty file name is not valid.", "destFileName");
 305                         if (destFileName.Trim ().Length == 0 || destFileName.IndexOfAny (Path.InvalidPathChars) != -1)
 306                                 throw new ArgumentException ("The file name is not valid.");
 307                         if (!MonoIO.Exists (sourceFileName, out error))
 308                                 throw new FileNotFoundException (Locale.GetText ("{0} does not exist", sourceFileName), sourceFileName);
 309
 310                         // Don't check for this error here to allow the runtime
 311                         // to check if sourceFileName and destFileName are equal.
 312                         // Comparing sourceFileName and destFileName is not enough.
 313                         //if (MonoIO.Exists (destFileName, out error))
 314                         //      throw new IOException (Locale.GetText ("{0} already exists", destFileName));
 315
 316                         string DirName;
 317                         DirName = Path.GetDirectoryName (destFileName);
 318                         if (DirName != String.Empty && !Directory.Exists (DirName))
 319                                 throw new DirectoryNotFoundException (Locale.GetText ("Could not find a part of the path."));
 320
 321                         if (!MonoIO.MoveFile (sourceFileName, destFileName, out error)) {
 322                                 if (error == MonoIOError.ERROR_ALREADY_EXISTS)
 323                                         throw MonoIO.GetException (error);
 324                                 else if (error == MonoIOError.ERROR_SHARING_VIOLATION)
 325                                         throw MonoIO.GetException (sourceFileName, error);
 326
 327                                 throw MonoIO.GetException (error);
 328                         }
 329                 }
 330
 331                 public static FileStream Open (string path, FileMode mode)
 332                 {
 333                         return new FileStream (path, mode, mode == FileMode.Append ? FileAccess.Write : FileAccess.ReadWrite, FileShare.None);
 334                 }
 335
 336                 public static FileStream Open (string path, FileMode mode, FileAccess access)
 337                 {
 338                         return new FileStream (path, mode, access, FileShare.None);
 339                 }
 340
 341                 public static FileStream Open (string path, FileMode mode, FileAccess access,
 342                                                FileShare share)
 343                 {
 344                         return new FileStream (path, mode, access, share);
 345                 }
 346
 347                 public static FileStream OpenRead (string path)
 348                 {
 349                         return new FileStream (path, FileMode.Open, FileAccess.Read, FileShare.Read);
 350                 }
 351
 352                 public static StreamReader OpenText (string path)
 353                 {
 354                         return new StreamReader (path);
 355                 }
 356
 357                 public static FileStream OpenWrite (string path)
 358                 {
 359                         return new FileStream(path, FileMode.OpenOrCreate, FileAccess.Write, FileShare.None);
 360                 }
 361
 362                 public static void Replace (string sourceFileName,
 363                                             string destinationFileName,
 364                                             string destinationBackupFileName)
 365                 {
 366                         Replace (sourceFileName, destinationFileName, destinationBackupFileName, false);
 367                 }
 368
 369                 public static void Replace (string sourceFileName,
 370                                             string destinationFileName,
 371                                             string destinationBackupFileName,
 372                                             bool ignoreMetadataErrors)
 373                 {
 374                         MonoIOError error;
 375
 376                         if (sourceFileName == null)
 377                                 throw new ArgumentNullException ("sourceFileName");
 378                         if (destinationFileName == null)
 379                                 throw new ArgumentNullException ("destinationFileName");
 380                         if (sourceFileName.Trim ().Length == 0 || sourceFileName.IndexOfAny (Path.InvalidPathChars) != -1)
 381                                 throw new ArgumentException ("sourceFileName");
 382                         if (destinationFileName.Trim ().Length == 0 || destinationFileName.IndexOfAny (Path.InvalidPathChars) != -1)
 383                                 throw new ArgumentException ("destinationFileName");
 384
 385                         string fullSource = Path.GetFullPath (sourceFileName);
 386                         string fullDest = Path.GetFullPath (destinationFileName);
 387                         if (MonoIO.ExistsDirectory (fullSource, out error))
 388                                 throw new IOException (Locale.GetText ("{0} is a directory", sourceFileName));
 389                         if (MonoIO.ExistsDirectory (fullDest, out error))
 390                                 throw new IOException (Locale.GetText ("{0} is a directory", destinationFileName));
 391
 392                         if (!Exists (fullSource))
 393                                 throw new FileNotFoundException (Locale.GetText ("{0} does not exist", sourceFileName),
 394                                                                  sourceFileName);
 395                         if (!Exists (fullDest))
 396                                 throw new FileNotFoundException (Locale.GetText ("{0} does not exist", destinationFileName),
 397                                                                  destinationFileName);
 398                         if (fullSource == fullDest)
 399                                 throw new IOException (Locale.GetText ("Source and destination arguments are the same file."));
 400
 401                         string fullBackup = null;
 402                         if (destinationBackupFileName != null) {
 403                                 if (destinationBackupFileName.Trim ().Length == 0 ||
 404                                     destinationBackupFileName.IndexOfAny (Path.InvalidPathChars) != -1)
 405                                         throw new ArgumentException ("destinationBackupFileName");
 406
 407                                 fullBackup = Path.GetFullPath (destinationBackupFileName);
 408                                 if (MonoIO.ExistsDirectory (fullBackup, out error))
 409                                         throw new IOException (Locale.GetText ("{0} is a directory", destinationBackupFileName));
 410                                 if (fullSource == fullBackup)
 411                                         throw new IOException (Locale.GetText ("Source and backup arguments are the same file."));
 412                                 if (fullDest == fullBackup)
 413                                         throw new IOException (Locale.GetText (
 414                                                                "Destination and backup arguments are the same file."));
 415                         }
 416
 417                         if (!MonoIO.ReplaceFile (fullSource, fullDest, fullBackup,
 418                                                  ignoreMetadataErrors, out error)) {
 419                                 throw MonoIO.GetException (error);
 420                         }
 421                 }
 422
 423 #if !NET_2_1
 424                 public static void SetAccessControl (string path,
 425                                                      FileSecurity fileSecurity)
 426                 {
 427                         throw new NotImplementedException ();
 428                 }
 429 #endif
 430
 431                 public static void SetAttributes (string path,
 432                                                   FileAttributes fileAttributes)
 433                 {
 434                         MonoIOError error;
 435                         CheckPathExceptions (path);
 436
 437                         if (!MonoIO.SetFileAttributes (path, fileAttributes, out error))
 438                                 throw MonoIO.GetException (path, error);
 439                 }
 440
 441                 public static void SetCreationTime (string path, DateTime creationTime)
 442                 {
 443                         MonoIOError error;
 444                         CheckPathExceptions (path);
 445                         if (!MonoIO.Exists (path, out error))
 446                                 throw MonoIO.GetException (path, error);
 447                         if (!MonoIO.SetCreationTime (path, creationTime, out error))
 448                                 throw MonoIO.GetException (path, error);
 449                 }
 450
 451                 public static void SetCreationTimeUtc (string path, DateTime creationTimeUtc)
 452                 {
 453                         SetCreationTime (path, creationTimeUtc.ToLocalTime ());
 454                 }
 455
 456                 public static void SetLastAccessTime (string path, DateTime lastAccessTime)
 457                 {
 458                         MonoIOError error;
 459                         CheckPathExceptions (path);
 460                         if (!MonoIO.Exists (path, out error))
 461                                 throw MonoIO.GetException (path, error);
 462                         if (!MonoIO.SetLastAccessTime (path, lastAccessTime, out error))
 463                                 throw MonoIO.GetException (path, error);
 464                 }
 465
 466                 public static void SetLastAccessTimeUtc (string path, DateTime lastAccessTimeUtc)
 467                 {
 468                         SetLastAccessTime (path, lastAccessTimeUtc.ToLocalTime ());
 469                 }
 470
 471                 public static void SetLastWriteTime (string path,
 472                                                      DateTime lastWriteTime)
 473                 {
 474                         MonoIOError error;
 475                         CheckPathExceptions (path);
 476                         if (!MonoIO.Exists (path, out error))
 477                                 throw MonoIO.GetException (path, error);
 478                         if (!MonoIO.SetLastWriteTime (path, lastWriteTime, out error))
 479                                 throw MonoIO.GetException (path, error);
 480                 }
 481
 482                 public static void SetLastWriteTimeUtc (string path,
 483                                                      DateTime lastWriteTimeUtc)
 484                 {
 485                         SetLastWriteTime (path, lastWriteTimeUtc.ToLocalTime ());
 486                 }
 487
 488                 #region Private
 489
 490                 private static void CheckPathExceptions (string path)
 491                 {
 492                         if (path == null)
 493                                 throw new System.ArgumentNullException("path");
 494                         if (path.Length == 0)
 495                                 throw new System.ArgumentException(Locale.GetText ("Path is empty"));
 496                         if (path.Trim().Length == 0)
 497                                 throw new ArgumentException (Locale.GetText ("Path is empty"));
 498                         if (path.IndexOfAny (Path.InvalidPathChars) != -1)
 499                                 throw new ArgumentException (Locale.GetText ("Path contains invalid chars"));
 500                 }
 501
 502                 #endregion
 503
 504                 //
 505                 // The documentation for this method is most likely wrong, it
 506                 // talks about doing a "binary read", but the remarks say
 507                 // that this "detects the encoding".
 508                 //
 509                 // This can not detect and do anything useful with the encoding
 510                 // since the result is a byte [] not a char [].
 511                 //
 512                 public static byte [] ReadAllBytes (string path)
 513                 {
 514                         using (FileStream s = OpenRead (path)) {
 515                                 long size = s.Length;
 516                                 // limited to 2GB according to http://msdn.microsoft.com/en-us/library/system.io.file.readallbytes.aspx
 517                                 if (size > Int32.MaxValue)
 518                                         throw new IOException ("Reading more than 2GB with this call is not supported");
 519
 520                                 int pos = 0;
 521                                 int count = (int) size;
 522                                 byte [] result = new byte [size];
 523                                 while (count > 0) {
 524                                         int n = s.Read (result, pos, count);
 525                                         if (n == 0)
 526                                                 throw new IOException ("Unexpected end of stream");
 527                                         pos += n;
 528                                         count -= n;
 529                                 }
 530                                 return result;
 531                         }
 532                 }
 533
 534                 public static string [] ReadAllLines (string path)
 535                 {
 536                         using (StreamReader reader = File.OpenText (path)) {
 537                                 return ReadAllLines (reader);
 538                         }
 539                 }
 540
 541                 public static string [] ReadAllLines (string path, Encoding encoding)
 542                 {
 543                         using (StreamReader reader = new StreamReader (path, encoding)) {
 544                                 return ReadAllLines (reader);
 545                         }
 546                 }
 547
 548                 static string [] ReadAllLines (StreamReader reader)
 549                 {
 550                         List<string> list = new List<string> ();
 551                         while (!reader.EndOfStream)
 552                                 list.Add (reader.ReadLine ());
 553                         return list.ToArray ();
 554                 }
 555
 556                 public static string ReadAllText (string path)
 557                 {
 558                         ValidatePath (path);
 559
 560                         using (StreamReader sr = new StreamReader (path)) {
 561                                 return sr.ReadToEnd ();
 562                         }
 563                 }
 564
 565                 public static string ReadAllText (string path, Encoding encoding)
 566                 {
 567                         ValidatePath (path);
 568
 569                         using (StreamReader sr = new StreamReader (path, encoding)) {
 570                                 return sr.ReadToEnd ();
 571                         }
 572                 }
 573
 574                 public static void WriteAllBytes (string path, byte [] bytes)
 575                 {
 576                         using (Stream stream = File.Create (path)) {
 577                                 stream.Write (bytes, 0, bytes.Length);
 578                         }
 579                 }
 580
 581                 public static void WriteAllLines (string path, string [] contents)
 582                 {
 583                         using (StreamWriter writer = new StreamWriter (path)) {
 584                                 WriteAllLines (writer, contents);
 585                         }
 586                 }
 587
 588                 public static void WriteAllLines (string path, string [] contents, Encoding encoding)
 589                 {
 590                         using (StreamWriter writer = new StreamWriter (path, false, encoding)) {
 591                                 WriteAllLines (writer, contents);
 592                         }
 593                 }
 594
 595                 static void WriteAllLines (StreamWriter writer, string [] contents)
 596                 {
 597                         foreach (string line in contents)
 598                                 writer.WriteLine (line);
 599                 }
 600
 601                 public static void WriteAllText (string path, string contents)
 602                 {
 603                         WriteAllText (path, contents, Encoding.UTF8Unmarked);
 604                 }
 605
 606                 public static void WriteAllText (string path, string contents, Encoding encoding)
 607                 {
 608                         using (StreamWriter sw = new StreamWriter (path, false, encoding)) {
 609                                 sw.Write (contents);
 610                         }
 611                 }
 612
 613                 static DateTime? defaultLocalFileTime;
 614                 static DateTime DefaultLocalFileTime {
 615                         get {
 616                                 if (defaultLocalFileTime == null)
 617                                         defaultLocalFileTime = new DateTime (1601, 1, 1).ToLocalTime ();
 618
 619                                 return defaultLocalFileTime.Value;
 620                         }
 621                 }
 622
 623
 624                 [MonoLimitation ("File encryption isn't supported (even on NTFS).")]
 625                 public static void Encrypt (string path)
 626                 {
 627                         // MS.NET support this only on NTFS file systems, i.e. it's a file-system (not a framework) feature.
 628                         // otherwise it throws a NotSupportedException (or a PlatformNotSupportedException on older OS).
 629                         // we throw the same (instead of a NotImplementedException) because most code should already be
 630                         // handling this exception to work properly.
 631                         throw new NotSupportedException (Locale.GetText ("File encryption isn't supported on any file system."));
 632                 }
 633
 634                 [MonoLimitation ("File encryption isn't supported (even on NTFS).")]
 635                 public static void Decrypt (string path)
 636                 {
 637                         // MS.NET support this only on NTFS file systems, i.e. it's a file-system (not a framework) feature.
 638                         // otherwise it throws a NotSupportedException (or a PlatformNotSupportedException on older OS).
 639                         // we throw the same (instead of a NotImplementedException) because most code should already be
 640                         // handling this exception to work properly.
 641                         throw new NotSupportedException (Locale.GetText ("File encryption isn't supported on any file system."));
 642                 }
 643
 644 #if MOONLIGHT || NET_4_0
 645                 public static IEnumerable<string> ReadLines (string path)
 646                 {
 647                         ValidatePath (path);
 648
 649                         using (StreamReader reader = File.OpenText (path)) {
 650                                 return ReadLines (reader);
 651                         }
 652                 }
 653
 654                 public static IEnumerable<string> ReadLines (string path, Encoding encoding)
 655                 {
 656                         ValidatePath (path);
 657
 658                         using (StreamReader reader = new StreamReader (path, encoding)) {
 659                                 return ReadLines (reader);
 660                         }
 661                 }
 662
 663                 // refactored in order to avoid compiler-generated names for Moonlight tools
 664                 static IEnumerable<string> ReadLines (StreamReader reader)
 665                 {
 666                         string s;
 667                         while ((s = reader.ReadLine ()) != null)
 668                                 yield return s;
 669                 }
 670
 671                 public static void AppendAllLines (string path, IEnumerable<string> contents)
 672                 {
 673                         ValidatePath (path);
 674
 675                         if (contents == null)
 676                                 return;
 677
 678                         using (TextWriter w = new StreamWriter (path, true)) {
 679                                 foreach (var line in contents)
 680                                         w.Write (line);
 681                         }
 682                 }
 683
 684                 public static void AppendAllLines (string path, IEnumerable<string> contents, Encoding encoding)
 685                 {
 686                         ValidatePath (path);
 687
 688                         if (contents == null)
 689                                 return;
 690
 691                         using (TextWriter w = new StreamWriter (path, true, encoding)) {
 692                                 foreach (var line in contents)
 693                                         w.Write (line);
 694                         }
 695                 }
 696
 697                 public static void WriteAllLines (string path, IEnumerable<string> contents)
 698                 {
 699                         ValidatePath (path);
 700
 701                         if (contents == null)
 702                                 return;
 703
 704                         using (TextWriter w = new StreamWriter (path, false)) {
 705                                 foreach (var line in contents)
 706                                         w.Write (line);
 707                         }
 708                 }
 709
 710                 public static void WriteAllLines (string path, IEnumerable<string> contents, Encoding encoding)
 711                 {
 712                         ValidatePath (path);
 713
 714                         if (contents == null)
 715                                 return;
 716
 717                         using (TextWriter w = new StreamWriter (path, false, encoding)) {
 718                                 foreach (var line in contents)
 719                                         w.Write (line);
 720                         }
 721                 }
 722 #endif
 723         }
 724 }