Поделиться через


PropertyValue Класс

Определение

Представляет значение в хранилище свойств (например, экземпляр 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
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (появилось в v1.0)

Комментарии

PropertyValue представляет часть значения свойства, которая обычно имеет строковое имя и некоторое значение. В наборе свойств есть несколько свойств, и каждое свойство потенциально имеет свой тип значения, поэтому с точки зрения коллекции коллекция является смешанной, а не строго типизированной. Класс PropertySet и интерфейс IPropertySet — это существующие интерфейсы или реализации, которые используют эту модель и используют PropertyValue в качестве части значения пары "ключ-значение". IPropertySet — это тип различных свойств среда выполнения Windows, цель которых — предоставить приложению набор свойств, которые концептуально связаны по своему происхождению, но каждое свойство может (и часто использует) другой тип значения.

При использовании другими API-интерфейсами среда выполнения Windows и их сигнатурами значения часто передаются как интерфейс IPropertyValue, а не как тип PropertyValue.

Помимо представления самого значения PropertyValue определяет служебные методы, которые заполняют экземпляр PropertyValue. Вызов этих служебных методов из кода приложения выполняется редко. Методы создают упаковаемое значение, и в этом аспекте экземпляр PropertyValue работает аналогично концепции VARIANT из составной объектной модели (COM). Каждый метод имеет соответствующий метод, который создает массив значений в отличие от одного значения.

Методы

CreateBoolean(Boolean)

Создает значение свойства на основе логического значения.

CreateBooleanArray(Boolean[])

Создает значение свойства из массива логических значений.

CreateChar16(Char)

Создает значение свойства на основе символа Юникода.

CreateChar16Array(Char[])

Создает значение свойства из массива символов Юникода.

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[])

Создает значение свойства из массива байтов.

Применяется к

См. также раздел