//
-// System.IO.FIle.cs
+// System.IO.File.cs
//
//
// Authors:
//
// Copyright 2002 Ximian, Inc. http://www.ximian.com
// Copyright (C) 2001 Moonlight Enterprises, All Rights Reserved
-//
-
-//
-// Copyright (C) 2004 Novell, Inc (http://www.novell.com)
+// Copyright (C) 2004, 2006 Novell, Inc (http://www.novell.com)
//
// Permission is hereby granted, free of charge, to any person obtaining
// a copy of this software and associated documentation files (the
//
using System;
+using System.Text;
+#if NET_2_0
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using System.Security.AccessControl;
+#endif
namespace System.IO
{
/// <summary>
///
/// </summary>
- public sealed class File
+#if NET_2_0
+ [ComVisible (true)]
+#endif
+ public
+#if NET_2_0
+ static
+#else
+ sealed
+#endif
+ class File
{
- private File () {}
+#if !NET_2_0
+ private File () {}
+#endif
-
+#if NET_2_0
+ public static void AppendAllText (string path, string contents)
+ {
+ using (TextWriter w = new StreamWriter (path, true)) {
+ w.Write (contents);
+ }
+ }
+
+ public static void AppendAllText (string path, string contents, Encoding encoding)
+ {
+ using (TextWriter w = new StreamWriter (path, true, encoding)) {
+ w.Write (contents);
+ }
+ }
+#endif
+
public static StreamWriter AppendText (string path)
{
return new StreamWriter (path, true);
}
- [MonoTODO("Security Permision Checks")]
public static void Copy (string sourceFilename, string destFilename)
{
Copy (sourceFilename, destFilename, false);
if (dest == null)
throw new ArgumentNullException ("dest");
if (src.Trim () == "" || src.IndexOfAny (Path.InvalidPathChars) != -1)
- throw new ArgumentException ("src");
+ throw new ArgumentException (Locale.GetText ("src is null"));
if (dest.Trim () == "" || dest.IndexOfAny (Path.InvalidPathChars) != -1)
- throw new ArgumentException ("dest");
+ throw new ArgumentException (Locale.GetText ("dest is empty or contains invalid characters"));
if (!Exists (src))
- throw new FileNotFoundException (src + " does not exist");
+ throw new FileNotFoundException (Locale.GetText ("{0} does not exist", src), src);
if ((GetAttributes(src) & FileAttributes.Directory) == FileAttributes.Directory){
- throw new ArgumentException(src + " is a directory");
+ throw new ArgumentException(Locale.GetText ("{0} is a directory", src));
}
if (Exists (dest)) {
if ((GetAttributes(dest) & FileAttributes.Directory) == FileAttributes.Directory){
- throw new ArgumentException(dest + " is a directory");
+ throw new ArgumentException (Locale.GetText ("{0} is a directory", dest));
}
if (!overwrite)
- throw new IOException (dest + " already exists");
+ throw new IOException (Locale.GetText ("{0} already exists", dest));
}
string DirName = Path.GetDirectoryName(dest);
if (DirName != String.Empty && !Directory.Exists (DirName))
- throw new DirectoryNotFoundException("Destination directory not found: " + DirName);
+ throw new DirectoryNotFoundException (Locale.GetText ("Destination directory not found: {0}",DirName));
MonoIOError error;
- if (!MonoIO.CopyFile (src, dest, overwrite, out error))
- throw MonoIO.GetException (error);
+ if (!MonoIO.CopyFile (src, dest, overwrite, out error)){
+ string p = Locale.GetText ("{0}\" or \"{1}", src, dest);
+ throw MonoIO.GetException (p, error);
+ }
}
public static FileStream Create (string path)
{
- return Create (path, 8192);
+ return(Create (path, 8192, FileOptions.None, null));
}
public static FileStream Create (string path, int buffersize)
+ {
+ return(Create (path, buffersize, FileOptions.None,
+ null));
+ }
+
+#if NET_2_0
+ [MonoTODO ("options not implemented")]
+ public static FileStream Create (string path, int bufferSize,
+ FileOptions options)
+ {
+ return(Create (path, bufferSize, options, null));
+ }
+
+ [MonoTODO ("options and fileSecurity not implemented")]
+ public static FileStream Create (string path, int bufferSize,
+ FileOptions options,
+ FileSecurity fileSecurity)
+#else
+ private static FileStream Create (string path, int bufferSize,
+ FileOptions options,
+ object fileSecurity)
+#endif
{
if (null == path)
- throw new ArgumentNullException("path");
+ throw new ArgumentNullException ("path");
if (String.Empty == path.Trim() || path.IndexOfAny(Path.InvalidPathChars) >= 0)
- throw new ArgumentException("path");
+ throw new ArgumentException (Locale.GetText ("path is invalid"));
string DirName = Path.GetDirectoryName(path);
if (DirName != String.Empty && !Directory.Exists (DirName))
- throw new DirectoryNotFoundException("Destination directory not found: " + DirName);
+ throw new DirectoryNotFoundException (Locale.GetText ("Destination directory not found: {0}", DirName));
if (Exists(path)){
if ((GetAttributes(path) & FileAttributes.ReadOnly) == FileAttributes.ReadOnly){
- throw new UnauthorizedAccessException(path + " is a read-only");
+ throw new UnauthorizedAccessException (Locale.GetText ("{0} is read-only", path));
}
}
return new FileStream (path, FileMode.Create, FileAccess.ReadWrite,
- FileShare.None, buffersize);
+ FileShare.None, bufferSize);
}
public static StreamWriter CreateText(string path)
if (String.Empty == path.Trim() || path.IndexOfAny(Path.InvalidPathChars) >= 0)
throw new ArgumentException("path");
if (Directory.Exists (path))
- throw new UnauthorizedAccessException("path is a directory");
+ throw new UnauthorizedAccessException(Locale.GetText ("{0} is a directory", path));
string DirName = Path.GetDirectoryName(path);
if (DirName != String.Empty && !Directory.Exists (DirName))
- throw new DirectoryNotFoundException("Destination directory not found: " + DirName);
+ throw new DirectoryNotFoundException (Locale.GetText ("Destination directory not found: {0}", DirName));
MonoIOError error;
if (!MonoIO.DeleteFile (path, out error)){
- Exception e = MonoIO.GetException (path, error);
- if (! (e is FileNotFoundException))
- throw e;
+ if (error != MonoIOError.ERROR_FILE_NOT_FOUND)
+ throw MonoIO.GetException (path, error);
}
}
}
MonoIOError error;
- bool exists;
-
- exists = MonoIO.ExistsFile (path, out error);
- if (error != MonoIOError.ERROR_SUCCESS &&
- error != MonoIOError.ERROR_FILE_NOT_FOUND &&
- error != MonoIOError.ERROR_PATH_NOT_FOUND) {
- throw MonoIO.GetException (path, error);
- }
-
- return(exists);
+ return MonoIO.ExistsFile (path, out error);
+ }
+
+#if NET_2_0
+ public static FileSecurity GetAccessControl (string path)
+ {
+ throw new NotImplementedException ();
+ }
+
+ public static FileSecurity GetAccessControl (string path, AccessControlSections includeSections)
+ {
+ throw new NotImplementedException ();
}
+#endif
public static FileAttributes GetAttributes (string path)
{
}
if (String.Empty == path.Trim()) {
- throw new ArgumentException("Path is empty");
+ throw new ArgumentException (Locale.GetText ("Path is empty"));
}
if (path.IndexOfAny(Path.InvalidPathChars) >= 0) {
- throw new ArgumentException("Path contains invalid chars");
+ throw new ArgumentException(Locale.GetText ("Path contains invalid chars"));
}
MonoIOError error;
MonoIOStat stat;
MonoIOError error;
CheckPathExceptions (path);
-
- if (!MonoIO.GetFileStat (path, out stat, out error))
+
+ if (!MonoIO.GetFileStat (path, out stat, out error)) {
+#if NET_2_0
+ if (error == MonoIOError.ERROR_PATH_NOT_FOUND || error == MonoIOError.ERROR_FILE_NOT_FOUND)
+ return _defaultLocalFileTime;
+ else
+ throw new IOException (path);
+#else
throw new IOException (path);
+#endif
+ }
return DateTime.FromFileTime (stat.CreationTime);
}
MonoIOError error;
CheckPathExceptions (path);
- if (!MonoIO.GetFileStat (path, out stat, out error))
+ if (!MonoIO.GetFileStat (path, out stat, out error)) {
+#if NET_2_0
+ if (error == MonoIOError.ERROR_PATH_NOT_FOUND || error == MonoIOError.ERROR_FILE_NOT_FOUND)
+ return _defaultLocalFileTime;
+ else
+ throw new IOException (path);
+#else
throw new IOException (path);
+#endif
+ }
return DateTime.FromFileTime (stat.LastAccessTime);
}
MonoIOError error;
CheckPathExceptions (path);
- if (!MonoIO.GetFileStat (path, out stat, out error))
+ if (!MonoIO.GetFileStat (path, out stat, out error)) {
+#if NET_2_0
+ if (error == MonoIOError.ERROR_PATH_NOT_FOUND || error == MonoIOError.ERROR_FILE_NOT_FOUND)
+ return _defaultLocalFileTime;
+ else
+ throw new IOException (path);
+#else
throw new IOException (path);
+#endif
+ }
return DateTime.FromFileTime (stat.LastWriteTime);
}
if (dest.Trim () == "" || dest.IndexOfAny (Path.InvalidPathChars) != -1)
throw new ArgumentException ("dest");
if (!MonoIO.Exists (src, out error))
- throw new FileNotFoundException (src + " does not exist");
+ throw new FileNotFoundException (Locale.GetText ("{0} does not exist", src), src);
if (MonoIO.ExistsDirectory (dest, out error))
- throw new IOException (dest + " is a directory");
+ throw new IOException (Locale.GetText ("{0} is a directory", dest));
+
+ // Don't check for this error here to allow the runtime to check if src and dest
+ // are equal. Comparing src and dest is not enough.
+ //if (MonoIO.Exists (dest, out error))
+ // throw new IOException (Locale.GetText ("{0} already exists", dest));
string DirName;
DirName = Path.GetDirectoryName(src);
if (DirName != String.Empty && !Directory.Exists (DirName))
- throw new DirectoryNotFoundException("Source directory not found: " + DirName);
+ throw new DirectoryNotFoundException(Locale.GetText ("Source directory not found: {0}", DirName));
DirName = Path.GetDirectoryName(dest);
if (DirName != String.Empty && !Directory.Exists (DirName))
- throw new DirectoryNotFoundException("Destination directory not found: " + DirName);
+ throw new DirectoryNotFoundException(Locale.GetText ("Destination directory not found: {0}", DirName));
- if (!MonoIO.MoveFile (src, dest, out error))
+ if (!MonoIO.MoveFile (src, dest, out error)) {
+ if (error == MonoIOError.ERROR_ALREADY_EXISTS)
+ throw MonoIO.GetException (dest, error);
throw MonoIO.GetException (error);
+ }
}
public static FileStream Open (string path, FileMode mode)
{
- return new FileStream (path, mode, FileAccess.ReadWrite, FileShare.None);
+ return new FileStream (path, mode, mode == FileMode.Append ? FileAccess.Write : FileAccess.ReadWrite, FileShare.None);
}
public static FileStream Open (string path, FileMode mode, FileAccess access)
return new FileStream(path, FileMode.OpenOrCreate, FileAccess.Write, FileShare.None);
}
+#if NET_2_0
+ public static void Replace (string sourceFileName,
+ string destinationFileName,
+ string destinationBackupFileName)
+ {
+ throw new NotImplementedException ();
+ }
+
+ public static void Replace (string sourceFileName,
+ string destinationFileName,
+ string destinationBackupFileName,
+ bool ignoreMetadataErrors)
+ {
+ throw new NotImplementedException ();
+ }
+
+ public static void SetAccessControl (string path,
+ FileSecurity fileSecurity)
+ {
+ throw new NotImplementedException ();
+ }
+#endif
+
public static void SetAttributes (string path,
FileAttributes attributes)
{
if (!MonoIO.Exists (path, out error))
throw MonoIO.GetException (path, error);
- if (!MonoIO.SetFileTime (path, creation_time.ToFileTime(),
- -1, -1, out error)) {
+ if (!MonoIO.SetCreationTime (path, creation_time, out error)) {
throw MonoIO.GetException (path, error);
}
}
if (!MonoIO.Exists (path, out error))
throw MonoIO.GetException (path, error);
- if (!MonoIO.SetFileTime (path, -1,
- last_access_time.ToFileTime(), -1,
- out error)) {
+ if (!MonoIO.SetLastAccessTime (path, last_access_time, out error)) {
throw MonoIO.GetException (path, error);
}
}
if (!MonoIO.Exists (path, out error))
throw MonoIO.GetException (path, error);
- if (!MonoIO.SetFileTime (path, -1, -1,
- last_write_time.ToFileTime(),
- out error)) {
+ if (!MonoIO.SetLastWriteTime (path, last_write_time, out error)) {
throw MonoIO.GetException (path, error);
}
}
private static void CheckPathExceptions (string path)
{
if (path == null)
- throw new System.ArgumentNullException("Path is Null");
+ throw new System.ArgumentNullException("path");
if (path == "")
- throw new System.ArgumentException("Path is Empty");
+ throw new System.ArgumentException(Locale.GetText ("Path is empty"));
if (path.Trim().Length == 0)
- throw new ArgumentException ("Only blank characters in path");
+ throw new ArgumentException (Locale.GetText ("Path is empty"));
if (path.IndexOfAny (Path.InvalidPathChars) != -1)
- throw new ArgumentException ("Path contains invalid chars");
+ throw new ArgumentException (Locale.GetText ("Path contains invalid chars"));
}
#endregion
+
+#if NET_2_0
+ static File() {
+ _defaultLocalFileTime = new DateTime (1601, 1, 1);
+ _defaultLocalFileTime = _defaultLocalFileTime.ToLocalTime ();
+ }
+
+ //
+ // The documentation for this method is most likely wrong, it
+ // talks about doing a "binary read", but the remarks say
+ // that this "detects the encoding".
+ //
+ // This can not detect and do anything useful with the encoding
+ // since the result is a byte [] not a char [].
+ //
+ public static byte [] ReadAllBytes (string path)
+ {
+ using (FileStream s = Open (path, FileMode.Open, FileAccess.Read, FileShare.Read)){
+ long size = s.Length;
+
+ //
+ // Is this worth supporting?
+ //
+ if (size > Int32.MaxValue)
+ throw new ArgumentException ("Reading more than 4gigs with this call is not supported");
+
+ byte [] result = new byte [s.Length];
+
+ s.Read (result, 0, (int) size);
+
+ return result;
+ }
+ }
+
+ public static string [] ReadAllLines (string path)
+ {
+ using (StreamReader reader = File.OpenText (path)) {
+ return ReadAllLines (reader);
+ }
+ }
+
+ public static string [] ReadAllLines (string path, Encoding encoding)
+ {
+ using (StreamReader reader = new StreamReader (path, encoding)) {
+ return ReadAllLines (reader);
+ }
+ }
+
+ static string [] ReadAllLines (StreamReader reader)
+ {
+ List<string> list = new List<string> ();
+ while (!reader.EndOfStream)
+ list.Add (reader.ReadLine ());
+ return list.ToArray ();
+ }
+
+ public static string ReadAllText (string path)
+ {
+ return ReadAllText (path, Encoding.UTF8Unmarked);
+ }
+
+ public static string ReadAllText (string path, Encoding enc)
+ {
+ using (StreamReader sr = new StreamReader (path, enc)) {
+ return sr.ReadToEnd ();
+ }
+ }
+
+ public static void WriteAllBytes (string path, byte [] data)
+ {
+ using (Stream stream = File.Create (path)) {
+ stream.Write (data, 0, data.Length);
+ }
+ }
+
+ public static void WriteAllLines (string path, string [] lines)
+ {
+ using (StreamWriter writer = new StreamWriter (path)) {
+ WriteAllLines (writer, lines);
+ }
+ }
+
+ public static void WriteAllLines (string path, string [] lines, Encoding encoding)
+ {
+ using (StreamWriter writer = new StreamWriter (path, false, encoding)) {
+ WriteAllLines (writer, lines);
+ }
+ }
+
+ static void WriteAllLines (StreamWriter writer, string [] lines)
+ {
+ foreach (string line in lines)
+ writer.WriteLine (line);
+ }
+
+ public static void WriteAllText (string path, string contents)
+ {
+ WriteAllText (path, contents, Encoding.UTF8Unmarked);
+ }
+
+ public static void WriteAllText (string path, string contents, Encoding enc)
+ {
+ using (StreamWriter sw = new StreamWriter (path, false, enc)) {
+ sw.Write (contents);
+ }
+ }
+
+ private static readonly DateTime _defaultLocalFileTime;
+
+ [MonoLimitation ("File encryption isn't supported (even on NTFS).")]
+ public static void Encrypt (string path)
+ {
+ // MS.NET support this only on NTFS file systems, i.e. it's a file-system (not a framework) feature.
+ // otherwise it throws a NotSupportedException (or a PlatformNotSupportedException on older OS).
+ // we throw the same (instead of a NotImplementedException) because most code should already be
+ // handling this exception to work properly.
+ throw new NotSupportedException (Locale.GetText ("File encryption isn't supported on any file system."));
+ }
+
+ [MonoLimitation ("File encryption isn't supported (even on NTFS).")]
+ public static void Decrypt (string path)
+ {
+ // MS.NET support this only on NTFS file systems, i.e. it's a file-system (not a framework) feature.
+ // otherwise it throws a NotSupportedException (or a PlatformNotSupportedException on older OS).
+ // we throw the same (instead of a NotImplementedException) because most code should already be
+ // handling this exception to work properly.
+ throw new NotSupportedException (Locale.GetText ("File encryption isn't supported on any file system."));
+ }
+#endif
}
}