StorageItemContentProperties.SavePropertiesAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
SavePropertiesAsync() |
Salva todas as propriedades associadas ao item. |
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Salva as propriedades e os valores especificados associados ao item. |
SavePropertiesAsync()
Salva todas as propriedades associadas ao item.
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
Retornos
Nenhum objeto ou valor é retornado quando esse método é concluído.
Implementações
- Atributos
Comentários
Se qualquer um dos valores de propriedade for inválido, nenhum dos valores será salvo.
Confira também
Aplica-se a
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)
Salva as propriedades e os valores especificados associados ao item.
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
Parâmetros
- propertiesToSave
-
IIterable<IKeyValuePair<Platform::String,Platform::Object>>
IIterable<IKeyValuePair<winrt::hstring,IInspectable>>
Uma coleção que contém os nomes e valores das propriedades a serem salvas como pares chave-valor (tipo IKeyValuePair).
Retornos
Nenhum objeto ou valor é retornado quando esse método é concluído.
Implementações
- Atributos
Comentários
System.ExpandoProperties
As propriedades Expando são um conjunto de valores nomeados associados a uma instância de arquivo de armazenamento na memória. Eles não são salvos persistentemente no sistema de arquivos, mas são mantidos quando um arquivo é salvo no cache de acesso.
Eles podem ser escritos e lidos por qualquer aplicativo e, portanto, fornecem uma maneira de associar informações a um arquivo de armazenamento. Isso é útil em cenários em que um arquivo de armazenamento é passado de um aplicativo para outro para comunicar informações extras sobre esse arquivo.
As propriedades Expando são acessadas usando a API de armazenamento Windows Runtime. Eles são recuperados como um valor usando RetrievePropertiesAsync com o nome da propriedade "System.ExpandoProperties". As propriedades expando são gravadas usando SavePropertiesAsync. Esse valor é um próprio conjunto de propriedades para que os valores dentro dele sejam acessados usando o modelo de programação PropertySet.
Os nomes usados para identificar valores no conjunto System.ExpandoProperties não precisam estar em conformidade com o esquema de nomenclatura de propriedades do sistema (que prefixa nomes de propriedade com "System"). Eles podem ser qualquer valor de cadeia de caracteres.
O sistema define alguns dos nomes que devem ser usados. Por exemplo, "OriginURL" é usado para comunicar de onde veio um arquivo armazenado localmente se ele foi baixado de uma fonte remota. (Consulte Personalizando a experiência de download.)
Os aplicativos podem definir e documentar as propriedades que usam para que outros aplicativos possam interoperar com eles. Por exemplo, System.ExpandoProperties pode ser usado para permitir que um aplicativo provedor passe informações de licença para um aplicativo universal do Office, para indicar se um arquivo pode ser pessoal ou para empresas.