StorageItemContentProperties.SavePropertiesAsync Methode

Definition

Namespace:

Windows.Storage.FileProperties

Überlädt

SavePropertiesAsync()	Speichert alle dem Element zugeordneten Eigenschaften.
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	Speichert die angegebenen Eigenschaften und Werte, die dem Element zugeordnet sind.

SavePropertiesAsync()

Speichert alle dem Element zugeordneten Eigenschaften.

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

Gibt zurück

IAsyncAction

Nach Abschluss dieser Methode wird kein Objekt oder Wert zurückgegeben.

Implementiert

SavePropertiesAsync()

Attribute

OverloadAttribute RemoteAsyncAttribute

Hinweise

Wenn einer der Eigenschaftswerte ungültig ist, wird keiner der Werte gespeichert.

Weitere Informationen

• StorageItemContentProperties
• SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)

Speichert die angegebenen Eigenschaften und Werte, die dem Element zugeordnet sind.

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

Parameter

propertiesToSave

IIterable<IKeyValuePair<String,Object>>

IEnumerable<KeyValuePair<String,Object>>

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

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

Eine Auflistung, die die Namen und Werte der Eigenschaften enthält, die als Schlüssel-Wert-Paare gespeichert werden sollen (Typ IKeyValuePair).

Gibt zurück

IAsyncAction

Nach Abschluss dieser Methode wird kein Objekt oder Wert zurückgegeben.

Implementiert

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}})

Attribute

OverloadAttribute

Hinweise

System.ExpandoProperties

Expando-Eigenschaften sind eine Gruppe benannter Werte, die einer Speicherdatei instance im Arbeitsspeicher zugeordnet sind. Sie werden nicht dauerhaft im Dateisystem gespeichert, sondern werden beibehalten, wenn eine Datei im Zugriffscache gespeichert wird.

Sie können von jeder App geschrieben und gelesen werden und bieten daher eine Möglichkeit, Informationen einer Speicherdatei zuzuordnen. Dies ist nützlich in Szenarien, in denen eine Speicherdatei von einer App an eine andere übergeben wird, um zusätzliche Informationen zu dieser Datei zu kommunizieren.

Auf Expando-Eigenschaften wird mithilfe der Windows-Runtime-Speicher-API zugegriffen. Sie werden als Wert mithilfe von RetrievePropertiesAsync mit dem Eigenschaftennamen "System.ExpandoProperties" abgerufen. Die expando-Eigenschaften werden mithilfe von SavePropertiesAsync geschrieben. Dieser Wert ist eine Eigenschaft, die selbst festgelegt ist, sodass auf die darin enthaltenen Werte mithilfe des PropertySet-Programmiermodells zugegriffen wird.

Die Namen, die zum Identifizieren von Werten im System.ExpandoProperties-Satz verwendet werden, müssen nicht dem Eigenschaftennamensschema des Systems entsprechen (das Eigenschaftennamen mit "System" präfixiert). Dabei kann es sich um einen beliebigen Zeichenfolgenwert handeln.

Das System definiert einige der Namen, die verwendet werden sollen. Beispielsweise wird "OriginURL" verwendet, um zu kommunizieren, wo eine lokal gespeicherte Datei stammt, wenn sie von einer Remotequelle heruntergeladen wurde. (Siehe Anpassen der Downloadumgebung.)

Apps können die von ihnen verwendeten Eigenschaften definieren und dokumentieren, damit andere Anwendungen mit ihnen zusammenarbeiten können. Beispielsweise kann System.ExpandoProperties verwendet werden, damit eine Anbieter-App Lizenzinformationen an eine Universal Office-App übergeben kann, um anzugeben, ob eine Datei persönlich oder geschäftlich sein kann.

Weitere Informationen

• StorageItemContentProperties
• SavePropertiesAsync()
• IKeyValuePair<K,V>
• System.Dynamic.ExpandoObject