MusicProperties Clase

Definición

Espacio de nombres:

Windows.Storage.FileProperties

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

ContractVersionAttribute

Implementaciones

IStorageItemExtraProperties

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:

• Método StorageItemContentProperties.GetMusicPropertiesAsync , al que se puede acceder mediante la propiedad Properties , si está disponible.
• Propiedad FileInformation.MusicProperties
• Propiedad FolderInformation.MusicProperties

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.

Consulte también

• GetMusicPropertiesAsync()
• MusicProperties
• MusicProperties
• MusicProperties