MusicProperties Class

Definition

public ref class MusicProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class MusicProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class MusicProperties

Public NotInheritable Class MusicProperties

Inheritance

Object Platform::Object IInspectable MusicProperties

Attributes

ContractVersionAttribute

Implements

IStorageItemExtraProperties

Windows requirements

Examples

This example demonstrates how to retrieve properties of a file, including music properties like Album and Rating.

try
{
    StorageFile file = rootPage.sampleFile;
    if (file != null)
    {
        StringBuilder outputText = new StringBuilder();

        // Get music properties
        MusicProperties musicProperties = await file.Properties.GetMusicPropertiesAsync();
        outputText.AppendLine("Album: " + musicProperties.Album);
        outputText.AppendLine("Rating: " + musicProperties.Rating);
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
 // For example, handle a file not found error
}

After GetMusicPropertiesAsync completes, musicProperties gets a MusicProperties object.

In the example, file contains a StorageFile that represents the file to retrieve properties for.

Remarks

You can access a MusicProperties object asynchronously using the GetMusicPropertiesAsync method from the Properties property of an item (like a file of folder), or synchronously using the MusicProperties property if it is available. You can get a musicProperties object using any of the following methods and properties:

• StorageItemContentProperties.GetMusicPropertiesAsync method, which can be accessed using the Properties property, if it is available.
• FileInformation.MusicProperties property
• FolderInformation.MusicProperties property

For more code samples about accessing properties, see the File access sample.

Properties

Methods

Applies to

See also

• GetMusicPropertiesAsync()
• MusicProperties
• MusicProperties
• MusicProperties