MusicProperties クラス

定義

名前空間:

Windows.Storage.FileProperties

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

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

属性

ContractVersionAttribute

実装

IStorageItemExtraProperties

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 オブジェクトは、次のいずれかのメソッドとプロパティを使用して取得できます。

• StorageItemContentProperties.GetMusicPropertiesAsync メソッド。 Properties プロパティを使用してアクセスできます (使用可能な場合)。
• FileInformation.MusicProperties プロパティ
• FolderInformation.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>>)	アイテムに関連付けられている指定したプロパティと値を保存します。

こちらもご覧ください

• GetMusicPropertiesAsync()
• MusicProperties
• MusicProperties
• MusicProperties