dotnet/runtime

Reconsider the exception type thrown when trying to open a directory as file

Open

#70.275 geöffnet am 6. Juni 2022

Auf GitHub ansehen
 (6 Kommentare) (0 Reaktionen) (0 zugewiesene Personen)C# (5.445 Forks)batch import
area-System.IOhelp wanted

Repository-Metriken

Stars
 (17.886 Stars)
PR-Merge-Metriken
 (Durchschn. Merge 12T 11h) (661 gemergte PRs in 30 T)

Beschreibung

In FileSystem.Windows, as well as SafeFileHandle.Windows we have this comment:

https://github.com/dotnet/runtime/blob/6a56aa3512c912df602bf074dc925b77f3895b24/src/libraries/System.Private.CoreLib/src/System/IO/FileSystem.Windows.cs#L216-L224

However, when testing with native code on Windows 10, calling CreateFileA returns ERROR_PATH_NOT_FOUND for either C:\ or other normal directories.

So this causing behavior inconsistency on managed API again: when calling File.Open on C:\, it throws UnauthorizedException. When calling with other directories, it throws PathNotFoundException.

I didn't find any test for exceptions in System.IO.FileSystem.

Changing the exception thrown is technically breaking, but helps for consistency. Changing to an exception is already used for other circumstances won't break much.

We need to also examine Windows 7 and 8 behavior and the behavior of CreateFile2 and NtCreateFile. (Or if you can directly check it through Windows source code)

Contributor Guide

Research-Richtung
Untersuchen Sie das Verhalten von CreateFileA, CreateFile2 und NtCreateFile unter Windows 7, 8 und 10 beim Öffnen von Verzeichnissen. Überprüfen Sie den Code in FileSystem.Windows.cs und SafeFileHandle.Windows.cs an den in der Issue referenzierten Zeilen. Bestimmen Sie, ob eine Änderung der ausgelösten Ausnahme (z. B. von UnauthorizedAccessException zu PathNotFoundException) konsistent wäre und ob dies bestehende Anwendungen brechen würde. Testen Sie die verwaltete API File.Open auf Verzeichnissen, um das aktuelle Verhalten zu bestätigen.
Tech Stack
csharp
Domain
backendapiinfrastructure
Issue Type
Fehler
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
3
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-2 Tage
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
Frisch
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
Meist klar
Voraussetzungen
C#Windows API
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
45