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 PropertyValuePublic Class 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[]) |
Создает значение свойства из массива байтов. |