IPropertyValue Interface

Reference

Definition

Namespace:: Windows.Foundation

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Edit

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

public interface class IPropertyValue

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1272349405, 30036, 16617, 154, 155, 130, 101, 78, 222, 126, 98)]
struct IPropertyValue

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(1272349405, 30036, 16617, 154, 155, 130, 101, 78, 222, 126, 98)]
public interface IPropertyValue

Public Interface IPropertyValue

Derived: Windows.Foundation.IReference<T>

Windows.Foundation.IReferenceArray<T>

Attributes: ContractVersionAttribute GuidAttribute

Windows requirements

Device family	Windows 10 (introduced in 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (introduced in v1.0)

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	Gets a value that indicates whether the property value is a scalar value.
Type	Returns the type stored in the property value.

Methods

GetBoolean()	Returns the Boolean value stored as a property value.
GetBooleanArray(Boolean[])	Returns the array of Boolean values stored as a property value.
GetChar16()	Returns the Unicode character stored as a property value.
GetChar16Array(Char[])	Returns the array of Unicode characters stored as a property value.
GetDateTime()	Returns the date and time value stored as a property value.
GetDateTimeArray(DateTime[])	Returns the array of date and time values stored as a property value.
GetDouble()	Returns the floating-point value stored as a property value.
GetDoubleArray(Double[])	Returns the array of floating-point values stored as a property value.
GetGuid()	Returns the GUID value stored as a property value.
GetGuidArray(Guid[])	Returns the array of GUID values stored as a property value.
GetInspectableArray(Object[])	Returns the array of inspectable objects stored as a property value.
GetInt16()	Returns the integer value stored as a property value.
GetInt16Array(Int16[])	Returns the array of integer values stored as a property value.
GetInt32()	Returns the integer value stored as a property value.
GetInt32Array(Int32[])	Returns the array of integer values stored as a property value.
GetInt64()	Returns the integer value stored as a property value.
GetInt64Array(Int64[])	Returns the array of integer values stored as a property value.
GetPoint()	Returns the point structure stored as a property value.
GetPointArray(Point[])	Returns the array of point structures stored as a property value.
GetRect()	Returns the rectangle structure stored as a property value.
GetRectArray(Rect[])	Returns the array of rectangle structures stored as a property value.
GetSingle()	Returns the floating-point value stored as a property value.
GetSingleArray(Single[])	Returns the array of floating-point values stored as a property value.
GetSize()	Returns the size structure stored as a property value.
GetSizeArray(Size[])	Returns the array of size structures stored as a property value.
GetString()	Returns the string value stored as a property value.
GetStringArray(String[])	Returns the array of string values stored as a property value.
GetTimeSpan()	Returns the time interval value stored as a property value.
GetTimeSpanArray(TimeSpan[])	Returns the array of time interval values stored as a property value.
GetUInt16()	Returns the unsigned integer value stored as a property value.
GetUInt16Array(UInt16[])	Returns the array of unsigned integer values stored as a property value.
GetUInt32()	Returns the unsigned integer value stored as a property value.
GetUInt32Array(UInt32[])	Returns the array of unsigned integer values stored as a property value.
GetUInt64()	Returns the unsigned integer value stored as a property value.
GetUInt64Array(UInt64[])	Returns the array of unsigned integer values stored as a property value.
GetUInt8()	Returns the byte value stored as a property value.
GetUInt8Array(Byte[])	Returns the array of byte values stored as a property value.

Applies to

Jaa