VideoProperties 類別

定義

命名空間:

Windows.Storage.FileProperties

可讓您存取專案 (的視訊相關屬性，例如檔案或資料夾) 。

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

繼承

Object Platform::Object IInspectable VideoProperties

屬性

ContractVersionAttribute

實作

IStorageItemExtraProperties

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

此範例示範如何擷取檔案的屬性，包括 Year 和 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
}

GetVideoPropertiesAsync完成之後， videoProperties 會取得 VideoProperties 物件。

在此範例中， file 包含 StorageFile ，代表要擷取屬性的檔案。

備註

您可以使用 getVideoPropertiesAsync 方法，從專案的 Properties 屬性非同步存取 VideoProperties 物件， (像是資料夾檔案) ，或者如果有的話，請同步使用 VideoProperties 屬性。 您可以使用下列任何方法和屬性來取得 VideoProperties 物件：

• StorageItemContentProperties.getVideoPropertiesAsync 方法，如果可用，可以使用 Properties 屬性加以存取。
• FileInformation.videoProperties 屬性
• FolderInformation.videoProperties 屬性

注意

使用其他應用程式所定義的屬性處理常式取得或設定的屬性， (例如 Microsoft Word) 可能無法存取。 相反地，您可以使用系統索引所支援的檔案查詢來嘗試取得這些屬性。 如需詳細資訊，請參閱 QueryOptions。

如需有關存取屬性的詳細資訊程式碼範例，請參閱 檔案存取範例。

屬性

Bitrate	取得視訊的總和音訊和視訊位元速率。
Directors	取得影片的主管。
Duration	取得影片的持續時間。
Height	取得視訊的高度。
Keywords	取得與影片相關聯的關鍵字集合。
Latitude	取得影片的拍攝位置緯度座標。
Longitude	取得影片的拍攝經度座標。
Orientation	取得 VideoOrientation 值，指出視訊應該如何旋轉以正確顯示。
Producers	取得影片的製作人。
Publisher	取得或設定影片的發行者。
Rating	取得或設定與視訊檔案相關聯的評等。
Subtitle	取得或設定影片的副標題。
Title	取得或設定影片的標題。
Width	取得視訊的寬度。
Writers	取得影片的腳本寫入器。
Year	取得或設定影片的拍攝或發行年份。

方法

RetrievePropertiesAsync(IIterable<String>)	擷取與專案相關聯的指定屬性。
SavePropertiesAsync()	儲存與專案相關聯的所有屬性。
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	儲存與專案相關聯的指定屬性和值。

另請參閱

• GetVideoPropertiesAsync()
• VideoProperties
• VideoProperties
• VideoProperties