빠른 시작: Microsoft OneDrive 파일의 가용성 확인(HTML)
[ 이 문서는 Windows 런타임 앱을 작성하는 Windows에서 8.x 및 Windows Phone 8.x 개발자를 대상으로 합니다. Windows 10용으로 개발하는 경우에는 최신 설명서를 참조하세요.]
StorageFile.isAvailable 속성을 사용하여 OneDrive 파일의 사용 가능 여부를 확인합니다.
사전 요구 사항
폴더 및 파일을 조작하는 데 사용되는 대부분의 메서드는 비동기입니다. 비동기 앱 작성 방법에 대한 자세한 내용은 JavaScript의 비동기 프로그래밍을 참조하세요.
StorageFile.isAvailable 속성 사용
Windows 8.1에서 사용자는 OneDrive 파일을 '오프라인 사용 가능'(기본값) 또는 '온라인만'으로 표시할 수 있습니다. 이 기능을 통해 사용자는 큰 파일(예: 사진과 동영상)을 OneDrive로 이동하고 '온라인만'으로 표시하여 디스크 공간을 절약할 수 있습니다(원격 파일에 대한 메타데이터만 포함하는 파일이 로컬에 보관됨).
파일을 현재 사용할 수 있는지 확인하기 위해 새로운 속성( StorageFile.isAvailable)이 사용됩니다. 다음 표는 다양한 시나리오에서 StorageFile.isAvailable 속성의 값을 보여 줍니다.
| 파일 형식 | 온라인 | 데이터 통신 연결 네트워크 | 오프라인 |
|---|---|---|---|
| 로컬 파일 | True | True | True |
| 오프라인 사용 가능으로 표시된 OneDrive 파일 | True | True | True |
| 온라인만으로 표시된 OneDrive 파일 | True | 사용자 설정 기반 | False |
| 네트워크 파일 | True | 사용자 설정 기반 | False |
다음 단계에서는 파일이 현재 사용 가능한지를 확인하는 방법을 설명합니다.
- 적합한 라이브러리 액세스 기능을 정의합니다. 열거되는 라이브러리에 따라 해당 라이브러리에 액세스하는 기능을 정의해야 합니다. 이 단계 및 Microsoft Visual Studio 프로젝트에 대해 다른 파일 수준 기능을 정의하는 방법에 대한 자세한 내용은 Windows 스토어 앱의 파일 액세스 및 사용 권한을 참조하세요.
- 소속 파일이 열거될 폴더를 나타내는 StorageFolder 개체를 가져옵니다. Windows.Storage.KnownFolders.picturesLibrary와 같은 Windows.Storage.KnownFolders 정적 속성 중 하나를 참조하면 됩니다.
- StorageFolder.getFilesAsync 메서드를 호출하여 관련 폴더의 모든 파일을 검색합니다.
- 반환된 파일 컬렉션에서 반복되며 각 StorageFile 개체에 대한 isAvailable 속성을 참조합니다.
다음 메서드는 사진 라이브러리를 열거하고 각 파일의 이름, 공급자 이름 및 가용성을 표시합니다.
function OnDisplayAvailabilityClick(mouseEvent) {
var output = document.getElementById("Output");
var library = Windows.Storage.KnownFolders.picturesLibrary;
var outString = "";
library.getFilesAsync().then(function (files) {
files.forEach(function (file) {
outString += file.name + " (on " + file.provider.displayName + ") is " + (file.isAvailable ? "available" : "not available") + "\n";
});
output.innerText = outString;
});
}
요약
이 빠른 시작에서는 OneDrive 파일의 사용 가능 여부를 프로그래밍 방식으로 확인하는 방법에 대해 알아보았습니다.