Skip to content

Clarify MatchCasing does not affect directory path resolution #12452

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
rtmongold wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Clarify MatchCasing does not affect directory path resolution #12452

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b2456e1
Clarify MatchCasing does not affect directory path resolution
rtmongold Mar 27, 2026
f8573a5
Fix XML formatting and update example for casing
rtmongold Mar 27, 2026
File filter

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 14 additions & 3 deletions xml/System.IO/EnumerationOptions.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -240,11 +240,22 @@ The suggested buffer size will not be used if it has no meaning for the native A

## Remarks

For APIs that allow specifying a match expression, this property allows you to specify the case matching behavior.
The default is to match platform defaults, which are gleaned from the case sensitivity of the temporary folder.
This property controls **case matching for file name patterns only**.
It **does not affect directory path resolution**. On case-sensitive file systems
(such as Linux and macOS), directory paths must match the exact casing regardless of this setting.

The default is to match the platform defaults, which are based on the case sensitivity of the filesystem.

]]></format>
</remarks>
</remarks>
<example>
<format type="text/markdown"><![CDATA[
Directory.GetFiles("/tmp/data", "*.TXT",
new EnumerationOptions { MatchCasing = MatchCasing.CaseInsensitive });

> Matches file names case-insensitively, but `/tmp/data` directory path must still match exact casing on Linux/macOS.
]]></format>
</example>
</Docs>
</Member>
<Member MemberName="MatchType">
Expand Down
Loading