Windows App SDK가 포함된 파일, 폴더 및 라이브러리

패키지된 Windows 앱 SDK 앱은 Windows.Storage, Windows.Storage.Streams 및 Windows.Storage.Pickers 네임스페이스에서 제공하는 강력한 API를 활용하여 효율적으로 파일의 다양한 데이터 서식을 읽고 쓸 수 있을 뿐만 아니라 파일과 폴더를 관리할 수도 있습니다. 이 섹션에서는 앱 설정 읽기 및 쓰기, 파일 및 폴더 선택기, 동영상/음악 라이브러리와 같은 특수 샌드박스 위치 액세스와 같은 필수 항목을 다룹니다. Windows 앱 SDK를 사용하여 앱의 파일 관리 기능을 최적화하는 방법을 알아봅니다.

Windows 10 이상의 OS 릴리스는 파일, 폴더, 라이브러리 및 앱 설정과 관련된 다양한 API를 제공합니다. 이러한 기능은 Windows SDK와 .NET SDK에서 제공하는 WinRT 및 .NET API의 조합을 통해 사용할 수 있습니다.

WinRT 스토리지 API를 사용하여 데이터 읽기 및 쓰기

패키지된 앱은 UWP 앱에서 사용할 수 있는 모든 WinRT 스토리지 API에 액세스할 수 있습니다. 기존 UWP 앱을 마이그레이션하거나 새 앱을 만드는 경우 이러한 API를 사용하여 데이터를 읽고 쓸 수 있습니다. WinUI 앱에서 스토리지 API를 사용하는 예는 Windows 앱 SDK 및 WinRT API를 사용하여 파일 및 폴더에 액세스를 참조하세요.

.NET 파일 API를 사용하여 데이터 읽기 및 쓰기

WinRT API 외에도 패키지 앱은 System.IO 네임스페이스의 .NET API를 사용하여 데이터를 읽고 쓸 수 있습니다. 새 WinUI 3 프로젝트가 만들어지면 해당 Package.appxmanifest 파일에 다음 설정이 포함됩니다.

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
</Capabilities>

이 제한된 기능을 선언하면 파일 시스템, 레지스트리 및 기타 제한된 기능에 대한 모든 권한이 제공됩니다. 자세한 내용은 제한된 기능 선언을 참조하세요. 즉, 앱은 .NET 파일 API를 사용할 때 다른 .NET 데스크톱 앱과 동일한 파일 시스템에 대한 액세스 권한을 갖습니다.

WinUI 앱에서 .NET API를 사용하는 예는 Windows 앱 SDK 및 .NET API를 사용하여 파일 및 폴더에 액세스를 참조하세요.

파일 및 폴더 작업을 위한 추가 리소스

패키지된 WinUI 앱을 개발하는 경우 WinRT 스토리지 API는 데이터를 읽고 쓰기 위한 강력한 도구가 될 수 있습니다. 다음 UWP 항목은 앱에서 이러한 API를 활용하려는 개발자에게 풍부한 정보를 제공합니다.

토픽	설명
파일과 폴더 열거 및 쿼리	폴더, 라이브러리, 디바이스 또는 네트워크 위치에 있는 파일과 폴더에 액세스합니다. 파일 및 폴더 쿼리를 구성하여 특정 위치의 파일 및 폴더를 쿼리할 수도 있습니다.
파일 만들기, 쓰기 및 읽기	StorageFile 개체를 사용하여 파일을 읽고 씁니다.
파일 쓰기 모범 사례	FileIO 및 PathIO 클래스의 다양한 파일 쓰기 메서드를 사용하는 모범 사례에 대해 알아봅니다.
파일 속성 가져오기	StorageFile 개체로 표시되는 파일의 최상위, 기본 및 확장 속성을 가져옵니다.
선택기를 사용하여 파일 및 폴더 열기	사용자가 선택기를 조작할 수 있도록 하여 파일 및 폴더에 액세스합니다. FolderPicker를 사용하여 폴더에 액세스할 수 있습니다. 참고:데스크톱 앱(WinUI 3 앱 포함)에서는 Windows.Storage.Pickers의 파일 및 폴더 선택기를 사용할 수 있습니다. 그러나 데스크톱 앱을 실행하기 위해 권한 상승이 필요한 경우 이러한 API는 관리자 권한 앱에서 사용하도록 설계되지 않았기 때문에 다른 접근 방식이 필요합니다. 예제는 FileSavePicker을 참조하세요.
선택기를 사용하여 파일 저장	사용자가 앱에서 파일을 저장할 이름과 위치를 지정할 수 있도록 하려면 FileSavePicker를 사용합니다.
홈 그룹 콘텐츠 액세스	사진, 음악, 동영상 등 사용자의 홈 그룹 폴더에 저장된 콘텐츠에 액세스합니다.
Microsoft OneDrive 파일의 가용성 확인	StorageFile.IsAvailable 속성을 사용하여 Microsoft OneDrive 파일을 사용할 수 있는지 확인합니다.
음악, 사진 및 비디오 라이브러리의 파일 및 폴더	기존 음악, 사진, 동영상 폴더를 해당 라이브러리에 추가합니다. 라이브러리의 폴더를 제거하고, 라이브러리의 폴더 목록을 가져오고, 저장된 사진, 음악 및 동영상을 검색할 수도 있습니다.
최근에 사용한 파일 및 폴더 추적	사용자가 자주 액세스하는 파일을 앱의 MRU(가장 최근에 사용한 목록)에 추가하여 추적합니다. 플랫폼은 마지막으로 액세스한 시간을 기준으로 항목을 정렬하고 목록의 25개 항목 제한에 도달하면 가장 오래된 항목을 제거하여 MRU를 관리합니다. 모든 앱에는 자체 MRU가 있습니다.
백그라운드에서 파일 시스템 변경 추적	앱이 실행되고 있지 않은 경우에도 파일 시스템의 변경을 추적합니다.
SD 카드에 액세스	특히 내부 스토리지가 제한된 저가형 모바일 디바이스에서는 옵션인 microSD 카드에 불필요한 데이터를 저장하고 액세스할 수 있습니다.
파일 속성에 대한 빠른 액세스	Windows 런타임 API를 통해 사용할 라이브러리에서 파일 및 해당 속성 목록을 효율적으로 수집합니다.

참고 항목

Windows App SDK 및 WinRT API를 사용하여 파일 및 폴더에 액세스

Windows App SDK 및 .NET API를 사용하여 파일 및 폴더에 액세스

System.IO