UserGroupController Class

Connection string for the database. Can be null.

DbCommandTimeout is applied to SqlCommand objects created using CreateSqlCommand(). The DbCommandTimeout value is (normally) passed on to other controllers created by the controller. If DbCommandTimeout is Zero then the DB default will be used as timeout.

Consider using CreateCommand() instead of accessing DbConnection directly. DbConnection and DbTransaction are either specified when constucting the controller or the controller constructs them itself (by using ConnectionString) when calling DoInConnection or DoInTransaction. If the caller specified DbConnection and DbTransaction when constucting the controller then the caller is responsible for the management of the connection.

Consider using CreateCommand() instead of accessing DbTransaction directly. DbConnection and DbTransaction are either specified when constucting the controller or the controller constructs them itself (by using ConnectionString) when calling DoInConnection or DoInTransaction. If the caller specified DbConnection and DbTransaction when constucting the controller then the caller is responsible for the management of the connection.

Factory class for creating controller instances.

Adds a user to a group. Must not be called for Everyone or for personal groups.

Builds a cache key for use with GetFromCacheIfPresent. The cache key is not hashed because we have experienced a collision using GetHashCode() ie. the cache keys are quite long and there is a price in dictionary size in memory and in dictionary lookups.

Checks that the active user is allowed to perform an CRUD operation on a specific configuration object. (note: except that a Create operation is not for a specific object). Throws a SecurityException if not. Method can be used for all configuration objects that are represented by a ConfigurationObjectType (except those that have a compound key). Method checks auth role security as well as whether it is allowed to modify builtin/feature package objects.

Checks that the active user is allowed to Create a new - or Update an existing configuration object. Throws a SecurityException if not. Method can be used for all configuration objects that are represented by a ConfigurationObjectType (except those that have a compound key). Method checks auth role security as well as whether it is allowed to modify builtin/feature package objects.

Converts the integer id of an object to its transport-safe unique id (UId).

Converts a string representation of an integer or Guid id to an integer id.

Converts the transport-safe unique id (UId) of an object to its integer id.

Converts the transport-safe unique ids (UId) of a number of objects to integer ids.

Converts the integer ids of a number of objects to their transport-safe unique ids (UId).

Create a new SqlBulkCopy instance using the connection, transaction and timeout values from the controller

Executes an action that doesn't return a result. If no current connection exists, it will establish a connection to the database and close it afterwards. An existing connection will be reused. Inside the action, the connection is available as DbConnection.

Executes an action that doesn't return a result. If no current connection exists, it will establish a connection to the database and close it afterwards. Connection and Transaction are passed to delegate, to allow passing to other controllers An existing connection will be reused. Inside the action, the connection is available as DbConnection. To ensure a new connection set forceNew to true.

Executes an action and returns the result. If no current connection exists, it will establish a connection to the database and close it afterwards. An existing connection will be reused. Inside the action, the connection is available as DbConnection.

Executes an action (that doesn't return a result) in a transaction. If no current connection and/or transaction exists, it will establish it and commit and close it afterwards. An existing connection/transaction will be reused. Inside the action, the connection is available as DbConnection and the transaction as DbTransaction.

Executes an action in a transaction and returns the result. If no current connection and/or transaction exists, it will establish it and commit and close it afterwards. An existing connection/transaction will be reused. Inside the action, the connection is available as DbConnection and the transaction as DbTransaction.

Executes an action in a transaction and returns the result. Connection and Transaction are passed to delegate, to allow passing to other controllers If no current connection and/or transaction exists, it will establish it and commit and close it afterwards. An existing connection/transaction will be reused. Set forceNew to true to ensure new connection and transaction Inside the action, the connection is available as DbConnection and the transaction as DbTransaction.

The method can postpone a SQL transaction implemented by action if the method returns a default number, eg. 0. If the the action method throws a SQL transitent error, then the next call to action is also postponed.

The method can postpone a method invocation if the previous call returned a default number, eg. 0.

Executes a query with a scalar result.

(Inherited from ControllerBase.)

Retrieves some data from the cache or (if it is not there) executes an action and stores the result in the cache. Caching is not applied if the IgnoreCacheContext is used (depending on the parameter for it). Note: caching should only be used with great care as there are a number of potential issues involved in using it!

Returns the auth roles that a number of groups are assigned to.

Returns the users that are member of at least one of the specified user groups. Members are not returned if they are deleted. Members are not returned if they are system users. Security is not considered!

Returns the users that are member of at least one of the specified user groups. Members are not returned if they are deleted. Members are not returned if they are system users. Security is not considered!

Returns the users that are member of at least one of the specified user groups. Members are not returned if they are deleted. Members are not returned if they are system users. Security is not considered!

Returns groups (ids) and their members

Gets the data version of an object.

Returns the U(nique)Ids of one or more user groups from their Ids. The UId of a user group remains the same when it is transported to another system. This is not the case with the Id of a user group. The method doesn't consider the security model. The method doesn't consider whether the data object is marked as deleted.

Returns the U(nique)Ids of one or more user groups from their Ids. The UId of a user group remains the same when it is transported to another system. This is not the case with the Id of a user group. The method doesn't consider the security model. The method doesn't consider whether the data object is marked as deleted.

Returns the id of a group from its name.

Returns the users that are member of at least one of the specified user groups. Members are not returned if they are deleted.

Returns the userid's of the members in a usergroup. Deleted users are not returned.

Returns a distinct list of ids of auth roles that are held by a number of user groups.

Returns a number of user group objects. The loadoptions can be used to specify additional load options - except IdPosList.

Returns a number of user group objects. The loadoptions can be used to specify additional load options - except IdPosList.

(Inherited from ControllerBase.)

Increments the data version of an entity object. The data version is incremented in the db as well as on the object itself. Method is used to update the data version of an object when an aggregated object is created/modified/deleted. The purpose is to ensure that the id-based cache (in AppIdentity) is updated properly.

Increments the data version of an entity object in the db. Method is used to update the data version of an object when an aggregated object is created/modified/deleted. The purpose is to ensure that the id-based cache (in AppIdentity) is updated properly.

Returns true if the stated user is member of the stated group.

Returns true if the stated user is member of the stated group.

Deletes the specified usergroup by setting a marker.

Deletes the specified usergroup by setting a marker.

Creates a temporary db table with a single column and populates it with values.

If the action throws a transient sql error, the exception is eaten. An entry is written to the log with level Information. The entire exception is written to the log with level Debug.

Removes group memberships for all inactive users.

Stores the group memberships of a user based the Groups collection. Existing group memberships not available in Groups are removed. The memberhip of personal user groups and everyone are never removed.

Converts/transfers one or more specified uids in a loadoptions object to ids. The purpose is to enable caching as IEntityObjectsLoadOptions.IdList only works with ids (and not uids).

Translates personal group ids to user ids.

Returns the ids of all users who are member of at least one of the specified groups.

Returns the ids of all users who are member of at least one of the specified groups.

Validates that the data version of an object corresponds to the data version in the DB. Method is used for validation before saving an object.

Converts object to boolean.

Converts object to DateTime.

Converts object to integer.