File.WriteAllText是否真的抛出FileNotFoundException？

Question

文档说：

// Summary:
//     Creates a new file, writes the specified string to the file, and then closes
//     the file. If the target file already exists, it is overwritten.

第一行，第一句话： Creates a new file ，并列出以下例外：

//   System.IO.FileNotFoundException:
//     The file specified in path was not found.

在哪种情况下会发生？ 如果它总是创建文件，则不应抛出FileNotFoundException ...

文档是否有误？ 还是缺少<remarks>标签？

Answer 1

File.WriteAllText最终将调用：

private static void InternalWriteAllText(string path, string contents, Encoding encoding)
{
    using (StreamWriter streamWriter = new StreamWriter(path, false, encoding))
    {
        streamWriter.Write(contents);
    }
}

在调用InternalWriteAllText之前引发的所有异常均引发ArgumentException或ArgumentNullException但从理论上讲（因为FileStream可以引发异常）， streamWriter.Write(contents); 可能会引发异常。 尽管基于其功能以及如何打开streamWriter可能性很小。

我不一定要说文档本身是错误的 ，更多的是MS通过记录（非常罕见）可能性来掩盖他们的屁股。

来源：使用ILSpy反编译mscorlib v4.0.0.0。

更新

刚刚检查了mscorlib v2.0.0.0，除了包含较少的健全性检查（这意味着它基本上直接转换为上面的代码）之外，其他情况相同。