IAppConfigServiceSetValue Method

Sets the value of a configuration setting.

Namespace:  Dundas.BI.Configuration
Assembly:  Dundas.BI.Core (in Dundas.BI.Core.dll) Version: 2.0.0.0 (24.3.0.1000)
Syntax
void SetValue(
	Guid settingId,
	AppSettingScope scope,
	Object? scopeTarget,
	Object? value
)

Parameters

settingId
Type: SystemGuid
The ID of the setting.
scope
Type: Dundas.BI.ConfigurationAppSettingScope
The scope to which the value applies.
scopeTarget
Type: SystemObject
The server name or server group ID (ignored if scope is not Server or ServerGroup).
value
Type: SystemObject
The new value for the setting, or to fall back (see remarks).
Exceptions
ExceptionCondition
ArgumentException

settingId is Empty.

-or-

scope is Effective.

-or-

scope is Server and scopeTarget is empty, , or not a String.

-or-

scope is ServerGroup and scopeTarget is less than or equal to zero, or not an Int64.

-or-

value could not be converted to the setting's type.

ArgumentOutOfRangeExceptionscope is not one of the AppSettingScope values.
ValidationExceptionvalue does not satisfy the setting's validation rule.
NotFoundExceptionThere was no registered setting corresponding to the provided setting ID.
InvalidOperationExceptionIsOnlyGlobal is for the setting, but scope is not Global.
NoPrivilegeException

The caller does not have system administrative privileges.

-or-

The setting is read-only.

InvalidSessionExceptionThe caller context is not associated with a valid session.
Remarks
If the value of the setting is , then the effective value will be inherited from a higher scope. If the value of the setting is in the highest scope Global), the effective value will be the setting's default.
See Also