KnownFolders 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
사용자 콘텐츠를 포함하는 일반적인 위치에 대한 액세스를 제공합니다. 여기에는 사용자의 로컬 라이브러리(예: 문서, 사진, 음악 및 비디오), 홈 그룹, 이동식 디바이스 및 미디어 서버 디바이스의 콘텐츠가 포함됩니다.
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 KnownFoldersPublic Class 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.Storage.ApplicationData.Current.LocalFolder 속성에서 앱의 로컬 폴더를 가져옵니다.
- Windows.ApplicationModel.Package.Current.InstalledLocation 속성에서 앱의 설치 폴더를 가져옵니다.
앱에서 액세스할 수 있는 위치에 대한 자세한 내용은 파일 액세스 권한을 참조하세요.
버전 기록
| 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에 대한 액세스를 요청합니다. |