Click or drag to resize
ProfileGetValue Method (String, String, String, String)
Retrieve a string value from the profile using the supplied subkey for the given Driver ID and variable name. Set and return the default value if the requested variable name has not yet been set.

Namespace: ASCOM.Utilities
Assembly: ASCOM.Utilities (in ASCOM.Utilities.dll) Version: 6.0.0.0 (6.3.0.2839)
Syntax
public string GetValue(
	string DriverID,
	string Name,
	string SubKey,
	string DefaultValue
)

Parameters

DriverID
Type: SystemString
ProgID of the device to read from
Name
Type: SystemString
Name of the variable whose value is retrieved
SubKey
Type: SystemString
Subkey from the profile root from which to read the value
DefaultValue
Type: SystemString
Default value to be used if there is no value currently set

Return Value

Type: String
Retrieved variable value
Exceptions
ExceptionCondition
InvalidValueExceptionThrown if DriverID is an empty string.
DriverNotRegisteredExceptionThrown if the driver is not registered,
Remarks

Name may be an empty string for the unnamed value. The unnamed value is also known as the "default" value for a registry key.

Does not provide access to other registry data types such as binary and doubleword.

If a default value is supplied and the value is not already present in the profile store, the default value will be set in the profile store and then returned as the value of the DriverID/SubKey/Name. If the default value is set to null (C#) or Nothing (VB) then no value will be set in the profile and an empty string will be returned as the value of the DriverID/SubKey/Name.

See Also