빠른 시작: 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 속성의 값을 보여 줍니다.

다음 단계에서는 파일이 현재 사용 가능한지를 확인하는 방법을 설명합니다.

1. 적합한 라이브러리 액세스 기능을 정의합니다. 열거되는 라이브러리에 따라 해당 라이브러리에 액세스하는 기능을 정의해야 합니다. 이 단계 및 Microsoft Visual Studio 프로젝트에 대해 다른 파일 수준 기능을 정의하는 방법에 대한 자세한 내용은 Windows 스토어 앱의 파일 액세스 및 사용 권한을 참조하세요.
2. 소속 파일이 열거될 폴더를 나타내는 StorageFolder 개체를 가져옵니다. Windows.Storage.KnownFolders.picturesLibrary와 같은 Windows.Storage.KnownFolders 정적 속성 중 하나를 참조하면 됩니다.
3. StorageFolder.getFilesAsync 메서드를 호출하여 관련 폴더의 모든 파일을 검색합니다.
4. 반환된 파일 컬렉션에서 반복되며 각 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 파일의 사용 가능 여부를 프로그래밍 방식으로 확인하는 방법에 대해 알아보았습니다.