Condividi tramite

MusicProperties Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Storage.FileProperties
Modifica

Fornisce l'accesso alle proprietà correlate alla musica di un elemento (ad esempio un file o una cartella).

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
Ereditarietà
Object Platform::Object IInspectable MusicProperties
Attributi
ContractVersionAttribute
Implementazioni
IStorageItemExtraProperties

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

In questo esempio viene illustrato come recuperare le proprietà di un file, incluse le proprietà musicali come Album e Classificazione.

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
}

Al termine di GetMusicPropertiesAsync , musicProperties ottiene un oggetto MusicProperties.

Nell'esempio, file contiene un File di archiviazione che rappresenta il file per cui recuperare le proprietà.

Commenti

È possibile accedere a un oggetto MusicProperties in modo asincrono usando il metodo GetMusicPropertiesAsync dalla proprietà Properties di un elemento (ad esempio un file di cartella) o in modo sincrono usando la proprietà MusicProperties se disponibile. È possibile ottenere un oggetto musicProperties usando uno dei metodi e delle proprietà seguenti:

Nota

Le proprietà che vengono recuperate o impostate usando un gestore di proprietà definito da un'altra app (ad esempio Microsoft Word) potrebbero non essere accessibili. È invece possibile provare a ottenere queste proprietà usando una query di file supportata dall'indice di sistema. Per altre informazioni, vedere QueryOptions.

Per altri esempi di codice sull'accesso alle proprietà, vedere l'esempio di accesso ai file.

Proprietà

Album

Ottiene o imposta il nome dell'album che contiene la canzone.
AlbumArtist

Ottiene o imposta il nome dell'artista dell'album della canzone.
Artist

Ottiene gli artisti che hanno contribuito alla canzone.
Bitrate

Ottiene la frequenza di bit del file del brano.
Composers

Ottiene i compositori della canzone.
Conductors

Ottiene i conduttori della canzone.
Duration

Ottiene la durata del brano in millisecondi.
Genre

Ottiene i nomi dei generi musicali a cui appartiene la canzone.
Producers

Ottiene i produttori della canzone.
Publisher

Ottiene o imposta l'editore della canzone.
Rating

Ottiene o imposta la classificazione associata a un file musicale.
Subtitle

Ottiene o imposta il sottotitolo della canzone.
Title

Ottiene o imposta il titolo della canzone
TrackNumber

Ottiene o imposta il numero di traccia della canzone nell'album della canzone.
Writers

Ottiene i cantatori.
Year

Ottiene o imposta l'anno in cui è stata rilasciata la canzone.

Metodi

RetrievePropertiesAsync(IIterable<String>)

Recupera le proprietà del file di Windows correlate alla musica specificate associate all'elemento.
SavePropertiesAsync()

Salva tutte le proprietà associate all'elemento.
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

Salva le proprietà e i valori specificati associati all'elemento.

Si applica a

Vedi anche