VideoProperties 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 videobezogenen Eigenschaften eines Elements (z. B. eine Datei oder einen Ordner).

public ref class VideoProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class VideoProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class VideoProperties

Public NotInheritable Class VideoProperties

Vererbung: Object Platform::Object IInspectable VideoProperties

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 Videoeigenschaften wie Year und Rating.

try
{
    StorageFile file = rootPage.sampleFile;
    if (file != null)
    {
        StringBuilder outputText = new StringBuilder();

        // Get video properties
        VideoProperties videoProperties = await file.Properties.GetVideoPropertiesAsync();
        outputText.AppendLine("Year: " + videoProperties.Year);
        outputText.AppendLine("Rating: " + videoProperties.Rating);
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
 // For example, handle a file not found error
}

Ruft nach Abschluss videoPropertiesvon GetVideoPropertiesAsync ein VideoProperties-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 VideoProperties-Objekt zugreifen, indem Sie die getVideoPropertiesAsync-Methode über die Properties-Eigenschaft eines Elements (z. B. eine Datei mit einem Ordner) verwenden oder synchron die VideoProperties-Eigenschaft verwenden, wenn sie verfügbar ist. Sie können ein VideoProperties-Objekt mit einer der folgenden Methoden und Eigenschaften abrufen:

StorageItemContentProperties.getVideoPropertiesAsync-Methode , auf die mithilfe der Properties-Eigenschaft zugegriffen werden kann, sofern sie verfügbar ist.
FileInformation.videoProperties-Eigenschaft
FolderInformation.videoProperties-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

Bitrate	Ruft die Summe der Audio- und Videobitrate des Videos ab.
Directors	Ruft die Regisseure des Videos ab.
Duration	Ruft die Dauer des Videos ab.
Height	Ruft die Höhe des Videos ab.
Keywords	Ruft die Auflistung der Schlüsselwörter ab, die dem Video zugeordnet sind.
Latitude	Ruft die Breitenkoordinate ab, an der das Video aufgenommen wurde.
Longitude	Ruft die Längengradkoordinate ab, an der das Video gedreht wurde.
Orientation	Ruft einen VideoOrientation-Wert ab, der angibt, wie das Video gedreht werden soll, um es richtig anzuzeigen.
Producers	Ruft die Produzenten des Videos ab.
Publisher	Ruft den Herausgeber des Videos ab oder legt diese fest.
Rating	Ruft die Bewertung ab, die einer Videodatei zugeordnet ist, oder legt sie fest.
Subtitle	Ruft den Untertitel des Videos ab oder legt diese fest.
Title	Ruft den Titel des Videos ab oder legt den Titel fest.
Width	Ruft die Breite des Videos ab.
Writers	Ruft die Skriptautoren für das Video ab.
Year	Ruft das Jahr ab, in dem das Video aufgenommen oder veröffentlicht wurde, oder legt es fest.

Methoden

RetrievePropertiesAsync(IIterable<String>)	Ruft die angegebenen Eigenschaften 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: