MockFile.cs

using System.Collections.Generic;
using System.Globalization;
using System.Linq;
using System.Text;
using Microsoft.Win32.SafeHandles;

namespace System.IO.Abstractions.TestingHelpers;

using XFS = MockUnixSupport;

/// <inheritdoc />
#if FEATURE_SERIALIZABLE
[Serializable]
#endif
public partial class MockFile : FileBase
{
    private readonly IMockFileDataAccessor mockFileDataAccessor;

    /// <inheritdoc />
    public MockFile(IMockFileDataAccessor mockFileDataAccessor) : base(mockFileDataAccessor?.FileSystem)
    {
        this.mockFileDataAccessor = mockFileDataAccessor ?? throw new ArgumentNullException(nameof(mockFileDataAccessor));
    }

#if FEATURE_FILE_SPAN
        /// <inheritdoc cref="IFile.AppendAllBytes(string,byte[])"/>
        public override void AppendAllBytes(string path, byte[] bytes)
        {
            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

            if (!mockFileDataAccessor.FileExists(path))
            {
                VerifyDirectoryExists(path);
                mockFileDataAccessor.AddFile(path, mockFileDataAccessor.AdjustTimes(new MockFileData(bytes), TimeAdjustments.All));
            }
            else
            {
                var file = mockFileDataAccessor.GetFile(path);
                file.CheckFileAccess(path, FileAccess.Write);
                mockFileDataAccessor.AdjustTimes(file, TimeAdjustments.LastAccessTime | TimeAdjustments.LastWriteTime);
                file.Contents = file.Contents.Concat(bytes).ToArray();
            }
        }

        /// <inheritdoc cref="IFile.AppendAllBytes(string,ReadOnlySpan{byte})"/>
        public override void AppendAllBytes(string path, ReadOnlySpan<byte> bytes)
        {
            AppendAllBytes(path, bytes.ToArray());
        }
#endif

    /// <inheritdoc />
    public override void AppendAllLines(string path, IEnumerable<string> contents)
    {
        AppendAllLines(path, contents, MockFileData.DefaultEncoding);
    }

    /// <inheritdoc />
    public override void AppendAllLines(string path, IEnumerable<string> contents, Encoding encoding)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
        VerifyValueIsNotNull(contents, nameof(contents));
        VerifyValueIsNotNull(encoding, nameof(encoding));

        var concatContents = contents.Aggregate("", (a, b) => a + b + Environment.NewLine);
        AppendAllText(path, concatContents, encoding);
    }

    /// <inheritdoc />
    public override void AppendAllText(string path, string contents)
    {
        AppendAllText(path, contents, MockFileData.DefaultEncoding);
    }

    /// <inheritdoc />
    public override void AppendAllText(string path, string contents, Encoding encoding)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        if (encoding == null)
        {
            throw new ArgumentNullException(nameof(encoding));
        }

        if (!mockFileDataAccessor.FileExists(path))
        {
            VerifyDirectoryExists(path);
            mockFileDataAccessor.AddFile(path, mockFileDataAccessor.AdjustTimes(new MockFileData(contents, encoding), TimeAdjustments.All));
        }
        else
        {
            var file = mockFileDataAccessor.GetFile(path);
            file.CheckFileAccess(path, FileAccess.Write);
            mockFileDataAccessor.AdjustTimes(file, TimeAdjustments.LastAccessTime | TimeAdjustments.LastWriteTime);
            var bytesToAppend = encoding.GetBytes(contents);
            file.Contents = file.Contents.Concat(bytesToAppend).ToArray();
        }
    }

#if FEATURE_FILE_SPAN
        /// <inheritdoc cref="IFile.AppendAllText(string,ReadOnlySpan{char})"/>
        public override void AppendAllText(string path, ReadOnlySpan<char> contents)
        {
            AppendAllText(path, contents.ToString());
        }

        /// <inheritdoc cref="IFile.AppendAllText(string,ReadOnlySpan{char},Encoding)"/>
        public override void AppendAllText(string path, ReadOnlySpan<char> contents, Encoding encoding)
        {
            AppendAllText(path, contents.ToString(), encoding);
        }
#endif

    /// <inheritdoc />
    public override StreamWriter AppendText(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        if (mockFileDataAccessor.FileExists(path))
        {
            StreamWriter sw = new StreamWriter(OpenWrite(path));
            sw.BaseStream.Seek(0, SeekOrigin.End); //push the stream pointer at the end for append.
            return sw;
        }

        return new StreamWriter(Create(path));
    }

    /// <inheritdoc />
    public override void Copy(string sourceFileName, string destFileName)
    {
        Copy(sourceFileName, destFileName, false);
    }

    /// <inheritdoc />
    public override void Copy(string sourceFileName, string destFileName, bool overwrite)
    {
        if (sourceFileName == null)
        {
            throw CommonExceptions.FilenameCannotBeNull(nameof(sourceFileName));
        }

        if (destFileName == null)
        {
            throw CommonExceptions.FilenameCannotBeNull(nameof(destFileName));
        }

        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(sourceFileName, nameof(sourceFileName));
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(destFileName, nameof(destFileName));

        if (!Exists(sourceFileName))
        {
            throw CommonExceptions.FileNotFound(sourceFileName);
        }

        VerifyDirectoryExists(destFileName);

        var fileExists = mockFileDataAccessor.FileExists(destFileName);
        if (fileExists)
        {
            if (!overwrite)
            {
                throw CommonExceptions.FileAlreadyExists(destFileName);
            }

            if (string.Equals(sourceFileName, destFileName, StringComparison.OrdinalIgnoreCase) && XFS.IsWindowsPlatform())
            {
                throw CommonExceptions.ProcessCannotAccessFileInUse(destFileName);
            }

            mockFileDataAccessor.RemoveFile(destFileName);
        }

        var sourceFileData = mockFileDataAccessor.GetFile(sourceFileName);
        sourceFileData.CheckFileAccess(sourceFileName, FileAccess.Read);
        var destFileData = new MockFileData(sourceFileData);
        mockFileDataAccessor.AdjustTimes(destFileData, TimeAdjustments.CreationTime | TimeAdjustments.LastAccessTime);
        mockFileDataAccessor.AddFile(destFileName, destFileData);
    }

    /// <inheritdoc />
    public override FileSystemStream Create(string path) =>
        Create(path, 4096);

    /// <inheritdoc />
    public override FileSystemStream Create(string path, int bufferSize) =>
        Create(path, bufferSize, FileOptions.None);

    /// <inheritdoc />
    public override FileSystemStream Create(string path, int bufferSize, FileOptions options) =>
        CreateInternal(path, FileAccess.ReadWrite, options);

    private FileSystemStream CreateInternal(string path, FileAccess access, FileOptions options)
    {
        if (path == null)
        {
            throw new ArgumentNullException(nameof(path), "Path cannot be null.");
        }

        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, nameof(path));
        VerifyDirectoryExists(path);

        var mockFileData = new MockFileData(new byte[0]);
        mockFileDataAccessor.AdjustTimes(mockFileData, TimeAdjustments.All);
        mockFileDataAccessor.AddFile(path, mockFileData);
        return OpenInternal(path, FileMode.Open, access, options);
    }

#if FEATURE_CREATE_SYMBOLIC_LINK
        /// <inheritdoc />
        public override IFileSystemInfo CreateSymbolicLink(string path, string pathToTarget)
        {
            if (path == null)
            {
                throw CommonExceptions.FilenameCannotBeNull(nameof(path));
            }

            if (pathToTarget == null)
            {
                throw CommonExceptions.FilenameCannotBeNull(nameof(pathToTarget));
            }

            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, nameof(path));
            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(pathToTarget, nameof(pathToTarget));

            if (Exists(path))
            {
                throw CommonExceptions.FileAlreadyExists(nameof(path));
            }

            VerifyDirectoryExists(path);

            var fileExists = mockFileDataAccessor.FileExists(pathToTarget);
            if (!fileExists)
            {
                throw CommonExceptions.FileNotFound(pathToTarget);
            }

            var sourceFileData = mockFileDataAccessor.GetFile(pathToTarget);
            sourceFileData.CheckFileAccess(pathToTarget, FileAccess.Read);
            var destFileData = new MockFileData(new byte[0]);
            mockFileDataAccessor.AdjustTimes(destFileData, TimeAdjustments.CreationTime | TimeAdjustments.LastAccessTime);
            destFileData.LinkTarget = pathToTarget;
            mockFileDataAccessor.AddFile(path, destFileData);

            var mockFileInfo = new MockFileInfo(mockFileDataAccessor, path);
            mockFileInfo.Attributes |= FileAttributes.ReparsePoint;
            return mockFileInfo;
        }
#endif
    /// <inheritdoc />
    public override StreamWriter CreateText(string path)
    {
        return new StreamWriter(Create(path));
    }

    /// <inheritdoc />
    public override void Decrypt(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        new MockFileInfo(mockFileDataAccessor, path).Decrypt();
    }
    /// <inheritdoc />
    public override void Delete(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        // We mimic exact behavior of the standard File.Delete() method
        // which throws exception only if the folder does not exist,
        // but silently returns if deleting a non-existing file in an existing folder.
        VerifyDirectoryExists(path);

        var file = mockFileDataAccessor.GetFile(path);
        if (file != null && !file.AllowedFileShare.HasFlag(FileShare.Delete))
        {
            throw CommonExceptions.ProcessCannotAccessFileInUse(path);
        }

        if (file != null && file.IsDirectory)
        {
            throw new UnauthorizedAccessException($"Access to the path '{path}' is denied.");
        }

        mockFileDataAccessor.RemoveFile(path);
    }

    /// <inheritdoc />
    public override void Encrypt(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        new MockFileInfo(mockFileDataAccessor, path).Encrypt();
    }

    /// <inheritdoc />
    public override bool Exists(string path)
    {
        if (path == null)
        {
            return false;
        }

        if (path.Trim() == string.Empty)
        {
            return false;
        }

        //Not handling exceptions here so that mock behaviour is as similar as possible to System.IO.File.Exists (See #810)
        try
        {
            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, nameof(path));

            var file = mockFileDataAccessor.GetFile(path);
            return file != null && !file.IsDirectory;
        }
        catch (ArgumentException) { }
        catch (NotSupportedException) { }
        catch (IOException) { }
        catch (UnauthorizedAccessException) { }

        return false;
    }

    /// <summary>
    /// Gets the <see cref="FileAttributes"/> of the file on the path.
    /// </summary>
    /// <param name="path">The path to the file.</param>
    /// <returns>The <see cref="FileAttributes"/> of the file on the path.</returns>
    /// <exception cref="ArgumentException"><paramref name="path"/> is empty, contains only white spaces, or contains invalid characters.</exception>
    /// <exception cref="PathTooLongException">The specified path, file name, or both exceed the system-defined maximum length. For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.</exception>
    /// <exception cref="NotSupportedException"><paramref name="path"/> is in an invalid format.</exception>
    /// <exception cref="FileNotFoundException"><paramref name="path"/> represents a file and is invalid, such as being on an unmapped drive, or the file cannot be found.</exception>
    /// <exception cref="DirectoryNotFoundException"><paramref name="path"/> represents a directory and is invalid, such as being on an unmapped drive, or the directory cannot be found.</exception>
    /// <exception cref="IOException">This file is being used by another process.</exception>
    /// <exception cref="UnauthorizedAccessException">The caller does not have the required permission.</exception>
    public override FileAttributes GetAttributes(string path)
    {
        if (path != null && path.Length == 0)
        {
            throw CommonExceptions.PathIsNotOfALegalForm(nameof(path));
        }

        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        var possibleFileData = mockFileDataAccessor.GetFile(path);
        FileAttributes result;
        if (possibleFileData != null)
        {
            result = possibleFileData.Attributes;
        }
        else
        {
            var directoryInfo = mockFileDataAccessor.DirectoryInfo.New(path);
            if (directoryInfo.Exists)
            {
                result = directoryInfo.Attributes;
            }
            else
            {
                VerifyDirectoryExists(path);

                throw CommonExceptions.FileNotFound(path);
            }
        }

        return result;
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override FileAttributes GetAttributes(SafeFileHandle fileHandle)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override DateTime GetCreationTime(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return GetTimeFromFile(path, data => data.CreationTime.LocalDateTime, () => MockFileData.DefaultDateTimeOffset.LocalDateTime);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override DateTime GetCreationTime(SafeFileHandle fileHandle)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override DateTime GetCreationTimeUtc(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return GetTimeFromFile(path, data => data.CreationTime.UtcDateTime, () => MockFileData.DefaultDateTimeOffset.UtcDateTime);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override DateTime GetCreationTimeUtc(SafeFileHandle fileHandle)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override DateTime GetLastAccessTime(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return GetTimeFromFile(path, data => data.LastAccessTime.LocalDateTime, () => MockFileData.DefaultDateTimeOffset.LocalDateTime);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override DateTime GetLastAccessTime(SafeFileHandle fileHandle)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override DateTime GetLastAccessTimeUtc(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return GetTimeFromFile(path, data => data.LastAccessTime.UtcDateTime, () => MockFileData.DefaultDateTimeOffset.UtcDateTime);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override DateTime GetLastAccessTimeUtc(SafeFileHandle fileHandle)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override DateTime GetLastWriteTime(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return GetTimeFromFile(path, data => data.LastWriteTime.LocalDateTime, () => MockFileData.DefaultDateTimeOffset.LocalDateTime);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override DateTime GetLastWriteTime(SafeFileHandle fileHandle)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override DateTime GetLastWriteTimeUtc(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return GetTimeFromFile(path, data => data.LastWriteTime.UtcDateTime, () => MockFileData.DefaultDateTimeOffset.UtcDateTime);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override DateTime GetLastWriteTimeUtc(SafeFileHandle fileHandle)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

#if FEATURE_UNIX_FILE_MODE
        /// <inheritdoc />
        public override UnixFileMode GetUnixFileMode(string path)
        {
            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

            if (!mockFileDataAccessor.FileExists(path))
            {
                throw CommonExceptions.FileNotFound(path);
            }
            
            var mockFileData = mockFileDataAccessor.GetFile(path);
            return mockFileData.UnixMode;
        }
#endif

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override UnixFileMode GetUnixFileMode(SafeFileHandle fileHandle)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    private DateTime GetTimeFromFile(string path, Func<MockFileData, DateTime> existingFileFunction, Func<DateTime> nonExistingFileFunction)
    {
        DateTime result;
        MockFileData file = mockFileDataAccessor.GetFile(path);
        if (file != null)
        {
            result = existingFileFunction(file);
        }
        else
        {
            result = nonExistingFileFunction();
        }

        return result;
    }

    /// <inheritdoc />
    public override void Move(string sourceFileName, string destFileName)
    {
        if (sourceFileName == null)
        {
            throw CommonExceptions.FilenameCannotBeNull(nameof(sourceFileName));
        }

        if (destFileName == null)
        {
            throw CommonExceptions.FilenameCannotBeNull(nameof(destFileName));
        }

        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(sourceFileName, nameof(sourceFileName));
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(destFileName, nameof(destFileName));

        var sourceFile = mockFileDataAccessor.GetFile(sourceFileName);

        if (sourceFile == null)
        {
            throw CommonExceptions.FileNotFound(sourceFileName);
        }

        if (!sourceFile.AllowedFileShare.HasFlag(FileShare.Delete))
        {
            throw CommonExceptions.ProcessCannotAccessFileInUse();
        }

        VerifyDirectoryExists(destFileName);

        if (mockFileDataAccessor.GetFile(destFileName) != null)
        {
            if (mockFileDataAccessor.StringOperations.Equals(destFileName, sourceFileName))
            {
                if (XFS.IsWindowsPlatform())
                {
                    mockFileDataAccessor.RemoveFile(sourceFileName);
                    mockFileDataAccessor.AddFile(destFileName, mockFileDataAccessor.AdjustTimes(new MockFileData(sourceFile), TimeAdjustments.LastAccessTime), false);
                }
                return;
            }
            else
            {
                throw new IOException("A file can not be created if it already exists.");
            }
        }

        mockFileDataAccessor.RemoveFile(sourceFileName, false);
        mockFileDataAccessor.AddFile(destFileName, mockFileDataAccessor.AdjustTimes(new MockFileData(sourceFile), TimeAdjustments.LastAccessTime), false);
    }

#if FEATURE_FILE_MOVE_WITH_OVERWRITE
        /// <inheritdoc />
        public override void Move(string sourceFileName, string destFileName, bool overwrite)
        {
            if (sourceFileName == null)
            {
                throw CommonExceptions.FilenameCannotBeNull(nameof(sourceFileName));
            }

            if (destFileName == null)
            {
                throw CommonExceptions.FilenameCannotBeNull(nameof(destFileName));
            }

            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(sourceFileName, nameof(sourceFileName));
            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(destFileName, nameof(destFileName));

            if (mockFileDataAccessor.GetFile(destFileName) != null)
            {
                if (destFileName.Equals(sourceFileName))
                {
                    return;
                }
                else if (!overwrite)
                {
                    throw new IOException("A file can not be created if it already exists.");
                }
            }


            var sourceFile = mockFileDataAccessor.GetFile(sourceFileName);

            if (sourceFile == null)
            {
                throw CommonExceptions.FileNotFound(sourceFileName);
            }
            if (!sourceFile.AllowedFileShare.HasFlag(FileShare.Delete))
            {
                throw CommonExceptions.ProcessCannotAccessFileInUse();
            }
            VerifyDirectoryExists(destFileName);
            
            mockFileDataAccessor.RemoveFile(sourceFileName);
            mockFileDataAccessor.AddFile(destFileName, mockFileDataAccessor.AdjustTimes(new MockFileData(sourceFile), TimeAdjustments.LastAccessTime));
        }
#endif

    /// <inheritdoc />
    public override FileSystemStream Open(string path, FileMode mode)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return Open(path, mode, mode == FileMode.Append ? FileAccess.Write : FileAccess.ReadWrite, FileShare.None);
    }

    /// <inheritdoc />
    public override FileSystemStream Open(string path, FileMode mode, FileAccess access)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return Open(path, mode, access, FileShare.None);
    }

    /// <inheritdoc />
    public override FileSystemStream Open(string path, FileMode mode, FileAccess access, FileShare share) =>
        OpenInternal(path, mode, access, FileOptions.None);

#if FEATURE_FILESTREAM_OPTIONS
        /// <inheritdoc />
        public override FileSystemStream Open(string path, FileStreamOptions options)
        {
            return OpenInternal(path, options.Mode, options.Access, options.Options);
        }
#endif

    private FileSystemStream OpenInternal(
        string path,
        FileMode mode,
        FileAccess access,
        FileOptions options)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        bool exists = mockFileDataAccessor.FileExists(path);

        if (mode == FileMode.CreateNew && exists)
        {
            throw CommonExceptions.FileAlreadyExists(path);
        }

        if ((mode == FileMode.Open || mode == FileMode.Truncate) && !exists)
        {
            throw CommonExceptions.FileNotFound(path);
        }

        if (!exists || mode == FileMode.CreateNew)
        {
            return CreateInternal(path, access, options);
        }

        if (mode == FileMode.Create || mode == FileMode.Truncate)
        {
            Delete(path);
            return CreateInternal(path, access, options);
        }

        var mockFileData = mockFileDataAccessor.GetFile(path);
        mockFileData.CheckFileAccess(path, access);
        var timeAdjustments = TimeAdjustments.LastAccessTime;
        if (access.HasFlag(FileAccess.Write))
        {
            timeAdjustments |= TimeAdjustments.LastWriteTime;
        }
        mockFileDataAccessor.AdjustTimes(mockFileData, timeAdjustments);

        return new MockFileStream(mockFileDataAccessor, path, mode, access, options);
    }

    /// <inheritdoc />
    public override FileSystemStream OpenRead(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return Open(path, FileMode.Open, FileAccess.Read, FileShare.Read);
    }

    /// <inheritdoc />
    public override StreamReader OpenText(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return new StreamReader(OpenRead(path));
    }

    /// <inheritdoc />
    public override FileSystemStream OpenWrite(string path) => OpenWriteInternal(path, FileOptions.None);

    private FileSystemStream OpenWriteInternal(string path, FileOptions options)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
        return OpenInternal(path, FileMode.OpenOrCreate, FileAccess.Write, options);
    }

    /// <inheritdoc />
    public override byte[] ReadAllBytes(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        if (!mockFileDataAccessor.FileExists(path))
        {
            throw CommonExceptions.FileNotFound(path);
        }
        mockFileDataAccessor.GetFile(path).CheckFileAccess(path, FileAccess.Read);
        var fileData = mockFileDataAccessor.GetFile(path);
        mockFileDataAccessor.AdjustTimes(fileData, TimeAdjustments.LastAccessTime);
        return fileData.Contents.ToArray();
    }

    /// <inheritdoc />
    public override string[] ReadAllLines(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        if (!mockFileDataAccessor.FileExists(path))
        {
            throw CommonExceptions.FileNotFound(path);
        }
        var fileData = mockFileDataAccessor.GetFile(path);
        fileData.CheckFileAccess(path, FileAccess.Read);
        mockFileDataAccessor.AdjustTimes(fileData, TimeAdjustments.LastAccessTime);

        return fileData
            .TextContents
            .SplitLines();
    }

    /// <inheritdoc />
    public override string[] ReadAllLines(string path, Encoding encoding)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        if (encoding == null)
        {
            throw new ArgumentNullException(nameof(encoding));
        }

        if (!mockFileDataAccessor.FileExists(path))
        {
            throw CommonExceptions.FileNotFound(path);
        }

        var fileData = mockFileDataAccessor.GetFile(path);
        fileData.CheckFileAccess(path, FileAccess.Read);
        mockFileDataAccessor.AdjustTimes(fileData, TimeAdjustments.LastAccessTime);

        using (var ms = new MemoryStream(fileData.Contents))
        using (var sr = new StreamReader(ms, encoding))
        {
            return sr.ReadToEnd().SplitLines();
        }
    }

    /// <inheritdoc />
    public override string ReadAllText(string path)
    {
        return ReadAllText(path, MockFileData.DefaultEncoding);
    }

    /// <inheritdoc />
    public override string ReadAllText(string path, Encoding encoding)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        if (!mockFileDataAccessor.FileExists(path))
        {
            throw CommonExceptions.FileNotFound(path);
        }

        if (encoding == null)
        {
            throw new ArgumentNullException(nameof(encoding));
        }

        return ReadAllTextInternal(path, encoding);
    }

    /// <inheritdoc />
    public override IEnumerable<string> ReadLines(string path)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        return ReadAllLines(path);
    }

    /// <inheritdoc />
    public override IEnumerable<string> ReadLines(string path, Encoding encoding)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
        VerifyValueIsNotNull(encoding, "encoding");

        return ReadAllLines(path, encoding);
    }

    /// <inheritdoc />
    public override void Replace(string sourceFileName, string destinationFileName, string destinationBackupFileName)
    {
        Replace(sourceFileName, destinationFileName, destinationBackupFileName, false);
    }

    /// <inheritdoc />
    public override void Replace(string sourceFileName, string destinationFileName, string destinationBackupFileName, bool ignoreMetadataErrors)
    {
        if (sourceFileName == null)
        {
            throw new ArgumentNullException(nameof(sourceFileName));
        }

        if (destinationFileName == null)
        {
            throw new ArgumentNullException(nameof(destinationFileName));
        }

        if (!mockFileDataAccessor.FileExists(sourceFileName))
        {
            throw CommonExceptions.FileNotFound(sourceFileName);
        }

        if (!mockFileDataAccessor.FileExists(destinationFileName))
        {
            throw CommonExceptions.FileNotFound(destinationFileName);
        }

        if (mockFileDataAccessor.StringOperations.Equals(sourceFileName, destinationFileName) && XFS.IsWindowsPlatform())
        {
            throw CommonExceptions.ProcessCannotAccessFileInUse();
        }

        if (destinationBackupFileName != null)
        {
            Copy(destinationFileName, destinationBackupFileName, overwrite: true);
        }

        Delete(destinationFileName);
        Move(sourceFileName, destinationFileName);
    }

#if FEATURE_CREATE_SYMBOLIC_LINK
        /// <inheritdoc />
        public override IFileSystemInfo ResolveLinkTarget(string linkPath, bool returnFinalTarget)
        {
            var initialContainer = mockFileDataAccessor.GetFile(linkPath);
            if (initialContainer.LinkTarget != null)
            {
                var nextLocation = initialContainer.LinkTarget;
                var nextContainer = mockFileDataAccessor.GetFile(nextLocation);

                if (returnFinalTarget)
                {
                    // The maximum number of symbolic links that are followed:
                    // https://learn.microsoft.com/en-us/dotnet/api/system.io.directory.resolvelinktarget?view=net-6.0#remarks
                    int maxResolveLinks = XFS.IsWindowsPlatform() ? 63 : 40;
                    for (int i = 1; i < maxResolveLinks; i++)
                    {
                        if (nextContainer.LinkTarget == null)
                        {
                            break;
                        }
                        nextLocation = nextContainer.LinkTarget;
                        nextContainer = mockFileDataAccessor.GetFile(nextLocation);
                    }

                    if (nextContainer.LinkTarget != null)
                    {
                        throw CommonExceptions.NameCannotBeResolvedByTheSystem(linkPath);
                    }
                }

                if (nextContainer.IsDirectory)
                {
                    return new MockDirectoryInfo(mockFileDataAccessor, nextLocation);
                }
                else
                {
                    return new MockFileInfo(mockFileDataAccessor, nextLocation);
                }
            }
            throw CommonExceptions.NameCannotBeResolvedByTheSystem(linkPath);
        }
#endif

    /// <inheritdoc />
    public override void SetAttributes(string path, FileAttributes fileAttributes)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        var possibleFileData = mockFileDataAccessor.GetFile(path);
        if (possibleFileData == null)
        {
            var directoryInfo = mockFileDataAccessor.DirectoryInfo.New(path);
            if (directoryInfo.Exists)
            {
                directoryInfo.Attributes = fileAttributes;
            }
            else
            {
                throw CommonExceptions.FileNotFound(path);
            }
        }
        else
        {
            mockFileDataAccessor.AdjustTimes(possibleFileData, TimeAdjustments.LastAccessTime);
            possibleFileData.Attributes = fileAttributes;
        }
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override void SetAttributes(SafeFileHandle fileHandle, FileAttributes fileAttributes)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override void SetCreationTime(string path, DateTime creationTime)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        mockFileDataAccessor.GetFile(path).CreationTime = new DateTimeOffset(creationTime);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override void SetCreationTime(SafeFileHandle fileHandle, DateTime creationTime)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override void SetCreationTimeUtc(string path, DateTime creationTimeUtc)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        mockFileDataAccessor.GetFile(path).CreationTime = new DateTimeOffset(creationTimeUtc, TimeSpan.Zero);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override void SetCreationTimeUtc(SafeFileHandle fileHandle, DateTime creationTimeUtc)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override void SetLastAccessTime(string path, DateTime lastAccessTime)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        mockFileDataAccessor.GetFile(path).LastAccessTime = new DateTimeOffset(lastAccessTime);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override void SetLastAccessTime(SafeFileHandle fileHandle, DateTime lastAccessTime)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override void SetLastAccessTimeUtc(string path, DateTime lastAccessTimeUtc)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        mockFileDataAccessor.GetFile(path).LastAccessTime = new DateTimeOffset(lastAccessTimeUtc, TimeSpan.Zero);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override void SetLastAccessTimeUtc(SafeFileHandle fileHandle, DateTime lastAccessTimeUtc)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override void SetLastWriteTime(string path, DateTime lastWriteTime)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        mockFileDataAccessor.GetFile(path).LastWriteTime = new DateTimeOffset(lastWriteTime);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override void SetLastWriteTime(SafeFileHandle fileHandle, DateTime lastWriteTime)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <inheritdoc />
    public override void SetLastWriteTimeUtc(string path, DateTime lastWriteTimeUtc)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

        mockFileDataAccessor.GetFile(path).LastWriteTime = new DateTimeOffset(lastWriteTimeUtc, TimeSpan.Zero);
    }

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override void SetLastWriteTimeUtc(SafeFileHandle fileHandle, DateTime lastWriteTimeUtc)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

#if FEATURE_UNIX_FILE_MODE
        /// <inheritdoc />
        public override void SetUnixFileMode(string path, UnixFileMode mode)
        {
            mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");

            if (!mockFileDataAccessor.FileExists(path))
            {
                throw CommonExceptions.FileNotFound(path);
            }
            
            var mockFileData = mockFileDataAccessor.GetFile(path);
            mockFileData.UnixMode = mode;
        }
#endif

#if FEATURE_FILE_ATTRIBUTES_VIA_HANDLE
        /// <inheritdoc />
        public override void SetUnixFileMode(SafeFileHandle fileHandle, UnixFileMode mode)
        {
            throw CommonExceptions.NotImplemented();
        }
#endif

    /// <summary>
    /// Creates a new file, writes the specified byte array to the file, and then closes the file.
    /// If the target file already exists, it is overwritten.
    /// </summary>
    /// <param name="path">The file to write to.</param>
    /// <param name="bytes">The bytes to write to the file. </param>
    /// <exception cref="ArgumentException"><paramref name="path"/> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="Path.GetInvalidPathChars"/>.</exception>
    /// <exception cref="ArgumentNullException"><paramref name="path"/> is <see langword="null"/> or contents is empty.</exception>
    /// <exception cref="PathTooLongException">
    /// The specified path, file name, or both exceed the system-defined maximum length.
    /// For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
    /// </exception>
    /// <exception cref="DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
    /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
    /// <exception cref="UnauthorizedAccessException">
    /// path specified a file that is read-only.
    /// -or-
    /// This operation is not supported on the current platform.
    /// -or-
    /// path specified a directory.
    /// -or-
    /// The caller does not have the required permission.
    /// </exception>
    /// <exception cref="FileNotFoundException">The file specified in <paramref name="path"/> was not found.</exception>
    /// <exception cref="NotSupportedException"><paramref name="path"/> is in an invalid format.</exception>
    /// <exception cref="System.Security.SecurityException">The caller does not have the required permission.</exception>
    /// <remarks>
    /// Given a byte array and a file path, this method opens the specified file, writes the contents of the byte array to the file, and then closes the file.
    /// </remarks>
    public override void WriteAllBytes(string path, byte[] bytes)
    {
        VerifyValueIsNotNull(bytes, "bytes");

        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
        VerifyDirectoryExists(path);

        mockFileDataAccessor.AddFile(path, mockFileDataAccessor.AdjustTimes(new MockFileData(bytes.ToArray()), TimeAdjustments.All));
    }

#if FEATURE_FILE_SPAN
        /// <inheritdoc cref="IFile.WriteAllBytes(string,ReadOnlySpan{byte})"/>
        public override void WriteAllBytes(string path, ReadOnlySpan<byte> bytes)
        {
            WriteAllBytes(path, bytes.ToArray());
        }
#endif

    /// <summary>
    /// Creates a new file, writes a collection of strings to the file, and then closes the file.
    /// </summary>
    /// <param name="path">The file to write to.</param>
    /// <param name="contents">The lines to write to the file.</param>
    /// <exception cref="ArgumentException"><paramref name="path"/> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="Path.GetInvalidPathChars"/>.</exception>
    /// <exception cref="ArgumentNullException">Either <paramref name="path"/> or <paramref name="contents"/> is <see langword="null"/>.</exception>
    /// <exception cref="DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
    /// <exception cref="FileNotFoundException">The file specified in <paramref name="path"/> was not found.</exception>
    /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
    /// <exception cref="PathTooLongException">
    /// The specified path, file name, or both exceed the system-defined maximum length.
    /// For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
    /// </exception>
    /// <exception cref="NotSupportedException"><paramref name="path"/> is in an invalid format.</exception>
    /// <exception cref="System.Security.SecurityException">The caller does not have the required permission.</exception>
    /// <exception cref="UnauthorizedAccessException">
    /// <paramref name="path"/> specified a file that is read-only.
    /// -or-
    /// This operation is not supported on the current platform.
    /// -or-
    /// <paramref name="path"/> specified a directory.
    /// -or-
    /// The caller does not have the required permission.
    /// </exception>
    /// <remarks>
    /// <para>
    ///     If the target file already exists, it is overwritten.
    /// </para>
    /// <para>
    ///     You can use this method to create the contents for a collection class that takes an <see cref="IEnumerable{T}"/> in its constructor, such as a <see cref="List{T}"/>, <see cref="HashSet{T}"/>, or a <see cref="SortedSet{T}"/> class.
    /// </para>
    /// </remarks>
    public override void WriteAllLines(string path, IEnumerable<string> contents)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
        VerifyValueIsNotNull(contents, "contents");

        WriteAllLines(path, contents, MockFileData.DefaultEncoding);
    }

    /// <summary>
    /// Creates a new file by using the specified encoding, writes a collection of strings to the file, and then closes the file.
    /// </summary>
    /// <param name="path">The file to write to.</param>
    /// <param name="contents">The lines to write to the file.</param>
    /// <param name="encoding">The character encoding to use.</param>
    /// <exception cref="ArgumentException"><paramref name="path"/> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="Path.GetInvalidPathChars"/>.</exception>
    /// <exception cref="ArgumentNullException">Either <paramref name="path"/>, <paramref name="contents"/>, or <paramref name="encoding"/> is <see langword="null"/>.</exception>
    /// <exception cref="DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
    /// <exception cref="FileNotFoundException">The file specified in <paramref name="path"/> was not found.</exception>
    /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
    /// <exception cref="PathTooLongException">
    /// The specified path, file name, or both exceed the system-defined maximum length.
    /// For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
    /// </exception>
    /// <exception cref="NotSupportedException"><paramref name="path"/> is in an invalid format.</exception>
    /// <exception cref="System.Security.SecurityException">The caller does not have the required permission.</exception>
    /// <exception cref="UnauthorizedAccessException">
    /// <paramref name="path"/> specified a file that is read-only.
    /// -or-
    /// This operation is not supported on the current platform.
    /// -or-
    /// <paramref name="path"/> specified a directory.
    /// -or-
    /// The caller does not have the required permission.
    /// </exception>
    /// <remarks>
    /// <para>
    ///     If the target file already exists, it is overwritten.
    /// </para>
    /// <para>
    ///     You can use this method to create a file that contains the following:
    /// <list type="bullet">
    /// <item>
    /// <description>The results of a LINQ to Objects query on the lines of a file, as obtained by using the ReadLines method.</description>
    /// </item>
    /// <item>
    /// <description>The contents of a collection that implements an <see cref="IEnumerable{T}"/> of strings.</description>
    /// </item>
    /// </list>
    /// </para>
    /// </remarks>
    public override void WriteAllLines(string path, IEnumerable<string> contents, Encoding encoding)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
        VerifyValueIsNotNull(contents, "contents");
        VerifyValueIsNotNull(encoding, "encoding");

        var sb = new StringBuilder();
        foreach (var line in contents)
        {
            sb.AppendLine(line);
        }

        WriteAllText(path, sb.ToString(), encoding);
    }

    /// <summary>
    /// Creates a new file, writes the specified string array to the file by using the specified encoding, and then closes the file.
    /// </summary>
    /// <param name="path">The file to write to.</param>
    /// <param name="contents">The string array to write to the file.</param>
    /// <exception cref="ArgumentException"><paramref name="path"/> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="Path.GetInvalidPathChars"/>.</exception>
    /// <exception cref="ArgumentNullException">Either <paramref name="path"/> or <paramref name="contents"/> is <see langword="null"/>.</exception>
    /// <exception cref="PathTooLongException">
    /// The specified path, file name, or both exceed the system-defined maximum length.
    /// For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
    /// </exception>
    /// <exception cref="DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
    /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
    /// <exception cref="UnauthorizedAccessException">
    /// <paramref name="path"/> specified a file that is read-only.
    /// -or-
    /// This operation is not supported on the current platform.
    /// -or-
    /// <paramref name="path"/> specified a directory.
    /// -or-
    /// The caller does not have the required permission.
    /// </exception>
    /// <exception cref="FileNotFoundException">The file specified in <paramref name="path"/> was not found.</exception>
    /// <exception cref="NotSupportedException"><paramref name="path"/> is in an invalid format.</exception>
    /// <exception cref="System.Security.SecurityException">The caller does not have the required permission.</exception>
    /// <remarks>
    /// <para>
    ///     If the target file already exists, it is overwritten.
    /// </para>
    /// <para>
    ///     The default behavior of the WriteAllLines method is to write out data using UTF-8 encoding without a byte order mark (BOM). If it is necessary to include a UTF-8 identifier, such as a byte order mark, at the beginning of a file, use the <see cref="FileBase.WriteAllLines(string,string[],System.Text.Encoding)"/> method overload with <see cref="UTF8Encoding"/> encoding.
    /// </para>
    /// <para>
    ///     Given a string array and a file path, this method opens the specified file, writes the string array to the file using the specified encoding,
    ///     and then closes the file.
    /// </para>
    /// </remarks>
    public override void WriteAllLines(string path, string[] contents)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
        VerifyValueIsNotNull(contents, "contents");

        WriteAllLines(path, contents, MockFileData.DefaultEncoding);
    }

    /// <summary>
    /// Creates a new file, writes the specified string array to the file by using the specified encoding, and then closes the file.
    /// </summary>
    /// <param name="path">The file to write to.</param>
    /// <param name="contents">The string array to write to the file.</param>
    /// <param name="encoding">An <see cref="Encoding"/> object that represents the character encoding applied to the string array.</param>
    /// <exception cref="ArgumentException"><paramref name="path"/> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="Path.GetInvalidPathChars"/>.</exception>
    /// <exception cref="ArgumentNullException">Either <paramref name="path"/> or <paramref name="contents"/> is <see langword="null"/>.</exception>
    /// <exception cref="PathTooLongException">
    /// The specified path, file name, or both exceed the system-defined maximum length.
    /// For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
    /// </exception>
    /// <exception cref="DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
    /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
    /// <exception cref="UnauthorizedAccessException">
    /// <paramref name="path"/> specified a file that is read-only.
    /// -or-
    /// This operation is not supported on the current platform.
    /// -or-
    /// <paramref name="path"/> specified a directory.
    /// -or-
    /// The caller does not have the required permission.
    /// </exception>
    /// <exception cref="FileNotFoundException">The file specified in <paramref name="path"/> was not found.</exception>
    /// <exception cref="NotSupportedException"><paramref name="path"/> is in an invalid format.</exception>
    /// <exception cref="System.Security.SecurityException">The caller does not have the required permission.</exception>
    /// <remarks>
    /// <para>
    ///     If the target file already exists, it is overwritten.
    /// </para>
    /// <para>
    ///     Given a string array and a file path, this method opens the specified file, writes the string array to the file using the specified encoding,
    ///     and then closes the file.
    /// </para>
    /// </remarks>
    public override void WriteAllLines(string path, string[] contents, Encoding encoding)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
        VerifyValueIsNotNull(contents, "contents");
        VerifyValueIsNotNull(encoding, "encoding");

        WriteAllLines(path, new List<string>(contents), encoding);
    }

    /// <summary>
    /// Creates a new file, writes the specified string to the file using the specified encoding, and then closes the file. If the target file already exists, it is overwritten.
    /// </summary>
    /// <param name="path">The file to write to. </param>
    /// <param name="contents">The string to write to the file. </param>
    /// <exception cref="ArgumentException"><paramref name="path"/> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="Path.GetInvalidPathChars"/>.</exception>
    /// <exception cref="ArgumentNullException"><paramref name="path"/> is <see langword="null"/> or contents is empty.</exception>
    /// <exception cref="PathTooLongException">
    /// The specified path, file name, or both exceed the system-defined maximum length.
    /// For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
    /// </exception>
    /// <exception cref="DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
    /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
    /// <exception cref="UnauthorizedAccessException">
    /// path specified a file that is read-only.
    /// -or-
    /// This operation is not supported on the current platform.
    /// -or-
    /// path specified a directory.
    /// -or-
    /// The caller does not have the required permission.
    /// </exception>
    /// <exception cref="FileNotFoundException">The file specified in <paramref name="path"/> was not found.</exception>
    /// <exception cref="NotSupportedException"><paramref name="path"/> is in an invalid format.</exception>
    /// <exception cref="System.Security.SecurityException">The caller does not have the required permission.</exception>
    /// <remarks>
    /// This method uses UTF-8 encoding without a Byte-Order Mark (BOM), so using the <see cref="M:Encoding.GetPreamble"/> method will return an empty byte array.
    /// If it is necessary to include a UTF-8 identifier, such as a byte order mark, at the beginning of a file, use the <see cref="FileBase.WriteAllText(string,string,System.Text.Encoding)"/> method overload with <see cref="UTF8Encoding"/> encoding.
    /// <para>
    /// Given a string and a file path, this method opens the specified file, writes the string to the file, and then closes the file.
    /// </para>
    /// </remarks>
    public override void WriteAllText(string path, string contents)
    {
        WriteAllText(path, contents, MockFileData.DefaultEncoding);
    }

    /// <summary>
    /// Creates a new file, writes the specified string to the file using the specified encoding, and then closes the file. If the target file already exists, it is overwritten.
    /// </summary>
    /// <param name="path">The file to write to. </param>
    /// <param name="contents">The string to write to the file. </param>
    /// <param name="encoding">The encoding to apply to the string.</param>
    /// <exception cref="ArgumentException"><paramref name="path"/> is a zero-length string, contains only white space, or contains one or more invalid characters as defined by <see cref="Path.GetInvalidPathChars"/>.</exception>
    /// <exception cref="ArgumentNullException"><paramref name="path"/> is <see langword="null"/> or contents is empty.</exception>
    /// <exception cref="PathTooLongException">
    /// The specified path, file name, or both exceed the system-defined maximum length.
    /// For example, on Windows-based platforms, paths must be less than 248 characters, and file names must be less than 260 characters.
    /// </exception>
    /// <exception cref="DirectoryNotFoundException">The specified path is invalid (for example, it is on an unmapped drive).</exception>
    /// <exception cref="IOException">An I/O error occurred while opening the file.</exception>
    /// <exception cref="UnauthorizedAccessException">
    /// path specified a file that is read-only.
    /// -or-
    /// This operation is not supported on the current platform.
    /// -or-
    /// path specified a directory.
    /// -or-
    /// The caller does not have the required permission.
    /// </exception>
    /// <exception cref="FileNotFoundException">The file specified in <paramref name="path"/> was not found.</exception>
    /// <exception cref="NotSupportedException"><paramref name="path"/> is in an invalid format.</exception>
    /// <exception cref="System.Security.SecurityException">The caller does not have the required permission.</exception>
    /// <remarks>
    /// Given a string and a file path, this method opens the specified file, writes the string to the file using the specified encoding, and then closes the file.
    /// The file handle is guaranteed to be closed by this method, even if exceptions are raised.
    /// </remarks>
    public override void WriteAllText(string path, string contents, Encoding encoding)
    {
        mockFileDataAccessor.PathVerifier.IsLegalAbsoluteOrRelative(path, "path");
        VerifyValueIsNotNull(path, "path");

        if (mockFileDataAccessor.Directory.Exists(path))
        {
            throw CommonExceptions.AccessDenied(path);
        }

        VerifyDirectoryExists(path);

        MockFileData data = contents == null ? new MockFileData(new byte[0]) : new MockFileData(contents, encoding);
        mockFileDataAccessor.AddFile(path, mockFileDataAccessor.AdjustTimes(data, TimeAdjustments.All));
    }

#if FEATURE_FILE_SPAN
        /// <inheritdoc cref="IFile.WriteAllText(string,ReadOnlySpan{char})"/>
        public override void WriteAllText(string path, ReadOnlySpan<char> contents)
        {
            WriteAllText(path, contents.ToString());
        }

        /// <inheritdoc cref="IFile.WriteAllText(string,ReadOnlySpan{char},Encoding)"/>
        public override void WriteAllText(string path, ReadOnlySpan<char> contents, Encoding encoding)
        {
            WriteAllText(path, contents.ToString(), encoding);
        }
#endif

    internal static string ReadAllBytes(byte[] contents, Encoding encoding)
    {
        using (var ms = new MemoryStream(contents))
        using (var sr = new StreamReader(ms, encoding))
        {
            return sr.ReadToEnd();
        }
    }

    private string ReadAllTextInternal(string path, Encoding encoding)
    {
        var mockFileData = mockFileDataAccessor.GetFile(path);
        mockFileData.CheckFileAccess(path, FileAccess.Read);
        mockFileDataAccessor.AdjustTimes(mockFileData, TimeAdjustments.LastAccessTime);
        return ReadAllBytes(mockFileData.Contents, encoding);
    }

    private void VerifyValueIsNotNull(object value, string parameterName)
    {
        if (value == null)
        {
            throw new ArgumentNullException(parameterName, StringResources.Manager.GetString("VALUE_CANNOT_BE_NULL"));
        }
    }

    private void VerifyDirectoryExists(string path)
    {
        var pathOps = mockFileDataAccessor.Path;
        var dir = pathOps.GetDirectoryName(pathOps.GetFullPath(path));

        if (!mockFileDataAccessor.Directory.Exists(dir))
        {
            throw CommonExceptions.CouldNotFindPartOfPath(path);
        }
    }
}