エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

MusicProperties Class

項目 (ファイルやフォルダーなど) の音楽関連プロパティにアクセスできるようにします。

構文


var musicProperties = fileInformation.musicProperties;

属性

[Version(0x06020000)]

メンバー

MusicPropertiesクラス には次の種類のメンバーがあります。

メソッド

The MusicProperties クラス には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
RetrievePropertiesAsync Retrieves the specified properties associated with the item.
SavePropertiesAsync() Saves all properties associated with the item.
SavePropertiesAsync(IIterable(IKeyValuePair)) Saves the specified properties and values associated with the item.

 

プロパティ

MusicPropertiesクラス には次のプロパティがあります。

プロパティアクセスの種類説明

Album

読み取り/書き込みGets or sets the name of the album that contains the song.

AlbumArtist

読み取り/書き込みGets or sets the name of the album artist of the song.

Artist

読み取り/書き込みGets the artists that contributed to the song or sets the album artist.

Bitrate

読み取り専用Gets the bit rate of the song file.

Composers

読み取り専用Gets the composers of the song.

Conductors

読み取り専用Gets the conductors of the song.

Duration

読み取り専用Gets the duration of the song in milliseconds.

Genre

読み取り専用Gets the names of music genres that the song belongs to.

Producers

読み取り専用Gets the producers of the song.

Publisher

読み取り/書き込みGets or sets the publisher of the song.

Rating

読み取り/書き込みGets the rating associated with the song.

Subtitle

読み取り/書き込みGets or sets the subtitle of the song.

Title

読み取り/書き込みGets or sets the title of the song

TrackNumber

読み取り/書き込みGets or sets the track number of the song on the song's album.

Writers

読み取り専用Gets the songwriters.

Year

読み取り/書き込みGets or sets the year that the song was released.

 

解説

項目 (フォルダーのファイルなど)、または可能な場合は同期的に MusicProperties プロパティを使用して、非同期的に Properties プロパティから getMusicPropertiesAsync メソッドを使用する MusicProperties オブジェクトにアクセスできます。

次のいずれかのメソッドとプロパティを使用して musicProperties オブジェクトを取得できます。

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

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

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



var file = SdkSample.sampleFile;
if (file !== null) {
    var outputDiv = document.getElementById("output");

    // Get music properties
    file.properties.getMusicPropertiesAsync().done(function (musicProperties) {
        outputDiv.innerHTML += "Album: " + musicProperties.Album + "<br />";
        outputDiv.innerHTML += "Rating: " + musicProperties.rating + "<br />";
    },
    // Handle errors with an error function
	   function (error) {
	      // Handle errors encountered while retrieving properties
    });
}

GetMusicPropertiesAsync が完了すると、musicPropertiesMusicProperties オブジェクトを取得します。

この例では、file は、プロパティを取得するファイルを表す StorageFile を格納しています。

要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.Storage.FileProperties
Windows::Storage::FileProperties [C++]

メタデータ

Windows.winmd

参照

StorageItemContentProperties.getMusicPropertiesAsync method
Windows.Storage.BulkAccess.fileInformation.musicProperties property
Windows.Storage.BulkAccess.folderInformation.musicProperties property
Windows.Storage.BulkAccess.IStorageItemInformation.MusicProperties property

 

 

表示:
© 2015 Microsoft