ApplicationData.LocalSettings 속성

정의

네임스페이스:

Windows.Storage

로컬 앱 데이터 저장소의 애플리케이션 설정 컨테이너를 가져옵니다.

public:
 property ApplicationDataContainer ^ LocalSettings { ApplicationDataContainer ^ get(); };

ApplicationDataContainer LocalSettings();

public ApplicationDataContainer LocalSettings { get; }

var applicationDataContainer = applicationData.localSettings;

Public ReadOnly Property LocalSettings As ApplicationDataContainer

속성 값

ApplicationDataContainer

애플리케이션 설정 컨테이너입니다.

예제

LocalSettings 속성을 사용하여 ApplicationDataContainer 개체의 설정을 가져옵니다. ApplicationDataContainer.Values 속성을 사용하여 컨테이너의 설정에 localSettings 액세스합니다. 이 예제에서는 라는 exampleSetting설정을 만들고 읽습니다.

ApplicationDataContainerSettings.Remove 메서드를 호출하여 설정을 완료하면 삭제 exampleSetting 합니다.

RoamingSettings에 액세스하려면 의 발생 횟수 변경을 제외하고 예제에 설명된 것과 동일한 프로세스를 사용합니다.localSettingsroamingSettings

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

// Create a simple setting.
localSettings.Values["exampleSetting"] = "Hello Windows";

// Read data from a simple setting.
Object value = localSettings.Values["exampleSetting"];

if (value == null)
{
    // No data.
}
else
{
    // Access data in value.
}

// Delete a simple setting.
localSettings.Values.Remove("exampleSetting");

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

// Create a simple setting.
auto values{ localSettings.Values() };
values.Insert(L"exampleSetting", Windows::Foundation::PropertyValue::CreateString(L"Hello Windows"));

// Read data from a simple setting.
winrt::hstring value{ winrt::unbox_value<winrt::hstring>(values.Lookup(L"exampleSetting")) };

// Access data in value.

// Delete a simple setting.
values.Remove(L"exampleSetting");

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

// Create a simple setting.
auto values = localSettings->Values;
values->Insert("exampleSetting", dynamic_cast<PropertyValue^>(PropertyValue::CreateString("Hello Windows")));

// Read data from a simple setting.
String^ value = safe_cast<String^>(values->Lookup("exampleSetting"));

if (!value)
{
    // No data.
}
else
{
    // Access data in value.
}

// Delete a simple setting.
values->Remove("exampleSetting");

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

' Create a simple setting

localSettings.Values("exampleSetting") = "Hello Windows";

' Read data from a simple setting

Dim value As Object = localSettings.Values("exampleSetting")

If value Is Nothing Then
   ' No data
Else
   ' Access data in value
End If

' Delete a simple setting

localSettings.Values.Remove("exampleSetting")

설명

LocalSettings 및 RoamingSettings의 경우 각 설정의 이름은 최대 255자일 수 있습니다. 각 설정의 크기는 최대 8K 바이트이며 각 복합 설정은 크기는 최대 64K 바이트까지 가능합니다.

Windows 런타임 데이터 형식은 앱 설정에 대해 지원됩니다.

추가 정보

• 설정과 기타 앱 데이터의 저장 및 검색
• 콘텐츠 인덱서 샘플(Windows 10)