다음을 통해 공유


KnownFolders 클래스

정의

사용자 콘텐츠를 포함하는 일반적인 위치에 대한 액세스를 제공합니다. 여기에는 사용자의 로컬 라이브러리(예: 문서, 사진, 음악 및 비디오), 홈 그룹, 이동식 디바이스 및 미디어 서버 디바이스의 콘텐츠가 포함됩니다.

public ref class KnownFolders abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class KnownFolders final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class KnownFolders
Public Class KnownFolders
상속
Object Platform::Object IInspectable KnownFolders
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

파일 액세스 샘플에서는 PicturesLibrary 속성을 사용하여 사진 라이브러리에 새 파일을 만드는 방법을 보여 있습니다.

StorageFolder storageFolder = KnownFolders.PicturesLibrary;
StorageFile file = await storageFolder.CreateFileAsync("sample.png", CreationCollisionOption.ReplaceExisting);
// Do something with the new file.

CreateFileAsync 메서드가 file 완료되면 변수에 새 파일을 나타내는 StorageFile이 포함됩니다.

설명

이 클래스는 정적이며 인스턴스화할 수 없습니다. 다음 예제와 같이 해당 속성에 직접 액세스합니다.

  • StorageFolder storageFolder = KnownFolders.PicturesLibrary;

사전 요구 사항

이 클래스의 속성으로 표시되는 폴더 및 라이브러리에 액세스하려면 앱 매니페스트에서 해당 기능을 지정합니다. 예를 들어 KnownFolders.PicturesLibrary에 액세스하려면 앱 매니페스트에서 그림 라이브러리 기능을 지정합니다. 앱 기능 선언의 기능에 대해 자세히 알아봅니다.

반환 값

KnownFolders 클래스의 속성은 StorageFolder를 반환합니다. 알려진 폴더 및 해당 콘텐츠를 사용하려면 StorageFolder 클래스의 메서드 및 속성을 호출합니다.

추가 정보

일반적으로 사용되는 다른 위치에 액세스하는 방법은 다음과 같습니다.

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

버전 기록

Windows 버전 SDK 버전 추가된 값
1511 10586 GetFolderForUserAsync
2004 19041 GetFolderAsync
2004 19041 RequestAccessAsync
2004 19041 RequestAccessForUserAsync

속성

AppCaptures

앱 캡처 폴더를 가져옵니다.

CameraRoll

카메라 롤 폴더를 가져옵니다.

DocumentsLibrary

문서 라이브러리를 가져옵니다. 문서 라이브러리는 일반적인 용도로 사용되지 않습니다.

HomeGroup

HomeGroup 폴더를 가져옵니다.

MediaServerDevices

미디어 서버(DLNA(Digital Living Network Alliance) 디바이스의 폴더를 가져옵니다.

MusicLibrary

음악 라이브러리를 가져옵니다.

Objects3D

Objects 3D 폴더를 가져옵니다.

PicturesLibrary

그림 라이브러리를 가져옵니다.

Playlists

재생 목록 폴더를 가져옵니다.

RecordedCalls

기록된 호출 폴더를 가져옵니다.

RemovableDevices

이동식 디바이스 폴더를 가져옵니다.

SavedPictures

저장된 그림 폴더를 가져옵니다.

VideosLibrary

비디오 라이브러리를 가져옵니다.

메서드

GetFolderAsync(KnownFolderId)

지정한 folderId의 폴더를 검색합니다.

GetFolderForUserAsync(User, KnownFolderId)

User에 대해 지정된 알려진 폴더를 반환하는 정적 메서드입니다.

RequestAccessAsync(KnownFolderId)

폴더에 대한 액세스를 제어하는 기능에 대한 액세스를 요청합니다.

RequestAccessForUserAsync(User, KnownFolderId)

사용자 및 folderId에 대한 액세스를 요청합니다.

적용 대상

추가 정보