MusicProperties Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage.FileProperties

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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:

Metodo StorageItemContentProperties.GetMusicPropertiesAsync , accessibile tramite la proprietà Properties , se disponibile.
Proprietà FileInformation.MusicProperties
FolderInformation.MusicProperties , proprietà

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

Condividi tramite