Partager via


MusicProperties Classe

Définition

Fournit l’accès aux propriétés liées à la musique d’un élément (comme un fichier ou un dossier).

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
Héritage
Object Platform::Object IInspectable MusicProperties
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple montre comment récupérer les propriétés d’un fichier, y compris les propriétés musicales telles que Album et Rating.

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
}

Une fois GetMusicPropertiesAsync terminé, musicProperties obtient un objet MusicProperties.

Dans l’exemple, file contient un StorageFile qui représente le fichier pour lequel récupérer des propriétés.

Remarques

Vous pouvez accéder à un objet MusicProperties de manière asynchrone à l’aide de la méthode GetMusicPropertiesAsync à partir de la propriété Properties d’un élément (comme un fichier de dossier) ou de manière synchrone à l’aide de la propriété MusicProperties si elle est disponible. Vous pouvez obtenir un objet musicProperties à l’aide de l’une des méthodes et propriétés suivantes :

Notes

Les propriétés qui sont obtenir ou définies à l’aide d’un gestionnaire de propriétés défini par une autre application (comme Microsoft Word) peuvent ne pas être accessibles. Au lieu de cela, vous pouvez essayer d’obtenir ces propriétés à l’aide d’une requête de fichier qui est sauvegardée par l’index système. Pour plus d’informations, consultez QueryOptions.

Pour plus d’exemples de code sur l’accès aux propriétés, consultez l’exemple Accès aux fichiers.

Propriétés

Album

Obtient ou définit le nom de l’album qui contient la chanson.

AlbumArtist

Obtient ou définit le nom de l’artiste de l’album de la chanson.

Artist

Obtient les artistes qui ont contribué à la chanson.

Bitrate

Obtient le débit binaire du fichier de chanson.

Composers

Obtient les compositeurs de la chanson.

Conductors

Obtient les chefs d’orchestre de la chanson.

Duration

Obtient la durée de la chanson en millisecondes.

Genre

Obtient les noms des genres musicaux auxquels appartient la chanson.

Producers

Obtient les producteurs de la chanson.

Publisher

Obtient ou définit l’éditeur de la chanson.

Rating

Obtient ou définit l’évaluation associée à un fichier de musique.

Subtitle

Obtient ou définit le sous-titre de la chanson.

Title

Obtient ou définit le titre de la chanson

TrackNumber

Obtient ou définit le numéro de piste de la chanson sur l’album de la chanson.

Writers

Obtient les auteurs-compositeurs.

Year

Obtient ou définit l’année de sortie de la chanson.

Méthodes

RetrievePropertiesAsync(IIterable<String>)

Récupère les propriétés de fichier Windows associées à la musique spécifiées associées à l’élément.

SavePropertiesAsync()

Enregistre toutes les propriétés associées à l’élément.

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

Enregistre les propriétés et valeurs spécifiées associées à l’élément.

S’applique à

Voir aussi