Open this page in the API Guide

IEntityService<T>.Save Method (T, String, Guid, EntityCreationOptions)

Saves the specified entity.

Namespace:  Dundas.BI.Entities
Assembly:  Dundas.BI.Core (in Dundas.BI.Core.dll) Version: 2.0.0.0 (24.4.0.1000)
Syntax
void Save(
	T instance,
	string name,
	Guid parentId,
	EntityCreationOptions? options
)

Parameters

instance
Type: T
The entity to save.
name
Type: System.String
The name of the entity.
parentId
Type: System.Guid
The ID of the parent.
options
Type: Dundas.BI.Entities.EntityCreationOptions
Options for saving the new entity; or null to use the default options.
Exceptions
ExceptionCondition
ArgumentException

name is null, empty, only consists of whitespace, or contains invalid characters.

-or-

parentId is Empty.

ArgumentNullExceptioninstance is null.
ArgumentOutOfRangeExceptionname is longer than MaxNameLength.
InvalidOperationExceptionThe entity has already been saved at least once.
NotFoundExceptionThe specified parent does not exist.
DuplicateItemException An item with the same name already exists in the specified location, the overwrite option has not been specified, and automatic name generation has not been specified.
QuotaExceededExceptionThe quota limit for the corresponding entity type was exceeded.
ReferencedItemException The overwrite or automatic name generation options have not been specified, and an item with the same name already exists at the specified location, but that item could not be automatically deleted because it is referenced by other items.
FeatureNotEnabledExceptionA required feature of the application is not enabled.
NoPrivilegeException

The caller does not have access to overwrite or save to the specified location.

-or-

The entity being saved is not a dashboard and the caller's seat kind is not PowerUser or better.

InvalidSessionExceptionThe caller context is not associated with a valid session.
Remarks
This overload is intended to be used for saving an entity which has never been saved before. After saving, the entity's properties (Id, LastModifiedTime, etc.) will be updated.
See Also