MusicProperties Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan akses ke properti item terkait musik (seperti file atau folder).
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
- Warisan
- Atribut
- Penerapan
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Contoh ini menunjukkan cara mengambil properti file, termasuk properti musik seperti Album dan Peringkat.
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
}
Setelah GetMusicPropertiesAsync selesai, musicProperties
mendapatkan objek MusicProperties.
Dalam contoh, file
berisi StorageFile yang mewakili file untuk mengambil properti.
Keterangan
Anda dapat mengakses objek MusicProperties secara asinkron menggunakan metode GetMusicPropertiesAsync dari properti Properti item (seperti file folder), atau secara sinkron menggunakan properti MusicProperties jika tersedia. Anda bisa mendapatkan objek musicProperties menggunakan salah satu metode dan properti berikut:
- Metode StorageItemContentProperties.GetMusicPropertiesAsync , yang dapat diakses menggunakan properti Properti , jika tersedia.
- Properti FileInformation.MusicProperties
- Properti FolderInformation.MusicProperties
Catatan
Properti yang didapatkan atau diatur menggunakan handler properti yang ditentukan oleh aplikasi lain (seperti Microsoft Word) mungkin tidak dapat diakses. Sebagai gantinya, Anda bisa mencoba mendapatkan properti ini menggunakan kueri file yang didukung oleh indeks sistem. Untuk informasi selengkapnya, lihat QueryOptions.
Untuk sampel kode lainnya tentang mengakses properti, lihat Sampel akses file.
Properti
Album |
Mendapatkan atau mengatur nama album yang berisi lagu. |
AlbumArtist |
Mendapatkan atau menetapkan nama artis album lagu. |
Artist |
Mendapatkan artis yang berkontribusi pada lagu. |
Bitrate |
Mendapatkan laju bit file lagu. |
Composers |
Mendapatkan komposer lagu. |
Conductors |
Mendapatkan konduktor lagu. |
Duration |
Mendapatkan durasi lagu dalam milidetik. |
Genre |
Mendapatkan nama genre musik milik lagu tersebut. |
Producers |
Mendapatkan produser lagu. |
Publisher |
Mendapatkan atau mengatur penerbit lagu. |
Rating |
Mendapatkan atau mengatur peringkat yang terkait dengan file musik. |
Subtitle |
Mendapatkan atau mengatur subtitel lagu. |
Title |
Mendapatkan atau mengatur judul lagu |
TrackNumber |
Mendapatkan atau mengatur nomor trek lagu di album lagu. |
Writers |
Mendapatkan penulis lagu. |
Year |
Mendapatkan atau mengatur tahun lagu dirilis. |
Metode
RetrievePropertiesAsync(IIterable<String>) |
Mengambil properti file Windows terkait musik yang ditentukan yang terkait dengan item tersebut. |
SavePropertiesAsync() |
Menyimpan semua properti yang terkait dengan item. |
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Menyimpan properti dan nilai yang ditentukan yang terkait dengan item. |