ApplicationDataContainer.CreateContainer | createContainer Method

Crée ou ouvre le conteneur de paramètres spécifié dans le conteneur de paramètres actuel.

Syntaxe


var applicationDataContainer = applicationDataContainer.createContainer(name, disposition);

Paramètres

name

Type: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Nom du conteneur.

disposition

Type: ApplicationDataCreateDisposition

L'une des valeurs de l'énumération.

Valeur de retour

Type: ApplicationDataContainer

Conteneur de paramètres.

Remarques

Windows Phone 8

Cette API n'est pas implémentée et lève une exception si elle est appelée. Consultez API de runtime Windows Phone.

Exemples

Appelle la méthode ApplicationDataContainer.CreateContainer | createContainer pour créer un conteneur de paramètres. Cet exemple crée un conteneur de paramètres nommé exampleContainer et ajoute un paramètre nommé exampleSetting. La valeur Always | always de l'énumération ApplicationDataCreateDisposition indique que le conteneur doit être créé s'il n'existe pas.

Utilisez la propriété ApplicationDataContainer.Values | values pour accéder au paramètre exampleSetting dans le conteneur exampleContainer.

Appelez la méthode ApplicationDataContainer.DeleteContainer | deleteContainer pour supprimer le conteneur de paramètres exampleContainer lorsque vous n'en avez plus besoin.


var applicationData = Windows.Storage.ApplicationData.current;

var localSettings = applicationData.localSettings;

// Create a setting in a container

var container = localSettings.createContainer("exampleContainer", 
    Windows.Storage.ApplicationDataCreateDisposition.Always);

if (localSettings.containers.hasKey("exampleContainer"))
{
    localSettings.containers.lookup("exampleContainer").values["exampleSetting"] = "Hello Windows";
}

// Read data from a setting in a container

var hasContainer = localSettings.containers.hasKey("exampleContainer");

if (hasContainer)
{
    // Access data in: 
    //   localSettings.containers.lookup("exampleContainer").values.hasKey("exampleSetting");
}

// Delete a container

localSettings.deleteContainer("exampleContainer");

Configuration requise

Client minimal pris en charge

Windows 8

Serveur minimal pris en charge

Windows Server 2012

Téléphone minimal pris en charge

Windows Phone 8 [non implémenté, voir Remarques]

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 des applications itinérantes (C#/VB/C++)
Concepts
Présentation des données de l'application
Référence
ApplicationDataContainer

 

 

Afficher:
© 2014 Microsoft