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, цель которых — предоставить приложению набор свойств, которые концептуально связаны по своему происхождению, но каждое свойство может (и часто использует) другой тип значения.

При использовании другими 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[])

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

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

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