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 實例的公用程式方法。 從應用程式程式碼呼叫這些公用程式方法並不常見。 方法會建立 Boxed 值，在此方面，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)	提供可檢查物件的屬性值表示。 因為物件是參考型別，所以也是有效的屬性值，而且不需要進行 Boxed。 相反地，這個方法會傳回提供而不修改的物件。 物件可以設定為屬性值，而不需要先呼叫這個方法。
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