MusicProperties クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
項目の音楽関連のプロパティ (ファイルやフォルダーなど) へのアクセスを提供します。
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
- 継承
- 属性
- 実装
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>>) |
アイテムに関連付けられている指定したプロパティと値を保存します。 |