PreferencesStore.SetValue メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
基本設定ストア内の項目を削除、追加、または置換します。
オーバーロード
| SetValue(String, Boolean, Boolean) |
指定したブール値を使用して、基本設定ストア内の項目を削除、追加、または置換します。 |
| SetValue(String, Int32, Int32) |
指定した整数値を使用して、基本設定ストア内の項目を削除、追加、または置換します。 |
| SetValue(String, String, String) |
指定した文字列値を使用して、基本設定ストア内の項目を削除、追加、または置換します。 |
SetValue(String, Boolean, Boolean)
指定したブール値を使用して、基本設定ストア内の項目を削除、追加、または置換します。
public:
void SetValue(System::String ^ name, bool value, bool defaultValue);public void SetValue (string name, bool value, bool defaultValue);member this.SetValue : string * bool * bool -> unitPublic Sub SetValue (name As String, value As Boolean, defaultValue As Boolean)パラメーター
- name
- String
ストア アイテムの名前。
- value
- Boolean
名前付きストア アイテムに設定する値。
- defaultValue
- Boolean
リセット値インジケーター。
例外
name が null または空です。
例
次の例では、ストアにアイテムを bool 保存し、値を変更して、アイテムを削除します。
void TrcBoolVal(string name) {
PreferencesStore store = MyPrefStore;
bool b = store.ContainsValue(name);
Trace.WriteLine("ContainsValue(\"" + name + "\") : "
+ b.ToString());
if (b == false)
return;
bool myCnfgBoolVal = store.GetValue(name, false);
Trace.WriteLine(name + " Value: "
+ myCnfgBoolVal.ToString());
}
void TrcSetBool() {
PreferencesStore store = MyPrefStore;
string name = "MyBool";
store.SetValue(name, true, false);
TrcBoolVal(name);
store.SetValue(name, false, true);
TrcBoolVal(name);
store.SetValue(name, true, true);
TrcBoolVal(name);
}
注釈
valueパラメーターと defaultValue パラメーターが同じ場合、アイテムはストアから削除されます。
適用対象
SetValue(String, Int32, Int32)
指定した整数値を使用して、基本設定ストア内の項目を削除、追加、または置換します。
public:
void SetValue(System::String ^ name, int value, int defaultValue);public void SetValue (string name, int value, int defaultValue);member this.SetValue : string * int * int -> unitPublic Sub SetValue (name As String, value As Integer, defaultValue As Integer)パラメーター
- name
- String
ストア アイテムの名前。
- value
- Int32
名前付きストア アイテムに設定する値。
- defaultValue
- Int32
リセット値インジケーター。
例外
name が null または空です。
例
次の例では、ストアにアイテムを int 保存し、値を変更して、アイテムを削除します。
void TrcVal(string name, int defVal) {
PreferencesStore store = MyPrefStore;
bool b = store.ContainsValue(name);
if (b == false)
Trace.WriteLine(name + " is not in store");
int intVal = store.GetValue(name, defVal);
Trace.WriteLine(name + " Value = "
+ intVal.ToString());
}
void TrcSetInt() {
PreferencesStore store = MyPrefStore;
string name = "MyInt";
store.SetValue(name, 12, 321);
TrcVal(name, 45678);
store.SetValue(name, 321, 12);
TrcVal(name, 45678);
store.SetValue(name, 12, 12);
TrcVal(name, 45678);
}
注釈
valueパラメーターと defaultValue パラメーターが同じ場合、このメソッドはストアから項目を削除します。
適用対象
SetValue(String, String, String)
指定した文字列値を使用して、基本設定ストア内の項目を削除、追加、または置換します。
public:
void SetValue(System::String ^ name, System::String ^ value, System::String ^ defaultValue);public void SetValue (string name, string value, string defaultValue);member this.SetValue : string * string * string -> unitPublic Sub SetValue (name As String, value As String, defaultValue As String)パラメーター
- name
- String
ストア アイテムの名前。
- value
- String
名前付きストア アイテムに設定する値。
- defaultValue
- String
リセット値インジケーター。
例外
nameまたは value パラメーターが または 空ですnull。
例
次の例では、文字列アイテムをストアに保存し、値を変更して、アイテムを削除します。
void TrcVal(string name, string strDefault) {
PreferencesStore store = MyPrefStore;
bool b = store.ContainsValue(name);
if (b == false)
Trace.WriteLine(name + " Not in store");
string strVal = store.GetValue(name, strDefault);
Trace.WriteLine(name + "Value = \""
+ strVal + "\"");
}
void TrcSetStrng() {
PreferencesStore store = MyPrefStore;
string name = "MyString";
string sA = "abc";
string sX = "X-12345";
string sDefault = "My Default String";
store.SetValue(name, sA, sX);
TrcVal(name, sDefault);
store.SetValue(name, sX, sA);
TrcVal(name, sDefault);
store.SetValue(name, sA, sA);
TrcVal(name, sDefault);
}
注釈
valueパラメーターと defaultValue パラメーターが同じ場合、アイテムはストアから削除されます。