PropertyValue 类

定义

命名空间:

Windows.Foundation

表示属性存储 (中的值，例如 PropertySet 实例) 。

public ref class PropertyValue abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class PropertyValue final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class PropertyValue

Public Class PropertyValue

继承

Object Platform::Object IInspectable PropertyValue

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.FoundationContract (在 v1.0 中引入)

注解

PropertyValue 表示属性的值部分，该属性通常具有字符串名称和某些值。 一个属性集中有多个属性，每个属性可能具有不同的值类型，因此从集合的角度来看，集合是混合的，而不是强类型。 PropertySet 类和 IPropertySet 接口是使用此模型并将 PropertyValue 用作键值对的值部分的现有接口或实现。 IPropertySet 是各种Windows 运行时属性的类型，其目标是为应用提供在概念上与源相关的属性的属性包，但每个属性可能 (，并且通常) 使用不同的值类型。

当其他Windows 运行时 API 及其签名使用时，值通常作为 IPropertyValue 接口而不是 PropertyValue 类型传递。

除了表示值本身之外，PropertyValue 还定义了填充 PropertyValue 实例的实用工具方法。 从应用代码调用这些实用工具方法并不常见。 方法创建一个装箱值，在这方面，PropertyValue 实例的功能类似于组件对象模型 (COM) 中的 VARIANT 概念。 每个方法都有一个匹配的方法，该方法创建一个值数组，而不是单个值。

方法

CreateBoolean(Boolean)	从布尔值创建属性值。
CreateBooleanArray(Boolean[])	从布尔值数组创建属性值。
CreateChar16(Char)	从 Unicode 字符创建属性值。
CreateChar16Array(Char[])	从 Unicode 字符数组创建属性值。
CreateDateTime(DateTime)	根据日期和时间值创建属性值。
CreateDateTimeArray(DateTime[])	从日期和时间值数组创建属性值。
CreateDouble(Double)	从浮点值创建属性值。
CreateDoubleArray(Double[])	从浮点值数组创建属性值。
CreateEmpty()	创建空属性值。
CreateGuid(Guid)	从 GUID 创建属性值。
CreateGuidArray(Guid[])	从 GUID数组创建属性值。
CreateInspectable(Object)	提供可检查对象的属性值表示形式。 由于 对象是引用类型，因此它也是一个有效的属性值，不需要装箱。 相反，此方法返回所提供的对象，而无需修改。 对象可以设置为属性值，而无需先调用此方法。
CreateInspectableArray(Object[])	从可检查对象的数组创建属性值。
CreateInt16(Int16)	从整数创建属性值。
CreateInt16Array(Int16[])	从整数数组创建属性值。
CreateInt32(Int32)	从整数创建属性值。
CreateInt32Array(Int32[])	从整数数组创建属性值。
CreateInt64(Int64)	从整数创建属性值。
CreateInt64Array(Int64[])	从整数数组创建属性值。
CreatePoint(Point)	从点结构创建属性值。
CreatePointArray(Point[])	从点结构数组创建属性值。
CreateRect(Rect)	从矩形结构创建属性值。
CreateRectArray(Rect[])	从矩形结构数组创建属性值。
CreateSingle(Single)	从浮点值创建属性值。
CreateSingleArray(Single[])	从浮点值数组创建属性值。
CreateSize(Size)	从大小结构创建属性值。
CreateSizeArray(Size[])	从大小结构数组创建属性值。
CreateString(String)	从字符串创建属性值。
CreateStringArray(String[])	从字符串数组创建属性值。
CreateTimeSpan(TimeSpan)	根据时间间隔创建属性值。
CreateTimeSpanArray(TimeSpan[])	从时间间隔数组创建属性值。
CreateUInt16(UInt16)	从无符号整数创建属性值。
CreateUInt16Array(UInt16[])	从无符号整数数组创建属性值。
CreateUInt32(UInt32)	从无符号整数创建属性值。
CreateUInt32Array(UInt32[])	从无符号整数数组创建属性值。
CreateUInt64(UInt64)	从无符号整数创建属性值。
CreateUInt64Array(UInt64[])	从无符号整数数组创建属性值。
CreateUInt8(Byte)	从字节创建属性值。
CreateUInt8Array(Byte[])	从字节数组创建属性值。

另请参阅

• PropertyType
• IPropertyValue
• PropertySet