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 とそのシグネチャで使用される場合、値は PropertyValue 型としてではなく、IPropertyValue インターフェイスとして渡されることがよくあります。

PropertyValue は、値自体を表すだけでなく、PropertyValue インスタンスを設定するユーティリティ メソッドを定義します。 アプリ コードからこれらのユーティリティ メソッドを呼び出すことは一般的ではありません。 メソッドはボックス化された値を作成し、この側面では、PropertyValue インスタンスは、コンポーネント オブジェクト モデル (COM) の VARIANT 概念と同様に機能します。 各メソッドには、1 つの値ではなく値の配列を作成する一致したメソッドがあります。

メソッド

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