StoreContext 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
현재 앱에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 멤버를 제공합니다. 예를 들어 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보를 얻거나, 앱에서 제공하는 현재 앱 또는 제품을 구매하거나, 앱에 대한 패키지 업데이트를 다운로드하여 설치할 수 있습니다.
데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요.
public ref class StoreContext sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Services.Store.StoreContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class StoreContext final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Services.Store.StoreContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class StoreContextPublic NotInheritable Class StoreContext- 상속
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
|
| API contract |
Windows.Services.Store.StoreContract (v1.0에서 도입되었습니다.)
|
설명
참고
이 클래스와 나머지 Windows.Services.Store 네임스페이스는 Windows 10 버전 1607에서 도입되었습니다. 이 클래스는 Windows 10 Anniversary Edition을 대상으로 하는 프로젝트에서만 사용할 수 있습니다(10.0; Visual Studio에서 빌드 14393) 이상 릴리스 프로젝트가 이전 버전의 Windows 10 대상으로 하는 경우 Windows.Services.Store 네임스페이스 대신 Windows.ApplicationModel.Store 네임스페이스를 사용해야 합니다. 자세한 내용은 앱에서 바로 구매 및 평가판을 참조하세요.
StoreContext 클래스는 Windows.Services.Store 네임스페이스에 대한 기본 진입점입니다. 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보 가져오기, 앱에서 제공하는 현재 앱 또는 추가 기능 구매 또는 앱에 대한 패키지 업데이트 다운로드 및 설치와 같은 작업을 수행합니다. 이 네임스페이스의 다른 클래스 및 형식은 앱에 대한 추가 기능, 앱 라이선스 및 추가 기능, 앱에 대한 Microsoft Store 목록 정보와 같은 항목을 나타냅니다.
StoreContext 개체를 얻으려면 다음 정적 메서드 중 하나를 사용합니다.
GetDefault: 단일 사용자 앱(즉, 앱을 시작한 사용자의 컨텍스트에서만 실행되는 앱)에서 이 메서드를 사용합니다. 이 메서드는 사용자의 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 StoreContext 개체를 가져옵니다. 대부분의 UWP(유니버설 Windows 플랫폼) 앱은 단일 사용자 앱입니다.
Windows.Services.Store.StoreContext context = StoreContext.GetDefault();GetForUser: 다중 사용자 앱에서 이 메서드를 사용합니다. 이 메서드는 특정 사용자에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 StoreContext 개체를 가져옵니다. 다중 사용자 앱에 대한 자세한 내용은 다중 사용자 애플리케이션 소개를 참조하세요.
var users = await Windows.System.User.FindAllAsync(); Windows.Services.Store.StoreContext context = StoreContext.GetForUser(users[0]);
StoreContext 개체가 있으면 메서드를 호출하여 현재 사용자 및 기타 작업에 대한 앱 또는 추가 기능을 구매할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.
- 앱에서 바로 구매 및 평가판
- 앱 및 추가 기능에 대한 제품 정보 가져오기
- 앱 및 추가 기능에 대한 라이선스 정보 가져오기
- 앱에서 바로 앱 및 추가 기능 구매 사용
- 소모성 추가 기능 구매 사용
- 앱의 평가판 구현
StoreContext 개체를 사용하여 앱에 대한 패키지 업데이트를 다운로드하고 설치할 수도 있습니다. 자세한 내용은 앱에 대한 패키지 업데이트 다운로드 및 설치를 참조하세요.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1703 | 15063 | FindStoreProductForPackageAsync |
| 1803 | 17134 | CanAcquireStoreLicenseAsync |
| 1803 | 17134 | CanAcquireStoreLicenseForOptionalPackageAsync |
| 1803 | 17134 | CanSilentlyDownloadStorePackageUpdates |
| 1803 | 17134 | DownloadAndInstallStorePackagesAsync |
| 1803 | 17134 | GetAssociatedStoreQueueItemsAsync |
| 1803 | 17134 | GetStoreProductsAsync(IEnumerable<String,IEnumerable<> String,StoreProductOptions>) |
| 1803 | 17134 | GetStoreQueueItemsAsync |
| 1803 | 17134 | RequestDownloadAndInstallStorePackagesAsync(IEnumerable<String,StorePackageInstallOptions>) |
| 1803 | 17134 | RequestUninstallStorePackageAsync |
| 1803 | 17134 | RequestUninstallStorePackageByStoreIdAsync |
| 1803 | 17134 | TrySilentDownloadAndInstallStorePackageUpdatesAsync |
| 1803 | 17134 | TrySilentDownloadStorePackageUpdatesAsync |
| 1803 | 17134 | UninstallStorePackageAsync |
| 1803 | 17134 | UninstallStorePackageByStoreIdAsync |
| 1809 | 17763 | RequestRateAndReviewAppAsync |
| 1809 | 17763 | SetInstallOrderForAssociatedStoreQueueItemsAsync |
속성
| CanSilentlyDownloadStorePackageUpdates |
사용자에게 알림 UI를 표시하지 않고 현재 앱의 패키지 업데이트를 다운로드할 수 있는지 여부를 나타내는 값을 가져옵니다. |
| User |
다중 사용자 앱에서 현재 StoreContext 개체와 연결된 사용자에 대한 정보를 가져옵니다. |
메서드
| AcquireStoreLicenseForOptionalPackageAsync(Package) |
현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 추가 기능 패키지에 대한 라이선스를 획득합니다. |
| CanAcquireStoreLicenseAsync(String) |
현재 사용자에 대해 현재 앱의 지정된 DLC(다운로드 가능한 콘텐츠) 추가 기능에 대해 라이선스를 획득할 수 있는지 여부를 나타내는 값을 가져옵니다. |
| CanAcquireStoreLicenseForOptionalPackageAsync(Package) |
현재 사용자에 대해 현재 앱의 지정된 다운로드 가능한 콘텐츠(DLC) 패키지에 대해 라이선스를 획득할 수 있는지 여부를 나타내는 값을 가져옵니다. |
| DownloadAndInstallStorePackagesAsync(IIterable<String>) |
사용자에게 알림 UI 대화 상자를 표시하지 않고 Microsoft Store에서 현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 패키지를 다운로드하고 설치합니다. |
| FindStoreProductForPackageAsync(IIterable<String>, Package) |
지정된 패키지와 연결된 앱 또는 추가 기능에 대한 스토어 제품 세부 정보를 가져옵니다. |
| GetAppAndOptionalStorePackageUpdatesAsync() |
앱에 대한 선택적 패키지를 포함하여 Microsoft Store에서 다운로드할 수 있는 업데이트가 있는 현재 앱의 패키지 컬렉션을 가져옵니다. |
| GetAppLicenseAsync() |
현재 앱의 추가 기능에 대한 라이선스를 포함하여 현재 앱에 대한 라이선스 정보를 가져옵니다. |
| GetAssociatedStoreProductsAsync(IIterable<String>) |
현재 앱 내에서 구매할 수 있는 제품에 대한 Microsoft Store 목록 정보를 가져옵니다. |
| GetAssociatedStoreProductsByInAppOfferTokenAsync(IIterable<String>) |
현재 앱에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 멤버를 제공합니다. 예를 들어 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보를 얻거나, 앱에서 제공하는 현재 앱 또는 제품을 구매하거나, 앱에 대한 패키지 업데이트를 다운로드하여 설치할 수 있습니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요. |
| GetAssociatedStoreProductsWithPagingAsync(IIterable<String>, UInt32) |
현재 앱 내에서 구매할 수 있는 제품에 대한 Microsoft Store 목록 정보를 가져옵니다. 이 메서드는 페이징을 지원하여 결과를 반환합니다. |
| GetAssociatedStoreQueueItemsAsync() |
현재 앱의 다운로드 및 설치 큐에 있는 모든 새 패키지 또는 업데이트된 패키지에 대한 정보를 가져옵니다. |
| GetConsumableBalanceRemainingAsync(String) |
현재 앱에 대해 지정된 소모성 추가 기능에 대한 나머지 잔액을 가져옵니다. |
| GetCustomerCollectionsIdAsync(String, String) |
제품 자격을 쿼리하거나 현재 사용자가 소유한 제품 자격을 사용하는 데 사용할 수 있는 Microsoft Store ID 키를 검색합니다. |
| GetCustomerPurchaseIdAsync(String, String) |
현재 사용자를 대신하여 무료 제품에 대한 권한을 부여하는 데 사용할 수 있는 Microsoft Store ID 키를 검색합니다. |
| GetDefault() |
현재 앱의 컨텍스트에서 현재 사용자의 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 StoreContext 개체를 가져옵니다. |
| GetForUser(User) |
현재 앱의 컨텍스트에서 지정된 사용자의 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 StoreContext 개체를 가져옵니다. |
| GetStoreProductForCurrentAppAsync() |
현재 앱에 대한 Microsoft Store 목록 정보를 가져오고 현재 사용자에 대한 앱을 구입하는 데 사용할 수 있는 방법에 대한 액세스를 제공합니다. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>) |
현재 앱과 연결된 지정된 제품에 대한 Microsoft Store 목록 정보를 가져옵니다. |
| GetStoreProductsAsync(IIterable<String>, IIterable<String>, StoreProductOptions) |
쿼리에 필터를 사용하는 옵션과 함께 현재 앱과 연결된 지정된 제품에 대한 Microsoft Store 목록 정보를 가져옵니다. |
| GetStoreQueueItemsAsync(IIterable<String>) |
현재 앱의 다운로드 및 설치 큐에 있는 지정된 새 패키지 또는 업데이트된 패키지에 대한 정보를 가져옵니다. |
| GetUserCollectionAsync(IIterable<String>) |
사용자가 구매한 현재 앱의 추가 기능에 대한 Microsoft Store 정보를 가져옵니다. |
| GetUserCollectionWithPagingAsync(IIterable<String>, UInt32) |
사용자가 구매한 현재 앱의 추가 기능에 대한 Microsoft Store 정보를 가져옵니다. 이 메서드는 페이징을 지원하여 결과를 반환합니다. |
| GetUserPurchaseHistoryAsync(IIterable<String>) |
현재 앱에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 멤버를 제공합니다. 예를 들어 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보를 얻거나, 앱에서 제공하는 현재 앱 또는 제품을 구매하거나, 앱에 대한 패키지 업데이트를 다운로드하여 설치할 수 있습니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요. |
| ReportConsumableFulfillmentAsync(String, UInt32, Guid) |
Microsoft Store에서 처리된 현재 앱에 대한 소모성 추가 기능을 보고합니다. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Microsoft Store에서 현재 앱에 대해 지정된 다운로드 가능한 콘텐츠(DLC) 패키지를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
지정된 설치 옵션을 사용하여 Microsoft Store에서 현재 앱에 대해 지정된 다운로드 가능한 콘텐츠(DLC) 패키지를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다. |
| RequestDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Microsoft Store에서 현재 앱에 대해 지정된 패키지 업데이트를 다운로드하여 설치하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다. |
| RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
Microsoft Store에서 현재 앱에 대해 지정된 패키지 업데이트를 다운로드하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다. |
| RequestPurchaseAsync(String) |
지정된 앱 또는 추가 기능에 대한 구매를 요청하고 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI를 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다. |
| RequestPurchaseAsync(String, StorePurchaseProperties) |
지정된 앱 또는 추가 기능에 대한 구매를 요청하고 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI를 표시합니다. 이 메서드는 구매 중에 사용자에게 표시할 제품 이름을 포함하여 Microsoft Store의 단일 목록으로 표시되는 제품의 큰 카탈로그 내에서 특정 제품에 대한 추가 세부 정보를 지정하는 옵션을 제공합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다. |
| RequestPurchaseByInAppOfferTokenAsync(String) |
현재 앱에 대한 Microsoft Store 관련 데이터에 액세스하고 관리하는 데 사용할 수 있는 멤버를 제공합니다. 예를 들어 이 클래스의 멤버를 사용하여 현재 앱에 대한 Microsoft Store 목록 및 라이선스 정보를 얻거나, 앱에서 제공하는 현재 앱 또는 제품을 구매하거나, 앱에 대한 패키지 업데이트를 다운로드하여 설치할 수 있습니다. 데스크톱 앱에서 UI를 표시하는 방식으로 이 클래스의 instance 사용하기 전에 개체를 소유자의 창 핸들과 연결해야 합니다. 자세한 정보 및 코드 예제는 CoreWindow에 의존하는 WinRT UI 개체 표시를 참조하세요. |
| RequestRateAndReviewAppAsync() |
사용자에게 앱을 평가하고 검토하도록 요청합니다. 이 메서드는 사용자가 스토어 등급을 선택하고 제품에 대한 선택적 스토어 검토를 추가할 수 있는 UI를 표시합니다. 중요 UI 스레드에서 이 메서드를 호출해야 합니다. |
| RequestUninstallStorePackageAsync(Package) |
현재 앱에 대해 지정된 선택적 패키지를 제거하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. |
| RequestUninstallStorePackageByStoreIdAsync(String) |
현재 앱에 대해 지정된 다운로드 가능한 콘텐츠(DLC) 패키지를 제거하려고 시도합니다. 이 메서드는 작업에 대한 권한을 요청하는 UI 대화 상자도 표시합니다. |
| SetInstallOrderForAssociatedStoreQueueItemsAsync(IIterable<StoreQueueItem>) |
현재 앱의 다운로드 및 설치 큐에 지정된 패키지를 설치할 순서를 설정합니다. |
| TrySilentDownloadAndInstallStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
사용자에게 알림 UI를 표시하지 않고 Microsoft Store에서 현재 앱에 대해 지정된 패키지 업데이트를 다운로드하여 설치하려고 시도합니다. |
| TrySilentDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate>) |
사용자에게 알림 UI를 표시하지 않고 Microsoft Store에서 현재 앱에 대해 지정된 패키지 업데이트를 다운로드하려고 시도합니다. |
| UninstallStorePackageAsync(Package) |
사용자에게 알림 UI 대화 상자를 표시하지 않고 현재 앱에 대해 지정된 선택적 패키지를 제거합니다. |
| UninstallStorePackageByStoreIdAsync(String) |
사용자에게 알림 UI 대화 상자를 표시하지 않고 현재 앱에 대해 지정된 DLC(다운로드 가능한 콘텐츠) 패키지를 제거합니다. |
이벤트
| OfflineLicensesChanged |
앱 라이선스의 상태 변경될 때 발생합니다(예: 평가 기간이 만료되었거나 사용자가 앱의 전체 버전을 구매한 경우). |