ApplicationDataCompositeValue Class

Stellt verknüpfte App-Einstellungen dar, die atomar serialisiert und deserialisiert werden müssen.

Syntax


public sealed class ApplicationDataCompositeValue : IPropertySet,
    IObservableMap<String, Object>,
    IDictionary<String, Object>,
    IEnumerable<KeyValuePair>

Attribute

[DualApiPartition()]
[MarshalingBehavior(Agile)]
[Threading(MTA)]
[Version(0x06020000)]

Member

Der ApplicationDataCompositeValueKlasse hat die folgenden Arten von Membern:

Konstruktoren

Der ApplicationDataCompositeValueKlasse hat die folgenden Konstruktoren:

KonstruktorBeschreibung
ApplicationDataCompositeValue Creates and initializes a new, initially empty, instance of the object.

 

Ereignisse

Der ApplicationDataCompositeValueKlasse hat die folgenden Ereignisse:

EreignisBeschreibung
MapChanged Occurs when the map changes.

 

Methoden

The ApplicationDataCompositeValue Klasse verfügt über die folgenden Methoden. Mit C#, Visual Basic und C++ erbt er außerdem Methoden von Object Klasse.

MethodeBeschreibung
Add(KeyValuePair) [C#, VB]Adds a new key-value pair to the ApplicationDataCompositeValue.
Add(String) [C#, VB]Adds an item to the ApplicationDataCompositeValue.
Clear Removes all application settings previously inserted into the composite value object, returning the object to its empty state.
Contains [C#, VB]Returns a value that indicates whether a specified key-value pair exists in the ApplicationDataCompositeValue.
ContainsKey [C#, VB]Returns a value that indicates whether a specified key exists in the ApplicationDataCompositeValue.
CopyTo [C#, VB]Copies the elements of the collection to an array, starting at a particular array index.
First [C++, JavaScript]Retrieves an iterator to enumerate the settings in the composite value.
GetView [C++, JavaScript]Returns a read-only snapshot of the contents of the composite value.
HasKey [C++, JavaScript]Determines whether there is an application setting with the specified key.
Insert [C++, JavaScript]Creates or replaces an application setting.
Lookup [C++, JavaScript]Retrieves the specified application setting.
Remove [C++, JavaScript]Removes the specified application setting.
Remove(KeyValuePair) [C#, VB]Removes a specific key-value pair from the ApplicationDataCompositeValue.
Remove(String) [C#, VB]Removes a specific item from the ApplicationDataCompositeValue.
TryGetValue [C#, VB]Returns a value that indicates whether a specified key exists in the ApplicationDataCompositeValue. If an item with that key exists, the item is retrieved as an out parameter.

 

Eigenschaften

ApplicationDataCompositeValueKlasse hat die folgenden Eigenschaften.

EigenschaftZugriffstypBeschreibung

Count [C#, VB]

SchreibgeschütztGets the number of elements contained in the collection.

IsReadOnly [C#, VB]

SchreibgeschütztGets a value indicating whether the dictionary is read-only.

Item [C#, VB]

Lese-/SchreibzugriffGets or sets the element value at the specified key index.

Keys [C#, VB]

SchreibgeschütztGets an ICollection object containing the keys of the ApplicationDataCompositeValue.

Size [C++, JavaScript]

SchreibgeschütztGets the number of related application settings.

Values [C#, VB]

SchreibgeschütztGets an ICollection object containing the values of the ApplicationDataCompositeValue .

 

Anmerkungen

Eine zusammengesetzte Einstellung wird serialisiert, indem sie in eine Einstellungszuordnung eingefügt wird, und deserialisiert, indem sie über die Zuordnung gesucht wird.

Auflistungsmemberlisten

Für JavaScript stellt ApplicationDataCompositeValue Unterstützung mithilfe eines Indexes bereit, mit dem auf Elemente zugegriffen werden kann.

Beispiele

Dieses Beispiel erstellt und liest eine zusammengesetzte Einstellung namens exampleCompositeSetting.

Rufen Sie die Remove | remove-Methode auf, um die Einstellung exampleCompositeSetting zu löschen, wenn Sie sie beendet haben.


Windows.Storage.ApplicationDataContainer localSettings = Windows.Storage.ApplicationData.Current.LocalSettings;

// Create a composite setting

Windows.Storage.ApplicationDataCompositeValue composite = new Windows.Storage.ApplicationDataCompositeValue();
composite["intVal"] = 1;
composite["strVal"] = "string";

localSettings.Values["exampleCompositeSetting"] = composite;

// Read data from a composite setting

Windows.Storage.ApplicationDataCompositeValue composite = 
   (Windows.Storage.ApplicationDataCompositeValue)localSettings.Values["exampleCompositeSetting"];

if (composite == null)
{
   // No data
}
else
{
   // Access data in composite["intVal"] and composite["strVal"]
}

// Delete a composite setting

localSettings.Values.Remove("exampleCompositeSetting");

Anforderungen

Unterstützte Mindestversion (Client)

Windows 8 [Windows Store-Apps, Desktop-Apps]

Unterstützte Mindestversion (Server)

Windows Server 2012 [Windows Store-Apps, Desktop-Apps]

Namespace

Windows.Storage
Windows::Storage [C++]

Metadaten

Windows.winmd

DLL

Windows.Storage.ApplicationData.dll

Weitere Informationen

Aufgaben
Schnellstart: Lokale Anwendungsdaten (JavaScript)
Schnellstart: Lokale Anwendungsdaten (C#/VB/C++)
Schnellstart: Roaminganwendungsdaten (JavaScript)
Schnellstart: Roaminganwendungsdaten (C#/VB/C++)
Konzepte
Übersicht über Anwendungsdaten
Verweis
ApplicationData
ApplicationDataContainer
ApplicationDataContainerSettings
Beispiele
Anwendungsdatenbeispiel

 

 

Anzeigen:
© 2014 Microsoft