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로 가져옵니다.

설명

이 클래스는 정적이며 인스턴스화할 수 없습니다. 대신 메서드를 직접 호출합니다.

다운로드 폴더의 파일 및 폴더 권한

모든 앱은 Downloads 폴더에 파일 및 폴더를 만들 수 있으며 자신이 만든 파일에 액세스할 수 있습니다. 그러나 앱은 만들지 않은 다운로드 폴더의 파일에 액세스할 수 없습니다.

앱이 다운로드 폴더에 파일을 만들 때 사용자가 다른 앱에 명시적으로 액세스 권한을 부여하지 않는 한 다른 앱은 파일을 방해하거나 액세스할 수 없습니다. 사용자는 파일 선택기에서 파일을 선택하여 다른 앱에 파일에 대한 액세스 권한을 부여할 수 있습니다. 앱은 파일 선택기를 사용하여 만들지 않은 다운로드 폴더의 파일에 액세스할 수도 있습니다. 선택기를 사용하여 파일 및 폴더 열기에서 파일 선택기를 사용하여 파일을 여는 방법에 대해 자세히 알아봅니다.

다운로드 폴더에서 파일을 만들거나 액세스하는 데는 기능이 필요하지 않습니다. 앱 기능 선언의 기능에 대해 자세히 알아봅니다.

앱에서 액세스할 수 있는 위치에 대한 자세한 내용은 파일 액세스 권한을 참조하세요.

버전 기록

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)	Downloads 폴더에 새 파일을 만들고 이름이 같은 파일이 다운로드 폴더에 이미 있는 경우 수행할 작업을 지정합니다.
CreateFileForUserAsync(User, String)	특정 사용자의 다운로드 폴더 내에 새 파일을 만듭니다.
CreateFileForUserAsync(User, String, CreationCollisionOption)	특정 사용자의 다운로드 폴더에 새 파일을 만들고 이름이 같은 파일이 Downloads 폴더에 이미 있는 경우 수행할 작업을 지정합니다.
CreateFolderAsync(String)	다운로드 폴더에 새 하위 폴더를 만듭니다.
CreateFolderAsync(String, CreationCollisionOption)	Downloads 폴더에 새 하위 폴더를 만들고 이름이 같은 하위 폴더가 Downloads 폴더에 이미 있는 경우 수행할 작업을 지정합니다.
CreateFolderForUserAsync(User, String)	특정 사용자의 다운로드 폴더 내에 새 하위 폴더를 만듭니다.
CreateFolderForUserAsync(User, String, CreationCollisionOption)	특정 사용자의 다운로드 폴더에 새 하위 폴더를 만들고 이름이 같은 하위 폴더가 Downloads 폴더에 이미 있는 경우 수행할 작업을 지정합니다.