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