I​Property​Value I​Property​Value I​Property​Value Interface

Definition

Represents a value in a property store. You can't implement this interface, see Remarks.

public interface IPropertyValuepublic interface IPropertyValuePublic Interface IPropertyValue
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (introduced v1)

Remarks

The IPropertyValue interface is a store for values whose type is not known until runtime.

To obtain the value stored in an IPropertyValue object, when the type of the stored property is not known ahead of time, you should first determine the stored type from the Type property and then call the appropriate IPropertyValue method for the type.

If the type is known ahead of time, you can the type access method of IPropertyValue interface directory and check for the return value to verify type returned was what is expected. If the type returned does not match the value of the Type property then the method fails with the TYPE_E_TYPEMISMATCH error.

You can't implement the IPropertyValue interface or include it in a signature. IPropertyValue is mainly an internal implementation detail of how the Windows Runtime implements boxing and nullable values.

Properties

IsNumericScalar IsNumericScalar IsNumericScalar

Gets a value that indicates whether the property value is a scalar value.

public bool IsNumericScalar { get; }public bool IsNumericScalar { get; }Public ReadOnly Property IsNumericScalar As bool
Value
bool bool bool

True if the value is scalar; otherwise false.

Attributes

Type Type Type

Returns the type stored in the property value.

public PropertyType Type { get; }public PropertyType Type { get; }Public ReadOnly Property Type As PropertyType
Value
PropertyType PropertyType PropertyType

The type stored in the property value.

Attributes

Methods

GetBoolean() GetBoolean() GetBoolean()

Returns the Boolean value stored as a property value.

public bool GetBoolean()public bool GetBoolean()Public Function GetBoolean() As bool
Returns
bool bool bool

The value.

Attributes

GetBooleanArray(Boolean[]) GetBooleanArray(Boolean[]) GetBooleanArray(Boolean[])

Returns the array of Boolean values stored as a property value.

public void GetBooleanArray(Boolean[] value)public void GetBooleanArray(Boolean[] value)Public Function GetBooleanArray(value As Boolean[]) As void
Parameters
value
System.Boolean[] System.Boolean[] System.Boolean[]

The array of values.

Attributes

GetChar16() GetChar16() GetChar16()

Returns the Unicode character stored as a property value.

public char GetChar16()public char GetChar16()Public Function GetChar16() As char
Returns
char char char

The value.

Attributes

GetChar16Array(Char[]) GetChar16Array(Char[]) GetChar16Array(Char[])

Returns the array of Unicode characters stored as a property value.

public void GetChar16Array(Char[] value)public void GetChar16Array(Char[] value)Public Function GetChar16Array(value As Char[]) As void
Parameters
value
System.Char[] System.Char[] System.Char[]

The array of values.

Attributes

GetDateTime() GetDateTime() GetDateTime()

Returns the date and time value stored as a property value.

public DateTime GetDateTime()public DateTimeOffset GetDateTime()Public Function GetDateTime() As DateTimeOffset
Returns
Attributes

GetDateTimeArray(DateTime[]) GetDateTimeArray(DateTime[]) GetDateTimeArray(DateTime[])

Returns the array of date and time values stored as a property value.

public void GetDateTimeArray(DateTime[] value)public void GetDateTimeArray(DateTime[] value)Public Function GetDateTimeArray(value As DateTime[]) As void
Parameters
value
Windows.Foundation.DateTime[] Windows.Foundation.DateTime[] Windows.Foundation.DateTime[]

The array of values.

Attributes

GetDouble() GetDouble() GetDouble()

Returns the floating-point value stored as a property value.

public double GetDouble()public double GetDouble()Public Function GetDouble() As double
Returns
double double double

The value.

Attributes

GetDoubleArray(Double[]) GetDoubleArray(Double[]) GetDoubleArray(Double[])

Returns the array of floating-point values stored as a property value.

public void GetDoubleArray(Double[] value)public void GetDoubleArray(Double[] value)Public Function GetDoubleArray(value As Double[]) As void
Parameters
value
System.Double[] System.Double[] System.Double[]

The array of values.

Attributes

GetGuid() GetGuid() GetGuid()

Returns the GUID value stored as a property value.

public Guid GetGuid()public Guid GetGuid()Public Function GetGuid() As Guid
Returns
System.Guid System.Guid System.Guid

The value.

Attributes

GetGuidArray(Guid[]) GetGuidArray(Guid[]) GetGuidArray(Guid[])

Returns the array of GUID values stored as a property value.

public void GetGuidArray(Guid[] value)public void GetGuidArray(Guid[] value)Public Function GetGuidArray(value As Guid[]) As void
Parameters
value
System.Guid[] System.Guid[] System.Guid[]

The array of values.

Attributes

GetInspectableArray(Object[]) GetInspectableArray(Object[]) GetInspectableArray(Object[])

Returns the array of inspectable objects stored as a property value.

public void GetInspectableArray(Object[] value)public void GetInspectableArray(Object[] value)Public Function GetInspectableArray(value As Object[]) As void
Parameters
value
System.Object[] System.Object[] System.Object[]

The array of objects.

Attributes

GetInt16() GetInt16() GetInt16()

Returns the integer value stored as a property value.

public short GetInt16()public short GetInt16()Public Function GetInt16() As short
Returns
short short short

The value.

Attributes

GetInt16Array(Int16[]) GetInt16Array(Int16[]) GetInt16Array(Int16[])

Returns the array of integer values stored as a property value.

public void GetInt16Array(Int16[] value)public void GetInt16Array(Int16[] value)Public Function GetInt16Array(value As Int16[]) As void
Parameters
value
System.Int16[] System.Int16[] System.Int16[]

The array of values.

Attributes

GetInt32() GetInt32() GetInt32()

Returns the integer value stored as a property value.

public int GetInt32()public int GetInt32()Public Function GetInt32() As int
Returns
int int int

The value.

Attributes

GetInt32Array(Int32[]) GetInt32Array(Int32[]) GetInt32Array(Int32[])

Returns the array of integer values stored as a property value.

public void GetInt32Array(Int32[] value)public void GetInt32Array(Int32[] value)Public Function GetInt32Array(value As Int32[]) As void
Parameters
value
System.Int32[] System.Int32[] System.Int32[]

The array of values.

Attributes

GetInt64() GetInt64() GetInt64()

Returns the integer value stored as a property value.

public long GetInt64()public long GetInt64()Public Function GetInt64() As long
Returns
long long long

The value.

Attributes

GetInt64Array(Int64[]) GetInt64Array(Int64[]) GetInt64Array(Int64[])

Returns the array of integer values stored as a property value.

public void GetInt64Array(Int64[] value)public void GetInt64Array(Int64[] value)Public Function GetInt64Array(value As Int64[]) As void
Parameters
value
System.Int64[] System.Int64[] System.Int64[]

The array of values.

Attributes

GetPoint() GetPoint() GetPoint()

Returns the point structure stored as a property value.

public Point GetPoint()public Point GetPoint()Public Function GetPoint() As Point
Returns

The structure.

Attributes

GetPointArray(Point[]) GetPointArray(Point[]) GetPointArray(Point[])

Returns the array of point structures stored as a property value.

public void GetPointArray(Point[] value)public void GetPointArray(Point[] value)Public Function GetPointArray(value As Point[]) As void
Parameters
value
Windows.Foundation.Point[] Windows.Foundation.Point[] Windows.Foundation.Point[]

The array of structures.

Attributes

GetRect() GetRect() GetRect()

Returns the rectangle structure stored as a property value.

public Rect GetRect()public Rect GetRect()Public Function GetRect() As Rect
Returns

The structure.

Attributes

GetRectArray(Rect[]) GetRectArray(Rect[]) GetRectArray(Rect[])

Returns the array of rectangle structures stored as a property value.

public void GetRectArray(Rect[] value)public void GetRectArray(Rect[] value)Public Function GetRectArray(value As Rect[]) As void
Parameters
value
Windows.Foundation.Rect[] Windows.Foundation.Rect[] Windows.Foundation.Rect[]

The array of structures.

Attributes

GetSingle() GetSingle() GetSingle()

Returns the floating-point value stored as a property value.

public float GetSingle()public float GetSingle()Public Function GetSingle() As float
Returns
float float float

The value.

Attributes

GetSingleArray(Single[]) GetSingleArray(Single[]) GetSingleArray(Single[])

Returns the array of floating-point values stored as a property value.

public void GetSingleArray(Single[] value)public void GetSingleArray(Single[] value)Public Function GetSingleArray(value As Single[]) As void
Parameters
value
System.Single[] System.Single[] System.Single[]

The array of values.

Attributes

GetSize() GetSize() GetSize()

Returns the size structure stored as a property value.

public Size GetSize()public Size GetSize()Public Function GetSize() As Size
Returns

The structure.

Attributes

GetSizeArray(Size[]) GetSizeArray(Size[]) GetSizeArray(Size[])

Returns the array of size structures stored as a property value.

public void GetSizeArray(Size[] value)public void GetSizeArray(Size[] value)Public Function GetSizeArray(value As Size[]) As void
Parameters
value
Windows.Foundation.Size[] Windows.Foundation.Size[] Windows.Foundation.Size[]

The array of structures.

Attributes

GetString() GetString() GetString()

Returns the string value stored as a property value.

public string GetString()public string GetString()Public Function GetString() As string
Returns
string string string

The value.

Attributes

GetStringArray(String[]) GetStringArray(String[]) GetStringArray(String[])

Returns the array of string values stored as a property value.

public void GetStringArray(String[] value)public void GetStringArray(String[] value)Public Function GetStringArray(value As String[]) As void
Parameters
value
System.String[] System.String[] System.String[]

The array of values.

Attributes

GetTimeSpan() GetTimeSpan() GetTimeSpan()

Returns the time interval value stored as a property value.

public TimeSpan GetTimeSpan()public TimeSpan GetTimeSpan()Public Function GetTimeSpan() As TimeSpan
Returns
Attributes

GetTimeSpanArray(TimeSpan[]) GetTimeSpanArray(TimeSpan[]) GetTimeSpanArray(TimeSpan[])

Returns the array of time interval values stored as a property value.

public void GetTimeSpanArray(TimeSpan[] value)public void GetTimeSpanArray(TimeSpan[] value)Public Function GetTimeSpanArray(value As TimeSpan[]) As void
Parameters
value
Windows.Foundation.TimeSpan[] Windows.Foundation.TimeSpan[] Windows.Foundation.TimeSpan[]

The array of values.

Attributes

GetUInt16() GetUInt16() GetUInt16()

Returns the unsigned integer value stored as a property value.

public ushort GetUInt16()public ushort GetUInt16()Public Function GetUInt16() As ushort
Returns
ushort ushort ushort

The value.

Attributes

GetUInt16Array(UInt16[]) GetUInt16Array(UInt16[]) GetUInt16Array(UInt16[])

Returns the array of unsigned integer values stored as a property value.

public void GetUInt16Array(UInt16[] value)public void GetUInt16Array(UInt16[] value)Public Function GetUInt16Array(value As UInt16[]) As void
Parameters
value
System.UInt16[] System.UInt16[] System.UInt16[]

The array of values.

Attributes

GetUInt32() GetUInt32() GetUInt32()

Returns the unsigned integer value stored as a property value.

public uint GetUInt32()public uint GetUInt32()Public Function GetUInt32() As uint
Returns
uint uint uint

The value.

Attributes

GetUInt32Array(UInt32[]) GetUInt32Array(UInt32[]) GetUInt32Array(UInt32[])

Returns the array of unsigned integer values stored as a property value.

public void GetUInt32Array(UInt32[] value)public void GetUInt32Array(UInt32[] value)Public Function GetUInt32Array(value As UInt32[]) As void
Parameters
value
System.UInt32[] System.UInt32[] System.UInt32[]

The array of values.

Attributes

GetUInt64() GetUInt64() GetUInt64()

Returns the unsigned integer value stored as a property value.

public ulong GetUInt64()public ulong GetUInt64()Public Function GetUInt64() As ulong
Returns
ulong ulong ulong

The value.

Attributes

GetUInt64Array(UInt64[]) GetUInt64Array(UInt64[]) GetUInt64Array(UInt64[])

Returns the array of unsigned integer values stored as a property value.

public void GetUInt64Array(UInt64[] value)public void GetUInt64Array(UInt64[] value)Public Function GetUInt64Array(value As UInt64[]) As void
Parameters
value
System.UInt64[] System.UInt64[] System.UInt64[]

The array of values.

Attributes

GetUInt8() GetUInt8() GetUInt8()

Returns the byte value stored as a property value.

public byte GetUInt8()public byte GetUInt8()Public Function GetUInt8() As byte
Returns
byte byte byte

The value.

Attributes

GetUInt8Array(Byte[]) GetUInt8Array(Byte[]) GetUInt8Array(Byte[])

Returns the array of byte values stored as a property value.

public void GetUInt8Array(Byte[] value)public void GetUInt8Array(Byte[] value)Public Function GetUInt8Array(value As Byte[]) As void
Parameters
value
System.Byte[] System.Byte[] System.Byte[]

The array of values.

Attributes