ApplicationDataCompositeValue Class

Représente les paramètres d'application associés qui doivent être sérialisés et désérialisés de façon atomique.

Syntaxe


var applicationDataCompositeValue = new Windows.Storage.ApplicationDataCompositeValue();

Attributs

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

Membres

ApplicationDataCompositeValueClasse comporte les types de membres suivants :

Constructeurs

ApplicationDataCompositeValueClasse comporte les constructeurs suivants.

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

 

Événements

ApplicationDataCompositeValueClasse comporte les événements suivants.

ÉvénementDescription
MapChanged Occurs when the map changes.

 

Méthodes

The ApplicationDataCompositeValue Classe comporte les méthodes suivantes. Avec C#, Visual Basic et C++, il hérite également des méthodes de Object Classe.

MéthodeDescription
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.

 

Propriétés

ApplicationDataCompositeValueClasse contient les propriétés suivantes.

PropriétéType d’accèsDescription

Count [C#, VB]

Lecture seuleGets the number of elements contained in the collection.

IsReadOnly [C#, VB]

Lecture seuleGets a value indicating whether the dictionary is read-only.

Item [C#, VB]

Lecture/écritureGets or sets the element value at the specified key index.

Keys [C#, VB]

Lecture seuleGets an ICollection object containing the keys of the ApplicationDataCompositeValue.

Size [C++, JavaScript]

Lecture seuleGets the number of related application settings.

Values [C#, VB]

Lecture seuleGets an ICollection object containing the values of the ApplicationDataCompositeValue .

 

Remarques

Une configuration composite est sérialisée par insertion dans un mappage de paramètres et désérialisation en effectuant une recherche à partir du mappage.

Liste des membres de la collection

En JavaScript, ApplicationDataCompositeValue prend en charge l'utilisation d'un index pour accéder aux éléments.

Exemples

Cet exemple crée et lit une configuration composite nommée exampleCompositeSetting.

Appelle la méthode Remove | remove pour supprimer le paramètre exampleCompositeSetting lorsque vous n'en avez plus besoin.


var applicationData = Windows.Storage.ApplicationData.current;

var localSettings = applicationData.localSettings;

// Create a composite setting

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

localSettings.values["exampleCompositeSetting"] = composite;

// Read data from a composite setting

var composite = localSettings.values["exampleCompositeSetting"];

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

// Delete a composite setting

localSettings.values.remove("exampleCompositeSetting");

Configuration requise

Client minimal pris en charge

Windows 8 [Applications du Windows Store, applications de bureau]

Serveur minimal pris en charge

Windows Server 2012 [Applications du Windows Store, applications de bureau]

Espace de noms

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

Métadonnées

Windows.winmd

DLL

Windows.Storage.ApplicationData.dll

Voir aussi

Tâches
Démarrage rapide : données des applications locales (JavaScript)
Démarrage rapide : données des applications locales (C#/VB/C++)
Démarrage rapide : données des applications itinérantes (JavaScript)
Démarrage rapide : données d'application itinérantes (C#/VB/C++)
Concepts
Présentation des données de l'application
Référence
ApplicationData
ApplicationDataContainer
ApplicationDataContainerSettings
Exemples
Exemple de données d'application

 

 

Afficher:
© 2014 Microsoft