MusicProperties Classe

Référence

Définition

Espace de noms:: Windows.Storage.FileProperties

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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: ContractVersionAttribute

Implémente: IStorageItemExtraProperties

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 :

Méthode StorageItemContentProperties.GetMusicPropertiesAsync , accessible à l’aide de la propriété Properties , si elle est disponible.
Propriété FileInformation.MusicProperties
Propriété FolderInformation.MusicProperties

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 à

Share via