Open this page in the API Guide

IAppConfigService.SetValue 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 (25.1.0.1000)
Syntax
Copy
void SetValue(
	Guid settingId,
	AppSettingScope scope,
	Object? scopeTarget,
	Object? value
)

Parameters

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

settingId is Empty.

-or-

scope is Effective.

-or-

scope is Server and scopeTarget is empty, null, 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 true 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 null, then the effective value will be inherited from a higher scope. If the value of the setting is null in the highest scope Global), the effective value will be the setting's default.
See Also