ApplicationData.GetPublisherCacheFolder(String) 메서드

정의

네임스페이스:

Windows.Storage

현재 앱의 게시자에 대한 공유 스토리지 폴더의 지정된 하위 폴더를 가져옵니다.

public:
 virtual StorageFolder ^ GetPublisherCacheFolder(Platform::String ^ folderName) = GetPublisherCacheFolder;

StorageFolder GetPublisherCacheFolder(winrt::hstring const& folderName);

public StorageFolder GetPublisherCacheFolder(string folderName);

function getPublisherCacheFolder(folderName)

Public Function GetPublisherCacheFolder (folderName As String) As StorageFolder

매개 변수

folderName

String

Platform::String

winrt::hstring

현재 앱의 게시자에 대한 공유 스토리지 폴더에서 가져올 하위 폴더입니다.

반환

StorageFolder

지정된 하위 폴더입니다.

설명

Windows 런타임 앱의 강력한 보안 모델은 일반적으로 앱이 자체적으로 데이터를 공유하는 것을 방지합니다. 그러나 동일한 게시자의 앱이 사용자별로 파일 및 설정을 공유하는 것이 유용할 수 있습니다. 앱 게시자는 앱 매니페스트에 확장을 추가하여 게시하는 다른 앱과 스토리지 폴더를 공유하도록 앱을 등록할 수 있습니다.

다음은 여러 앱을 게시하는 경우 이 공유 스토리지 폴더를 사용하는 방법의 몇 가지 예입니다.

• 파일을 공유합니다. 예를 들어 여러 앱이 동일한 이미지 또는 동일한 사용자 지정 글꼴을 사용하는 경우 이러한 파일을 공유 스토리지 폴더에 저장할 수 있습니다.
• 사용자 지정 설정 파일에서 사용자의 설정을 공유합니다. 예를 들어 여러 앱이 온도를 사용하는 경우 공유 스토리지 폴더의 사용자 지정 설정 파일에 섭씨 또는 화씨에 대한 사용자의 기본 설정 복사본을 저장할 수 있습니다. 그러나 사용자가 공유 스토리지 폴더의 내용을 지울 수 있으므로 각 앱 또는 다른 master 위치에 사용자의 설정을 저장하는 것이 좋습니다. 사용자가 게시자에서 첫 번째 앱을 설치하면 앱 게시자의 공유 스토리지 폴더가 자동으로 프로비전됩니다.

공유 스토리지 폴더에는 다음과 같은 요구 사항 및 제한이 있습니다.

• 공유 스토리지 폴더의 데이터는 백업되거나 로밍되지 않습니다. 또한 사용자는 공유 스토리지 폴더의 내용을 지울 수 있습니다.
• 이 기능을 사용하여 다른 게시자의 앱 간에 데이터를 공유할 수 없습니다.
• 이 기능을 사용하여 다른 사용자 간에 데이터를 공유할 수 없습니다.
• 공유 스토리지 폴더에는 버전 관리가 없습니다.

게시자의 공유 스토리지 폴더를 사용하도록 앱을 등록하려면

하위 폴더를 등록하기 위해 앱 매니페스트에서 다음 예제와 유사한 XML을 수동으로 입력합니다. 이러한 하위 폴더를 만들 필요가 없습니다. 자동으로 프로비전됩니다.

<Package>
    …
    <Extensions>
        …
        <Extension Category="windows.publisherCacheFolders">
            <PublisherCacheFolders>
                <Folder Name="Folder1"/>
                <Folder Name="Folder2"/>
            </PublisherCacheFolders>
        </Extension>
        …
    </Extensions>
    …
</Package>

게시자의 공유 스토리지 폴더에 있는 데이터에 액세스하려면

GetPublisherCacheFolder 메서드를 호출하여 공유 스토리지 폴더에서 등록된 하위 폴더 중 하나를 가져옵니다.

그런 다음 StorageFolder 클래스의 속성과 메서드를 사용하여 공유 폴더에서 파일 및 하위 폴더를 읽고 씁니다.

공유 스토리지 폴더에 대한 액세스에는 다음과 같은 요구 사항 및 제한이 있습니다.

• 기본 하위 폴더가 없습니다. GetPublisherCacheFolder 메서드를 호출할 때 하위 폴더를 지정해야 합니다.
• 앱 매니페스트에 등록된 하위 폴더에만 액세스할 수 있습니다.
• 공유 스토리지 폴더의 루트에 액세스할 수 없습니다.

게시자의 공유 스토리지 폴더에서 데이터를 클린

ClearPublisherCacheFolderAsync 메서드를 호출하여 현재 앱의 게시자에 대한 공유 스토리지 폴더의 지정된 하위 폴더에서 파일 및 하위 폴더를 지웁니다.

게시자의 마지막 앱이 제거되면 공유 스토리지 폴더가 자동으로 정리됩니다.

공유 스토리지 폴더에 저장된 데이터는 저장한 앱에 연결되지 않습니다. 데이터를 저장한 앱을 제거하면 동일한 게시자의 마지막 앱이 제거될 때까지 데이터가 공유 스토리지 폴더에 유지됩니다.

추가 정보

• ClearPublisherCacheFolderAsync(String)