共用方式為


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<String,Object>>

IEnumerable<KeyValuePair<String,Object>>

IIterable<IKeyValuePair<Platform::String,Platform::Object>>

IIterable<IKeyValuePair<winrt::hstring,IInspectable>>

集合,其中包含屬性的名稱和值,以儲存為索引鍵/值組, (類型 IKeyValuePair) 。

傳回

這個方法完成時不會傳回任何物件或值。

實作

M:Windows.Storage.FileProperties.IStorageItemExtraProperties.SavePropertiesAsync(System.Collections.Generic.IEnumerable{System.Collections.Generic.KeyValuePair{System.String,System.Object}}) M:Windows.Storage.FileProperties.IStorageItemExtraProperties.SavePropertiesAsync(System.Collections.Generic.IEnumerable{System.Collections.Generic.KeyValuePair{Platform::String,Platform::Object}}) M:Windows.Storage.FileProperties.IStorageItemExtraProperties.SavePropertiesAsync(System.Collections.Generic.IEnumerable{System.Collections.Generic.KeyValuePair{winrt::hstring,IInspectable}})
屬性

備註

System.ExpandoProperties

Expando 屬性是一組與記憶體中儲存體檔案實例相關聯的具名值。 它們不會持續儲存在檔案系統中,而是在存取快取中儲存檔案時保留。

它們可以由任何應用程式寫入和讀取,因此提供將資訊與儲存體檔案產生關聯的方式。 這在將儲存體檔案從一個應用程式傳遞到另一個應用程式以傳達該檔案的額外資訊的情況下很有用。

expando 屬性是使用 Windows 執行階段 儲存體 API 來存取。 它們會使用 RetrievePropertiesAsync 搭配 「System.ExpandoProperties」 屬性名稱來擷取為值。 expando 屬性是使用 SavePropertiesAsync 撰寫。 該值是屬性集本身,因此會使用 PropertySet 程式設計模型來存取其內的值。

用來識別 System.ExpandoProperties 集合中值的名稱不需要符合系統的屬性命名配置, (將屬性名稱前置詞為 「System」) 。 它們可以是任何字串值。

系統會定義應該使用的一些名稱。 例如,「OriginURL」 用來傳達從遠端來源下載本機儲存的檔案的來源。 (請參閱 自訂下載體驗。)

應用程式可以定義及記錄它們所使用的屬性,讓其他應用程式可以與其互通。 例如,System.ExpandoProperties 可用來允許提供者應用程式將授權資訊傳遞至通用 Office 應用程式,以指出檔案可以是個人或商務用。

另請參閱

適用於