StorageItemContentProperties.SavePropertiesAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
SavePropertiesAsync() |
Сохраняет все свойства, связанные с элементом. |
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Сохраняет указанные свойства и значения, связанные с элементом. |
SavePropertiesAsync()
Сохраняет все свойства, связанные с элементом.
public:
virtual IAsyncAction ^ SavePropertiesAsync() = SavePropertiesAsync;
/// [Windows.Foundation.Metadata.Overload("SavePropertiesAsyncOverloadDefault")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction SavePropertiesAsync();
[Windows.Foundation.Metadata.Overload("SavePropertiesAsyncOverloadDefault")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction SavePropertiesAsync();
function savePropertiesAsync()
Public Function SavePropertiesAsync () As IAsyncAction
Возвращаемое значение
После завершения этого метода объект или значение не возвращаются.
Реализации
- Атрибуты
Комментарии
Если какое-либо из значений свойства является недопустимым, ни одно из значений не будет сохранено.
См. также раздел
Применяется к
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)
Сохраняет указанные свойства и значения, связанные с элементом.
public:
virtual IAsyncAction ^ SavePropertiesAsync(IIterable<IKeyValuePair<Platform::String ^, Platform::Object ^> ^> ^ propertiesToSave) = SavePropertiesAsync;
/// [Windows.Foundation.Metadata.Overload("SavePropertiesAsync")]
IAsyncAction SavePropertiesAsync(IIterable<IKeyValuePair<winrt::hstring, IInspectable const&>> const& propertiesToSave);
[Windows.Foundation.Metadata.Overload("SavePropertiesAsync")]
public IAsyncAction SavePropertiesAsync(IEnumerable<KeyValuePair<string,object>> propertiesToSave);
function savePropertiesAsync(propertiesToSave)
Public Function SavePropertiesAsync (propertiesToSave As IEnumerable(Of KeyValuePair(Of String, Object))) As IAsyncAction
Параметры
- propertiesToSave
-
IIterable<IKeyValuePair<Platform::String,Platform::Object>>
IIterable<IKeyValuePair<winrt::hstring,IInspectable>>
Коллекция, содержащая имена и значения свойств для сохранения в виде пар "ключ-значение" (тип IKeyValuePair).
Возвращаемое значение
После завершения этого метода объект или значение не возвращаются.
Реализации
- Атрибуты
Комментарии
System.ExpandoProperties
Свойства Expando — это набор именованных значений, связанных с экземпляром файла хранилища в памяти. Они не сохраняются постоянно в файловой системе, но сохраняются при сохранении файла в кэше доступа.
Они могут быть записаны и прочитаны любым приложением и, следовательно, предоставляют способ связывания информации с файлом хранилища. Это полезно в сценариях, когда файл хранилища передается из одного приложения в другое для передачи дополнительных сведений об этом файле.
Доступ к свойствам Expando можно получить с помощью API хранилища среда выполнения Windows. Они извлекаются в виде значения с помощью RetrievePropertiesAsync с именем свойства System.ExpandoProperties. Свойства expando записываются с помощью SavePropertiesAsync. Это значение само по себе является набором свойств, поэтому доступ к значениям в нем осуществляется с помощью модели программирования PropertySet.
Имена, используемые для идентификации значений в наборе System.ExpandoProperties, не должны соответствовать системной схеме именования свойств (которая префиксирует имена свойств с помощью "System"). Это может быть любое строковое значение.
Система определяет некоторые имена, которые следует использовать. Например, OriginURL используется для передачи сведений о том, откуда поступил локально хранящийся файл, если он был скачан из удаленного источника. (См. раздел Настройка интерфейса скачивания.)
Приложения могут определять и документировать используемые свойства, чтобы другие приложения могли взаимодействовать с ними. Например, System.ExpandoProperties можно использовать, чтобы разрешить приложению поставщика передавать сведения о лицензии универсальному приложению Office, чтобы указать, может ли файл быть личным или для бизнеса.