培训
Unix 上的 GetFolderPath 行为
从 .NET 8 开始,Unix 操作系统上的 Environment.GetFolderPath 行为已做更改。
下表显示了对各种特殊文件夹而言,每个 Unix 操作系统返回的路径值是如何变化的。
SpecialFolder 值 | 路径(.NET 7 及更早版本) | 路径(.NET 8 及更高版本) |
---|---|---|
MyDocuments |
$HOME |
如果可用,则使用 XDG_DOCUMENTS_DIR ;否则为 $HOME/Documents |
Personal |
$HOME |
如果可用,则使用 XDG_DOCUMENTS_DIR ;否则为 $HOME/Documents |
SpecialFolder 值 | 路径(.NET 7 及更早版本) | 路径(.NET 8 及更高版本) |
---|---|---|
MyDocuments |
$HOME |
NSDocumentDirectory ($HOME/Documents ) |
Personal |
$HOME |
NSDocumentDirectory ($HOME/Documents ) |
ApplicationData |
$HOME/.config |
NSApplicationSupportDirectory(库/应用程序支持) |
LocalApplicationData |
$HOME/.local/share |
NSApplicationSupportDirectory(库/应用程序支持) |
MyVideos |
$HOME/Videos |
NSMoviesDirectory ($HOME/Movies ) |
SpecialFolder 值 | 路径(.NET 7 及更早版本) | 路径(.NET 8 及更高版本) |
---|---|---|
MyDocuments |
$HOME |
$HOME/Documents |
Personal |
$HOME |
$HOME/Documents |
.NET 8 预览版 1
此更改为行为更改。
以前的行为不正确,不符合用户对 Linux、macOS 和 Android 的期望。
最常见的中断出现在要在 Unix 上将 System.Environment.SpecialFolder.Personal 传递到 Environment.GetFolderPath(Environment+SpecialFolder) 以获取 $HOME
目录 (Environment.GetFolderPath(Environment.SpecialFolder.Personal)
) 的情况下。 Environment.SpecialFolder.Personal 和 Environment.SpecialFolder.MyDocuments 是同一基础枚举值的别名。 如果以这种方式使用 Environment.SpecialFolder.Personal,请将代码更改为传递 Environment.SpecialFolder.UserProfile(而不是 Environment.GetFolderPath(Environment.SpecialFolder.UserProfile)
)。
对于其他中断,建议执行以下操作之一:
- 将应用程序的文件迁移到相应的目录。
- 将上一位置的回退检查添加到代码中。