ApplicationDataContainer 클래스

정의

네임스페이스:

Windows.Storage

앱 설정에 대한 컨테이너를 나타냅니다. 이 클래스의 메서드 및 속성은 컨테이너 계층 구조 만들기, 삭제, 열거 및 트래버스를 지원합니다.

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

상속

Object Platform::Object IInspectable ApplicationDataContainer

특성

ContractVersionAttribute MarshalingBehaviorAttribute

구현

IClosable IDisposable

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

ApplicationDataContainer.CreateContainer 메서드를 호출하여 설정 컨테이너를 만들거나 기존 컨테이너를 반환합니다. 이 예제에서는 라는 설정 컨테이너를 만들고 라는 exampleContainerexampleSetting설정을 추가합니다. ApplicationDataCreateDisposition 열거형의 Always 값은 컨테이너가 아직 없는 경우 컨테이너를 만들어야 했음을 나타냅니다.

ApplicationDataContainer.Values 속성을 사용하여 컨테이너의 exampleSetting 설정에 exampleContainer 액세스합니다.

ApplicationDataContainer.DeleteContainer 메서드를 호출하여 설정 컨테이너를 완료하면 삭제 exampleContainer 합니다.

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

설명

참고

임시 앱 데이터 저장소에 대한 설정 컨테이너가 없습니다.

Values 속성은 컨테이너에 저장된 설정에 대한 액세스를 제공하는 ApplicationDataContainerSettings 개체를 가져옵니다.

속성

Containers	이 애플리케이션 설정 컨테이너의 자식 애플리케이션 설정 컨테이너를 가져옵니다.
Locality	현재 설정 컨테이너와 연결된 앱 데이터 저장소의 형식(로컬 또는 로밍)을 가져옵니다.
Name	현재 설정 컨테이너의 이름을 가져옵니다.
Values	이 설정 컨테이너의 설정을 나타내는 개체를 가져옵니다.

메서드

Close()	참고 이 멤버는 C#에서 구현되지 않습니다.
CreateContainer(String, ApplicationDataCreateDisposition)	현재 설정 컨테이너에서 지정된 설정 컨테이너를 만들거나 엽니다.
DeleteContainer(String)	계층에서 지정된 설정 컨테이너, 해당 하위 컨테이너 및 모든 애플리케이션 설정을 삭제합니다.
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.

추가 정보

• ApplicationData
• ApplicationDataCompositeValue
• ApplicationDataContainerSettings
• 설정과 기타 앱 데이터의 저장 및 검색
• 애플리케이션 데이터 샘플