MusicProperties クラス

定義

項目の音楽関連のプロパティ (ファイルやフォルダーなど) へのアクセスを提供します。

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
継承
Object Platform::Object IInspectable MusicProperties
属性
実装

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

この例では、 アルバム評価などの音楽プロパティを含むファイルのプロパティを取得する方法を示します。

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
}

GetMusicPropertiesAsync が完了したら、 musicProperties MusicProperties オブジェクトを取得します。

この例では、 には、 file プロパティを取得するファイルを表す StorageFile が含まれています。

注釈

MusicProperties オブジェクトには、アイテムの Properties プロパティ (フォルダーのファイルなど) から GetMusicPropertiesAsync メソッドを使用して非同期的にアクセスするか、MusicProperties プロパティが使用可能な場合は同期的に使用できます。 musicProperties オブジェクトは、次のいずれかのメソッドとプロパティを使用して取得できます。

注意

別のアプリ (Microsoft Word など) によって定義されたプロパティ ハンドラーを使用して取得または設定されたプロパティにアクセスできない場合があります。 代わりに、システム インデックスによってサポートされるファイル クエリを使用して、これらのプロパティを取得できます。 詳細については、「 QueryOptions」を参照してください。

プロパティへのアクセスに関するコード サンプルの詳細については、「 ファイル アクセスのサンプル」を参照してください。

プロパティ

Album

曲を含むアルバムの名前を取得または設定します。

AlbumArtist

曲のアルバム アーティストの名前を取得または設定します。

Artist

曲に貢献したアーティストを取得します。

Bitrate

曲ファイルのビット レートを取得します。

Composers

曲の作曲家を取得します。

Conductors

曲の指揮者を取得します。

Duration

曲の継続時間をミリ秒単位で取得します。

Genre

曲が属する音楽ジャンルの名前を取得します。

Producers

曲のプロデューサーを取得します。

Publisher

曲の発行元を取得または設定します。

Rating

音楽ファイルに関連付けられている評価を取得または設定します。

Subtitle

曲のサブタイトルを取得または設定します。

Title

曲のタイトルを取得または設定します

TrackNumber

曲のアルバムの曲のトラック番号を取得または設定します。

Writers

ソングライターを取得します。

Year

曲がリリースされた年を取得または設定します。

メソッド

RetrievePropertiesAsync(IIterable<String>)

アイテムに関連付けられている指定された音楽関連の Windows ファイル プロパティを取得します。

SavePropertiesAsync()

アイテムに関連付けられているすべてのプロパティを保存します。

SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

アイテムに関連付けられている指定したプロパティと値を保存します。

適用対象

こちらもご覧ください