2 // System.IO.DirectoryInfo.cs
5 // Miguel de Icaza, miguel@ximian.com
6 // Jim Richardson, develop@wtfo-guru.com
7 // Dan Lewis, dihlewis@yahoo.co.uk
8 // Sebastien Pouliot <sebastien@ximian.com>
10 // Copyright (C) 2002 Ximian, Inc.
11 // Copyright (C) 2001 Moonlight Enterprises, All Rights Reserved
12 // Copyright (C) 2004-2005 Novell, Inc (http://www.novell.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.
34 using System.Collections;
35 using System.Collections.Generic;
36 using System.Runtime.InteropServices;
37 using System.Runtime.Serialization;
38 using System.Security;
41 using System.Security.AccessControl;
48 public sealed class DirectoryInfo : FileSystemInfo {
50 private string current;
51 private string parent;
54 internal DirectoryInfo ()
58 public DirectoryInfo (string path) : this (path, false)
62 internal DirectoryInfo (string path, bool simpleOriginalPath)
66 SecurityManager.EnsureElevatedPermissions (); // this is a no-op outside moonlight
68 FullPath = Path.GetFullPath (path);
69 if (simpleOriginalPath)
70 OriginalPath = Path.GetFileName (path);
77 private DirectoryInfo (SerializationInfo info, StreamingContext context)
78 : base (info, context)
85 int len = FullPath.Length - 1;
86 if ((len > 1) && (FullPath [len] == Path.DirectorySeparatorChar))
88 int last = FullPath.LastIndexOf (Path.DirectorySeparatorChar, len);
89 if ((last == -1) || ((last == 0) && (len == 0))) {
93 current = FullPath.Substring (last + 1, len - last);
94 if (last == 0 && !Environment.IsRunningOnWindows)
95 parent = Path.DirectorySeparatorStr;
97 parent = FullPath.Substring (0, last);
98 // adjust for drives, i.e. a special case for windows
99 if (Environment.IsRunningOnWindows) {
100 if ((parent.Length == 2) && (parent [1] == ':') && Char.IsLetter (parent [0]))
101 parent += Path.DirectorySeparatorChar;
108 public override bool Exists {
112 if (stat.Attributes == MonoIO.InvalidFileAttributes)
115 if ((stat.Attributes & FileAttributes.Directory) == 0)
122 public override string Name {
123 get { return current; }
126 public DirectoryInfo Parent {
128 if ((parent == null) || (parent.Length == 0))
130 return new DirectoryInfo (parent);
134 public DirectoryInfo Root {
136 string root = Path.GetPathRoot (FullPath);
140 return new DirectoryInfo (root);
144 // creational methods
146 public void Create ()
148 Directory.CreateDirectory (FullPath);
151 public DirectoryInfo CreateSubdirectory (string path)
155 path = Path.Combine (FullPath, path);
156 Directory.CreateDirectory (path);
157 return new DirectoryInfo (path);
160 // directory listing methods
162 public FileInfo [] GetFiles ()
164 return GetFiles ("*");
167 public FileInfo [] GetFiles (string searchPattern)
169 if (searchPattern == null)
170 throw new ArgumentNullException ("searchPattern");
172 string [] names = Directory.GetFiles (FullPath, searchPattern);
174 FileInfo[] infos = new FileInfo [names.Length];
176 foreach (string name in names)
177 infos [i++] = new FileInfo (name);
182 public DirectoryInfo [] GetDirectories ()
184 return GetDirectories ("*");
187 public DirectoryInfo [] GetDirectories (string searchPattern)
189 if (searchPattern == null)
190 throw new ArgumentNullException ("searchPattern");
192 string [] names = Directory.GetDirectories (FullPath, searchPattern);
194 DirectoryInfo[] infos = new DirectoryInfo [names.Length];
196 foreach (string name in names)
197 infos [i++] = new DirectoryInfo (name);
202 public FileSystemInfo [] GetFileSystemInfos ()
204 return GetFileSystemInfos ("*");
207 public FileSystemInfo [] GetFileSystemInfos (string searchPattern)
209 return GetFileSystemInfos (searchPattern, SearchOption.TopDirectoryOnly);
215 FileSystemInfo [] GetFileSystemInfos (string searchPattern, SearchOption searchOption)
217 if (searchPattern == null)
218 throw new ArgumentNullException ("searchPattern");
219 if (searchOption != SearchOption.TopDirectoryOnly && searchOption != SearchOption.AllDirectories)
220 throw new ArgumentOutOfRangeException ("searchOption", "Must be TopDirectoryOnly or AllDirectories");
221 if (!Directory.Exists (FullPath))
222 throw new IOException ("Invalid directory");
224 List<FileSystemInfo> infos = new List<FileSystemInfo> ();
225 InternalGetFileSystemInfos (searchPattern, searchOption, infos);
226 return infos.ToArray ();
229 void InternalGetFileSystemInfos (string searchPattern, SearchOption searchOption, List<FileSystemInfo> infos)
231 // UnauthorizedAccessExceptions might happen here and break everything for SearchOption.AllDirectories
232 string [] dirs = Directory.GetDirectories (FullPath, searchPattern);
233 string [] files = Directory.GetFiles (FullPath, searchPattern);
235 Array.ForEach<string> (dirs, (dir) => { infos.Add (new DirectoryInfo (dir)); });
236 Array.ForEach<string> (files, (file) => { infos.Add (new FileInfo (file)); });
237 if (dirs.Length == 0 || searchOption == SearchOption.TopDirectoryOnly)
240 foreach (string dir in dirs) {
241 DirectoryInfo dinfo = new DirectoryInfo (dir);
242 dinfo.InternalGetFileSystemInfos (searchPattern, searchOption, infos);
246 // directory management methods
248 public override void Delete ()
253 public void Delete (bool recursive)
255 Directory.Delete (FullPath, recursive);
258 public void MoveTo (string destDirName)
260 if (destDirName == null)
261 throw new ArgumentNullException ("destDirName");
262 if (destDirName.Length == 0)
263 throw new ArgumentException ("An empty file name is not valid.", "destDirName");
265 Directory.Move (FullPath, Path.GetFullPath (destDirName));
266 FullPath = OriginalPath = destDirName;
270 public override string ToString ()
276 public DirectoryInfo[] GetDirectories (string searchPattern, SearchOption searchOption)
278 //NULL-check of searchPattern is done in Directory.GetDirectories
279 string [] names = Directory.GetDirectories (FullPath, searchPattern, searchOption);
280 //Convert the names to DirectoryInfo instances
281 DirectoryInfo[] infos = new DirectoryInfo [names.Length];
282 for (int i = 0; i<names.Length; ++i){
283 string name = names[i];
284 infos [i] = new DirectoryInfo (name);
289 internal int GetFilesSubdirs (ArrayList l, string pattern)
292 FileInfo [] thisdir = null;
295 thisdir = GetFiles (pattern);
296 } catch (System.UnauthorizedAccessException){
300 count = thisdir.Length;
303 foreach (DirectoryInfo subdir in GetDirectories ()){
304 count += subdir.GetFilesSubdirs (l, pattern);
309 public FileInfo[] GetFiles (string searchPattern, SearchOption searchOption)
311 switch (searchOption) {
312 case SearchOption.TopDirectoryOnly:
313 return GetFiles (searchPattern);
314 case SearchOption.AllDirectories: {
315 ArrayList groups = new ArrayList ();
316 int count = GetFilesSubdirs (groups, searchPattern);
319 FileInfo [] all = new FileInfo [count];
320 foreach (FileInfo [] p in groups){
321 p.CopyTo (all, current);
327 string msg = Locale.GetText ("Invalid enum value '{0}' for '{1}'.", searchOption, "SearchOption");
328 throw new ArgumentOutOfRangeException ("searchOption", msg);
332 // access control methods
334 [MonoLimitation ("DirectorySecurity isn't implemented")]
335 public void Create (DirectorySecurity directorySecurity)
337 if (directorySecurity != null)
338 throw new UnauthorizedAccessException ();
342 [MonoLimitation ("DirectorySecurity isn't implemented")]
343 public DirectoryInfo CreateSubdirectory (string path, DirectorySecurity directorySecurity)
345 if (directorySecurity != null)
346 throw new UnauthorizedAccessException ();
347 return CreateSubdirectory (path);
350 public DirectorySecurity GetAccessControl ()
352 return Directory.GetAccessControl (FullPath);
355 public DirectorySecurity GetAccessControl (AccessControlSections includeSections)
357 return Directory.GetAccessControl (FullPath, includeSections);
360 public void SetAccessControl (DirectorySecurity directorySecurity)
362 Directory.SetAccessControl (FullPath, directorySecurity);
366 #if NET_4_0 || MOONLIGHT || MOBILE
368 public IEnumerable<DirectoryInfo> EnumerateDirectories ()
370 return EnumerateDirectories ("*", SearchOption.TopDirectoryOnly);
373 public IEnumerable<DirectoryInfo> EnumerateDirectories (string searchPattern)
375 return EnumerateDirectories (searchPattern, SearchOption.TopDirectoryOnly);
378 public IEnumerable<DirectoryInfo> EnumerateDirectories (string searchPattern, SearchOption searchOption)
380 if (searchPattern == null)
381 throw new ArgumentNullException ("searchPattern");
383 return CreateEnumerateDirectoriesIterator (searchPattern, searchOption);
386 IEnumerable<DirectoryInfo> CreateEnumerateDirectoriesIterator (string searchPattern, SearchOption searchOption)
388 foreach (string name in Directory.EnumerateDirectories (FullPath, searchPattern, searchOption))
389 yield return new DirectoryInfo (name);
392 public IEnumerable<FileInfo> EnumerateFiles ()
394 return EnumerateFiles ("*", SearchOption.TopDirectoryOnly);
397 public IEnumerable<FileInfo> EnumerateFiles (string searchPattern)
399 return EnumerateFiles (searchPattern, SearchOption.TopDirectoryOnly);
402 public IEnumerable<FileInfo> EnumerateFiles (string searchPattern, SearchOption searchOption)
404 if (searchPattern == null)
405 throw new ArgumentNullException ("searchPattern");
407 return CreateEnumerateFilesIterator (searchPattern, searchOption);
410 IEnumerable<FileInfo> CreateEnumerateFilesIterator (string searchPattern, SearchOption searchOption)
412 foreach (string name in Directory.EnumerateFiles (FullPath, searchPattern, searchOption))
413 yield return new FileInfo (name);
416 public IEnumerable<FileSystemInfo> EnumerateFileSystemInfos ()
418 return EnumerateFileSystemInfos ("*", SearchOption.TopDirectoryOnly);
421 public IEnumerable<FileSystemInfo> EnumerateFileSystemInfos (string searchPattern)
423 return EnumerateFileSystemInfos (searchPattern, SearchOption.TopDirectoryOnly);
426 public IEnumerable<FileSystemInfo> EnumerateFileSystemInfos (string searchPattern, SearchOption searchOption)
428 if (searchPattern == null)
429 throw new ArgumentNullException ("searchPattern");
430 if (searchOption != SearchOption.TopDirectoryOnly && searchOption != SearchOption.AllDirectories)
431 throw new ArgumentOutOfRangeException ("searchoption");
433 return EnumerateFileSystemInfos (FullPath, searchPattern, searchOption);
436 static internal IEnumerable<FileSystemInfo> EnumerateFileSystemInfos (string full, string searchPattern, SearchOption searchOption)
438 string path_with_pattern = Path.Combine (full, searchPattern);
441 FileAttributes rattr;
442 bool subdirs = searchOption == SearchOption.AllDirectories;
444 Path.Validate (full);
446 string s = MonoIO.FindFirst (full, path_with_pattern, out rattr, out error, out handle);
450 throw MonoIO.GetException (Path.GetDirectoryName (path_with_pattern), (MonoIOError) error);
453 if (((rattr & FileAttributes.ReparsePoint) == 0)){
454 if ((rattr & FileAttributes.Directory) != 0)
455 yield return new DirectoryInfo (s);
457 yield return new FileInfo (s);
460 while ((s = MonoIO.FindNext (handle, out rattr, out error)) != null){
461 if ((rattr & FileAttributes.ReparsePoint) != 0)
463 if ((rattr & FileAttributes.Directory) != 0)
464 yield return new DirectoryInfo (s);
466 yield return new FileInfo (s);
468 if (((rattr & FileAttributes.Directory) != 0) && subdirs)
469 foreach (FileSystemInfo child in EnumerateFileSystemInfos (s, searchPattern, searchOption))
473 MonoIO.FindClose (handle);