DownloadsFolder 類別

定義

命名空間:

Windows.Storage

在 [下載] 資料夾內建立檔案和資料夾。

public ref class DownloadsFolder abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class DownloadsFolder final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class DownloadsFolder

Public Class DownloadsFolder

繼承

Object Platform::Object IInspectable DownloadsFolder

屬性

ContractVersionAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

您可以在 [下載] 資料夾中建立空白檔案，如下所示：

StorageFile file = await Windows.Storage.DownloadsFolder.CreateFileAsync("sample.txt");
// Process file

createFileAsync完成之後， file 取得新的檔案作為StorageFile。

備註

這個類別是靜態的，無法具現化。 請改為直接呼叫 方法。

下載資料夾中的檔案和資料夾許可權

所有應用程式都可以在 [下載] 資料夾中建立檔案和資料夾，並可存取他們建立的檔案。 但應用程式無法存取 [下載] 資料夾中未建立的檔案。

當您的應用程式在 [下載] 資料夾中建立檔案時，除非使用者明確授與其他應用程式存取權，否則其他應用程式將無法干擾或存取您的檔案。 使用者可以從檔案選擇器中選取檔案，為另一個應用程式提供檔案存取權。 您的應用程式也可以使用檔案選擇器來存取其未建立之下載資料夾中的檔案。 深入瞭解使用選擇器開啟檔案選擇器中的檔案選擇 器開啟檔案和資料夾。

不需要在 [下載] 資料夾中建立或存取檔案的功能。 深入瞭解 應用程式功能宣告中的功能。

若要深入瞭解您的應用程式可以存取的位置，請參閱 檔案存取權限。

版本歷程記錄

Windows 版本	SDK 版本	新增值
1511	10586	CreateFileForUserAsync (User，String)
1511	10586	CreateFileForUserAsync (User，String，CreationCollisionOption)
1511	10586	CreateFolderForUserAsync (User，String)
1511	10586	CreateFolderForUserAsync (User，String，CreationCollisionOption)

方法

CreateFileAsync(String)	在 [下載] 資料夾內建立新的檔案。
CreateFileAsync(String, CreationCollisionOption)	在 [下載] 資料夾中建立新的檔案，並指定如果 [下載] 資料夾中已有相同名稱的檔案，該怎麼做。
CreateFileForUserAsync(User, String)	在特定 使用者的[下載] 資料夾內建立新的檔案。
CreateFileForUserAsync(User, String, CreationCollisionOption)	在特定 使用者的[下載] 資料夾中建立新的檔案，並指定如果 [下載] 資料夾中已有相同名稱的檔案，該怎麼做。
CreateFolderAsync(String)	在 [下載] 資料夾中建立新的子資料夾。
CreateFolderAsync(String, CreationCollisionOption)	在 [下載] 資料夾中建立新的子資料夾，並指定如果 [下載] 資料夾中已有相同名稱的子資料夾，該怎麼做。
CreateFolderForUserAsync(User, String)	在特定 使用者的[下載] 資料夾內建立新的子資料夾。
CreateFolderForUserAsync(User, String, CreationCollisionOption)	在特定 使用者的[下載] 資料夾中建立新的子資料夾，並指定如果 [下載] 資料夾中已有相同名稱的子資料夾，該怎麼做。