PreferencesStore.GetValue Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets the value portion of the specified name/value pair from the preference store.
Overloads
GetValue(String, Boolean) |
Gets the value portion of the specified name/value pair from the preference store, using the specified default Boolean value. |
GetValue(String, Int32) |
Gets the value portion of the specified name/value pair from the preference store, using the specified default integer value. |
GetValue(String, String) |
Gets the value portion of the specified name/value pair from the preference store, using the specified default string value. |
GetValue(String, Boolean)
Gets the value portion of the specified name/value pair from the preference store, using the specified default Boolean value.
public:
bool GetValue(System::String ^ name, bool defaultValue);
public bool GetValue (string name, bool defaultValue);
member this.GetValue : string * bool -> bool
Public Function GetValue (name As String, defaultValue As Boolean) As Boolean
Parameters
- name
- String
The name of the preference store item.
- defaultValue
- Boolean
The value to return if the named preference store item is not found.
Returns
The value of the named preference store item, if found; otherwise, the value of the defaultValue
parameter.
Exceptions
name
is null
or empty.
Examples
The following example writes the value of the named preference store item to the trace listener.
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 + "\"");
}
Applies to
GetValue(String, Int32)
Gets the value portion of the specified name/value pair from the preference store, using the specified default integer value.
public:
int GetValue(System::String ^ name, int defaultValue);
public int GetValue (string name, int defaultValue);
member this.GetValue : string * int -> int
Public Function GetValue (name As String, defaultValue As Integer) As Integer
Parameters
- name
- String
The name of the preference store item.
- defaultValue
- Int32
The value to return if the named preference store item is not found.
Returns
The value of the named preference store item, if found; otherwise, the value of the defaultValue
parameter.
Exceptions
name
is null
or empty.
Examples
The following example writes the value of the named preference store item to the trace listener.
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());
}
Applies to
GetValue(String, String)
Gets the value portion of the specified name/value pair from the preference store, using the specified default string value.
public:
System::String ^ GetValue(System::String ^ name, System::String ^ defaultValue);
public string GetValue (string name, string defaultValue);
member this.GetValue : string * string -> string
Public Function GetValue (name As String, defaultValue As String) As String
Parameters
- name
- String
The name of the preference store item.
- defaultValue
- String
The value to return if the named preference store item is not found.
Returns
The value of the named preference store item, if found; otherwise, the value of the defaultValue
parameter.
Exceptions
name
is null
or empty.
Examples
The following example writes "This name is not in the store" Value = "My Default Val"
to the trace listener.
PreferencesStore store = MyPrefStore;
string name = "This name is not in the store";
bool b = store.ContainsValue(name);
if (b == true)
throw new NotImplementedException(
name + " was not expected to be found"
);
string strVal = store.GetValue(name, "My Default Val");
Trace.WriteLine("\"" + name + "\" Value = \""
+ strVal + "\"");
The following example writes the value of the named preference store item to the trace listener.
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 + "\"");
}