ListingInformation ListingInformation ListingInformation ListingInformation Class

Definition

Provides the listing info that describes the app in the Windows Store.

public : sealed class ListingInformation : IListingInformation, IListingInformation2public sealed class ListingInformation : IListingInformation, IListingInformation2Public NotInheritable Class ListingInformation Implements IListingInformation, IListingInformation2// You can use this class in JavaScript.
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Examples

This code example shows how to get the ListingInformation from simulated app data and then get the ProductListing object for one of the features offered by the app.

// get current app object using the simulator interface
currentApp = Windows.ApplicationModel.Store.CurrentAppSimulator;

// get the listing information for the products this app supports
currentApp.loadListingInformationAsync().then(
    function (listing) {
        // loadListingInformationAsync returns the ListingInformation object in listing.
        // get one of the listing properties
        thisAppsPrice = listing.formattedPrice;
    }
);
// get the license info for this app from the simulator
ListingInformation listing = await CurrentAppSimulator.LoadListingInformationAsync();

// get the price of the app from the listing info.
String thisAppsPrice = listing.FormattedPrice;

Remarks

The info that this object returns comes from the listing info you enter when you submit the app to the Windows Store.

You access this object through the LoadListingInformationAsync method of the CurrentAppSimulator object during testing, or the LoadListingInformationAsync method of the CurrentApp object when the app is distributed through the Windows Store.

Note

The CurrentApp object obtains its data from the Windows Store, so you must have a Windows Store developer account and the app must be published in the Windows Store. If you don't have a Windows Store developer account, you can test the functions of this class by using the CurrentAppSimulator.

Properties

AgeRating AgeRating AgeRating AgeRating

Gets the age rating for the app.

public : unsigned int AgeRating { get; }public uint AgeRating { get; }Public ReadOnly Property AgeRating As uint// You can use this property in JavaScript.
Value
unsigned int uint uint uint

The age rating.

See Also

CurrencyCode CurrencyCode CurrencyCode CurrencyCode

Gets the currency code associated with the user's market, such as USD or CAD.

public : PlatForm::String CurrencyCode { get; }public string CurrencyCode { get; }Public ReadOnly Property CurrencyCode As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The currency code associated with the user's market, such as USD or CAD.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v2)

Remarks

The currency code string returned by this property conforms to ISO 4217.

CurrentMarket CurrentMarket CurrentMarket CurrentMarket

Gets the country code associated with the user's location, such as US or CA, that is used to identify their market for transactions in the current session.

public : PlatForm::String CurrentMarket { get; }public string CurrentMarket { get; }Public ReadOnly Property CurrentMarket As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The country code associated with the user's location, such as US or CA.

Description Description Description Description

Gets the app's description in the current market.

public : PlatForm::String Description { get; }public string Description { get; }Public ReadOnly Property Description As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The app's description in the current market.

FormattedBasePrice FormattedBasePrice FormattedBasePrice FormattedBasePrice

Gets the app's base price formatted for the current market and currency.

public : PlatForm::String FormattedBasePrice { get; }public string FormattedBasePrice { get; }Public ReadOnly Property FormattedBasePrice As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The app's base price with the appropriate formatting for the current market and currency.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v2)

Remarks

The base price is the default price for the app. If the app is on sale in the current market, use the FormattedPrice property to get the sale price. If the app is not on sale, FormattedBasePrice and FormattedPrice return the same value.

See Also

FormattedPrice FormattedPrice FormattedPrice FormattedPrice

Gets the app's purchase price formatted for the current market and currency.

public : PlatForm::String FormattedPrice { get; }public string FormattedPrice { get; }Public ReadOnly Property FormattedPrice As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The app's purchase price with the appropriate formatting for the current market and currency.

Remarks

If the app is on sale in the current market, the FormattedPrice property returns the sale price. Use the FormattedBasePrice property to get the default price. If the app is not on sale, FormattedBasePrice and FormattedPrice return the same value.

See Also

IsOnSale IsOnSale IsOnSale IsOnSale

Gets a value that indicates whether the app is on sale.

public : PlatForm::Boolean IsOnSale { get; }public bool IsOnSale { get; }Public ReadOnly Property IsOnSale As bool// You can use this property in JavaScript.
Value
PlatForm::Boolean bool bool bool

Returns true if the app is on sale, and otherwise false.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v2)

Remarks

For information about putting apps on sale, see Put apps and add-ons on sale.

See Also

Name Name Name Name

Gets the app's name in the current market.

public : PlatForm::String Name { get; }public string Name { get; }Public ReadOnly Property Name As string// You can use this property in JavaScript.
Value
PlatForm::String string string string

The app's name in the current market.

ProductListings ProductListings ProductListings ProductListings

Gets information about add-ons (also called in-app products or IAPs) available for purchase.

public : IMapView<string, ProductListing> ProductListings { get; }public IReadOnlyDictionary<string, ProductListing> ProductListings { get; }Public ReadOnly Property ProductListings As IReadOnlyDictionary<string, ProductListing>// You can use this property in JavaScript.
Value
IMapView<PlatForm::String, ProductListing> IReadOnlyDictionary<string, ProductListing> IReadOnlyDictionary<string, ProductListing> IReadOnlyDictionary<string, ProductListing>

The array of ProductListing objects that describes the app's add-ons.

SaleEndDate SaleEndDate SaleEndDate SaleEndDate

Gets the end date of the sale period for the app.

public : DateTime SaleEndDate { get; }public DateTimeOffset SaleEndDate { get; }Public ReadOnly Property SaleEndDate As DateTimeOffset// You can use this property in JavaScript.
Value
DateTime DateTimeOffset DateTimeOffset DateTimeOffset

The date and time that the app's sale period will end.

Additional features and requirements
Device family
Windows 10 (introduced v10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v2)
See Also

See Also