ApplicationDataContainer Clase

Definición

Espacio de nombres:

Windows.Storage

Representa un contenedor para la configuración de la aplicación. Los métodos y propiedades de esta clase admiten la creación, eliminación, enumeración y recorrido de la jerarquía de contenedores.

public ref class ApplicationDataContainer sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ApplicationDataContainer final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ApplicationDataContainer : System.IDisposable

Public NotInheritable Class ApplicationDataContainer
Implements IDisposable

Herencia

Object Platform::Object IInspectable ApplicationDataContainer

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

IClosable IDisposable

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

Llame al método ApplicationDataContainer.CreateContainer para crear un contenedor de configuración o para devolver un contenedor existente. En este ejemplo se crea un contenedor de configuración denominado exampleContainer y se agrega una configuración denominada exampleSetting. El valor Always de la enumeración ApplicationDataCreateDisposition indica que el contenedor debe crearse si aún no existe.

Use la propiedad ApplicationDataContainer.Values para tener acceso a la exampleSetting configuración del exampleContainer contenedor.

Llame al método ApplicationDataContainer.DeleteContainer para eliminar el exampleContainer contenedor de configuración cuando haya terminado con él.

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

// Create a setting in a container

Windows.Storage.ApplicationDataContainer container = 
   localSettings.CreateContainer("exampleContainer", Windows.Storage.ApplicationDataCreateDisposition.Always);

if (localSettings.Containers.ContainsKey("exampleContainer"))
{
   localSettings.Containers["exampleContainer"].Values["exampleSetting"] = "Hello, Windows!";
}

// Read data from a setting in a container

bool hasContainer = localSettings.Containers.ContainsKey("exampleContainer");
bool hasSetting = false;

if (hasContainer)
{
   hasSetting = localSettings.Containers["exampleContainer"].Values.ContainsKey("exampleSetting");
}

// Delete a container

localSettings.DeleteContainer("exampleContainer");

Windows::Storage::ApplicationDataContainer localSettings{
    Windows::Storage::ApplicationData::Current().LocalSettings() };

// Create a setting in a container.
Windows::Storage::ApplicationDataContainer container{
    localSettings.CreateContainer(L"exampleContainer", Windows::Storage::ApplicationDataCreateDisposition::Always) };

if (localSettings.Containers().HasKey(L"exampleContainer"))
{
    auto values{ localSettings.Containers().Lookup(L"exampleContainer").Values() };
    values.Insert(L"exampleSetting", winrt::box_value(L"Hello, Windows!"));
}

// Read data from a setting in a container.
bool hasContainer{ localSettings.Containers().HasKey(L"exampleContainer") };
bool hasSetting{ false };

if (hasContainer)
{
    auto values{ localSettings.Containers().Lookup(L"exampleContainer").Values() };
    hasSetting = values.HasKey(L"exampleSetting");
}

// Delete a container.
localSettings.DeleteContainer(L"exampleContainer");

ApplicationDataContainer^ localSettings = ApplicationData::Current->LocalSettings;

// Create a setting in a container

ApplicationDataContainer^ container = 
   localSettings->CreateContainer("exampleContainer", ApplicationDataCreateDisposition::Always);

if (localSettings->Containers->HasKey("exampleContainer"))
{
   auto values = localSettings->Containers->Lookup("exampleContainer")->Values;
   values->Insert("exampleSetting", "Hello, Windows!");
}

// Read data from a setting in a container

bool hasContainer = localSettings->Containers->HasKey("exampleContainer");
bool hasSetting = false;

if (hasContainer)
{
   auto values = localSettings->Containers->Lookup("exampleContainer")->Values;
   hasSetting = values->HasKey("exampleSetting");
}

// Delete a container

localSettings->DeleteContainer("exampleContainer");

Dim localSettings As Windows.Storage.ApplicationDataContainer = Windows.Storage.ApplicationData.Current.LocalSettings

' Create a setting in a container

Dim container As Windows.Storage.ApplicationDataContainer = 
   localSettings.CreateContainer("exampleContainer", Windows.Storage.ApplicationDataCreateDisposition.Always)

If localSettings.Containers.ContainsKey("exampleContainer") Then
    localSettings.Containers("exampleContainer").Values("exampleSetting") = "Hello, Windows!"
End If

' Read data from a setting in a container

Dim hasContainer As Boolean = localSettings.Containers.ContainsKey("exampleContainer")
Dim hasSetting As Boolean = False

If hasContainer Then
    hasSetting = localSettings.Containers("exampleContainer").Values.ContainsKey("exampleSetting")
End If

' Delete a container

localSettings.DeleteContainer("exampleContainer")

Comentarios

Nota:

No hay ningún contenedor de configuración para el almacén de datos de la aplicación temporal.

La propiedad Values obtiene un objeto ApplicationDataContainerSettings que proporciona acceso a la configuración almacenada en el contenedor.

Propiedades

Containers	Obtiene los contenedores de configuración de la aplicación secundarios de este contenedor de configuración de la aplicación.
Locality	Obtiene el tipo (local o móvil) del almacén de datos de la aplicación asociado al contenedor de configuración actual.
Name	Obtiene el nombre del contenedor de configuración actual.
Values	Obtiene un objeto que representa la configuración de este contenedor de configuración.

Métodos

Close()	Nota: Este miembro no se implementa en C#.
CreateContainer(String, ApplicationDataCreateDisposition)	Crea o abre el contenedor de configuración especificado en el contenedor de configuración actual.
DeleteContainer(String)	Elimina el contenedor de configuración especificado, sus subcontenedores y todas las configuraciones de la aplicación de la jerarquía.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.

Consulte también

• ApplicationData
• ApplicationDataCompositeValue
• ApplicationDataContainerSettings
• Almacenar y recuperar la configuración y otros datos de aplicación
• Application data sample (ejemplo de datos de aplicaciones)