Compartir a través de


MusicProperties Clase

Definición

Proporciona acceso a las propiedades relacionadas con la música de un elemento (como un archivo o carpeta).

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
Herencia
Object Platform::Object IInspectable MusicProperties
Atributos
Implementaciones

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En este ejemplo se muestra cómo recuperar propiedades de un archivo, incluidas las propiedades de música como Album y 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
}

Una vez completado GetMusicPropertiesAsync , musicProperties obtiene un objeto MusicProperties.

En el ejemplo, file contiene un storageFile que representa el archivo para el que se van a recuperar las propiedades.

Comentarios

Puede acceder a un objeto MusicProperties de forma asincrónica mediante el método GetMusicPropertiesAsync desde la propiedad Properties de un elemento (como un archivo de carpeta) o mediante la propiedad MusicProperties de forma sincrónica si está disponible. Puede obtener un objeto musicProperties mediante cualquiera de los métodos y propiedades siguientes:

Nota:

Es posible que no se pueda acceder a las propiedades que se obtienen o establecen mediante un controlador de propiedades definido por otra aplicación (como Microsoft Word). En su lugar, puede intentar obtener estas propiedades mediante una consulta de archivo respaldada por el índice del sistema. Para obtener más información, consulte QueryOptions.

Para obtener más ejemplos de código sobre el acceso a las propiedades, consulte el ejemplo de acceso a archivos.

Propiedades

Album

Obtiene o establece el nombre del álbum que contiene la canción.

AlbumArtist

Obtiene o establece el nombre del artista del álbum de la canción.

Artist

Obtiene a los artistas que han contribuido a la canción.

Bitrate

Obtiene la velocidad de bits del archivo de canciones.

Composers

Obtiene los compositores de la canción.

Conductors

Obtiene los conductores de la canción.

Duration

Obtiene la duración de la canción en milisegundos.

Genre

Obtiene los nombres de los géneros musicales a los que pertenece la canción.

Producers

Obtiene los productores de la canción.

Publisher

Obtiene o establece el publicador de la canción.

Rating

Obtiene o establece la clasificación asociada a un archivo de música.

Subtitle

Obtiene o establece el subtítulo de la canción.

Title

Obtiene o establece el título de la canción.

TrackNumber

Obtiene o establece el número de pista de la canción en el álbum de la canción.

Writers

Obtiene a los compositores.

Year

Obtiene o establece el año en que se lanzó la canción.

Métodos

RetrievePropertiesAsync(IIterable<String>)

Recupera las propiedades de archivo de Windows relacionadas con la música especificadas asociadas al elemento.

SavePropertiesAsync()

Guarda todas las propiedades asociadas al elemento.

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

Guarda las propiedades y valores especificados asociados al elemento.

Se aplica a

Consulte también