MusicProperties Klasse

Referenz

Definition

Namespace:: Windows.Storage.FileProperties

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ermöglicht den Zugriff auf die musikbezogenen Eigenschaften eines Elements (z. B. einer Datei oder eines Ordners).

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

Vererbung: Object Platform::Object IInspectable MusicProperties

Attribute: ContractVersionAttribute

Implementiert: IStorageItemExtraProperties

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

In diesem Beispiel wird veranschaulicht, wie Eigenschaften einer Datei abgerufen werden, einschließlich Musikeigenschaften wie Album und Bewertung.

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
}

Ruft nach Abschluss musicProperties von GetMusicPropertiesAsync ein MusicProperties-Objekt ab.

Enthält im Beispiel eine StorageFile-Datei, die die Datei darstellt, file für die Eigenschaften abgerufen werden sollen.

Hinweise

Sie können asynchron auf ein MusicProperties-Objekt zugreifen, indem Sie die GetMusicPropertiesAsync-Methode über die Properties-Eigenschaft eines Elements (z. B. eine Ordnerdatei) oder synchron die MusicProperties-Eigenschaft verwenden, wenn sie verfügbar ist. Sie können ein musicProperties-Objekt mit einer der folgenden Methoden und Eigenschaften abrufen:

StorageItemContentProperties.GetMusicPropertiesAsync-Methode , auf die mithilfe der Properties-Eigenschaft zugegriffen werden kann, sofern sie verfügbar ist.
FileInformation.MusicProperties-Eigenschaft
FolderInformation.MusicProperties-Eigenschaft

Hinweis

Auf Eigenschaften, die mithilfe eines Eigenschaftenhandlers abgerufen oder festgelegt werden, der von einer anderen App (z. B. Microsoft Word) definiert wird, kann möglicherweise nicht zugegriffen werden. Stattdessen können Sie versuchen, diese Eigenschaften mithilfe einer Dateiabfrage abzurufen, die vom Systemindex unterstützt wird. Weitere Informationen finden Sie unter QueryOptions.

Weitere Codebeispiele zum Zugreifen auf Eigenschaften finden Sie im Dateizugriffsbeispiel.

Eigenschaften

Album	Ruft den Namen des Albums ab, das den Song enthält, oder legt diesen fest.
AlbumArtist	Ruft den Namen des Albumkünstlers des Songs ab oder legt diese fest.
Artist	Ruft die Künstler ab, die zum Song beigetragen haben.
Bitrate	Ruft die Bitrate der Songdatei ab.
Composers	Ruft die Komponisten des Songs ab.
Conductors	Ruft die Dirigenten des Songs ab.
Duration	Ruft die Dauer des Songs in Millisekunden ab.
Genre	Ruft die Namen der Musikgenres ab, zu denen der Song gehört.
Producers	Ruft die Produzenten des Songs ab.
Publisher	Ruft den Herausgeber des Songs ab oder legt diese fest.
Rating	Ruft die Bewertung ab, die einer Musikdatei zugeordnet ist, oder legt sie fest.
Subtitle	Ruft den Untertitel des Songs ab oder legt diese fest.
Title	Ruft den Titel des Songs ab oder legt den Titel fest.
TrackNumber	Ruft die Titelnummer des Songs auf dem Album des Songs ab oder legt diese fest.
Writers	Ruft die Songwriter ab.
Year	Ruft das Jahr ab, in dem der Song veröffentlicht wurde, oder legt es fest.

Methoden

RetrievePropertiesAsync(IIterable<String>)	Ruft die angegebenen musikbezogenen Windows-Dateieigenschaften ab, die dem Element zugeordnet sind.
SavePropertiesAsync()	Speichert alle dem Element zugeordneten Eigenschaften.
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	Speichert die angegebenen Eigenschaften und Werte, die dem Element zugeordnet sind.

Gilt für:

Freigeben über