1 files changed, 84 insertions, 0 deletions
diff --git a/src/System.IO.FileSystem/src/System/IO/Enumeration/EnumerationOptions.cs b/src/System.IO.FileSystem/src/System/IO/Enumeration/EnumerationOptions.cs
new file mode 100644
index 0000000000..164cf3ed6e
--- /dev/null
+++ b/src/System.IO.FileSystem/src/System/IO/Enumeration/EnumerationOptions.cs
@@ -0,0 +1,84 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+// See the LICENSE file in the project root for more information.
+
+namespace System.IO.Enumeration
+{
+    public class EnumerationOptions
+    {
+        /// <summary>
+        /// For internal use. These are the options we want to use if calling the existing Directory/File APIs where you don't
+        /// explicitly specify EnumerationOptions.
+        /// </summary>
+        internal static EnumerationOptions Compatible { get; } = new EnumerationOptions { MatchType = MatchType.Dos };
+
+        private static EnumerationOptions CompatibleRecursive { get; } = new EnumerationOptions { RecurseSubdirectories = true, MatchType = MatchType.Dos };
+
+        /// <summary>
+        /// Internal singleton for default options.
+        /// </summary>
+        internal static EnumerationOptions Default { get; } = new EnumerationOptions();
+
+        /// <summary>
+        /// Default constructor. Constructs the options class with recommended default options.
+        /// </summary>
+        public EnumerationOptions()
+        {
+        }
+
+        /// <summary>
+        /// Converts SearchOptions to FindOptions. Throws if undefined SearchOption.
+        /// </summary>
+        internal static EnumerationOptions FromSearchOption(SearchOption searchOption)
+        {
+            if ((searchOption != SearchOption.TopDirectoryOnly) && (searchOption != SearchOption.AllDirectories))
+                throw new ArgumentOutOfRangeException(nameof(searchOption), SR.ArgumentOutOfRange_Enum);
+
+            return searchOption == SearchOption.AllDirectories ? CompatibleRecursive : Compatible;
+        }
+
+        /// <summary>
+        /// Should we recurse into subdirectories while enumerating?
+        /// </summary>
+        public bool RecurseSubdirectories { get; set; }
+
+        /// <summary>
+        /// Skip files/directories when access is denied (e.g. AccessDeniedException/SecurityException)
+        /// </summary>
+        public bool IgnoreInaccessible { get; set; }
+
+        /// <summary>
+        /// Suggested buffer size, in bytes.
+        /// </summary>
+        /// <remarks>
+        /// Not all platforms use user allocated buffers, and some require either fixed buffers or a
+        /// buffer that has enough space to return a full result. One scenario where this option is
+        /// useful is with remote share enumeration on Windows. Having a large buffer may result in
+        /// better performance as more results can be batched over the wire (e.g. over a network
+        /// share). A "large" buffer, for example, would be 16K. Typical is 4K.
+        /// 
+        /// We will not use the suggested buffer size if it has no meaning for the native APIs on the
+        /// current platform or if it would be too small for getting at least a single result.
+        /// </remarks>
+        public int BufferSize { get; set; }
+
+        /// <summary>
+        /// Skip entries with the given attributes.
+        /// </summary>
+        public FileAttributes AttributesToSkip { get; set; }
+
+        /// <summary>
+        /// For APIs that allow specifying a match expression this will allow you to specify how
+        /// to interpret the match expression.
+        /// </summary>
+        /// <remarks>
+        /// The default is simple matching where '*' is always 0 or more characters and '?' is a single character.
+        /// </remarks>
+        public MatchType MatchType { get; set; }
+
+        /// <summary>
+        /// Set to true to return "." and ".." directory entries.
+        /// </summary>
+        public bool ReturnSpecialDirectories { get; set; }
+    }
+}