IFileSystemServiceCopyEntry Method (Guid, Guid, String, EntryCreationOptions, IDictionaryGuid, Guid)

Creates a copy of the entry with the specified ID.

Namespace:  Dundas.BI.FileSystem
Assembly:  Dundas.BI.Core (in Dundas.BI.Core.dll) Version: 2.0.0.0 (24.4.0.1000)
Syntax
Guid CopyEntry(
	Guid entryId,
	Guid targetId,
	string? newName,
	EntryCreationOptions? options,
	out IDictionary<Guid, Guid> idMapping
)

Parameters

entryId
Type: SystemGuid
The ID of the entry to copy.
targetId
Type: SystemGuid
The ID of the target.
newName
Type: SystemString
The name to use for the copy (specify to use the same name as the original).
options
Type: Dundas.BI.FileSystemEntryCreationOptions
Options for creating the copy; or to use the default options.
idMapping
Type: System.Collections.GenericIDictionaryGuid, Guid
When this method returns, contains the mapping between any IDs that have changed between the original item and the copy.

Return Value

Type: Guid
The ID of the copy.
Exceptions
ExceptionCondition
ArgumentException

entryId is Empty.

-or-

targetId is Empty.

-or-

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

ArgumentOutOfRangeExceptionnewName is longer than MaxNameLength.
NotFoundExceptionAt least one of entryId and targetId represents an entry which does not exist.
DuplicateItemException An entry with the specified name already exists in the target and both Overwrite and AutoGenerateName are .
InvalidOperationException

Copying entries of the type corresponding to entryId into entries of the type corresponding to targetId is not supported (error code 2200).

-or-

The original entry is being copied as a subentry of an item which is not checked out to the caller.

-or-

The original entry is being copied to itself.

NoPrivilegeException

The caller does not have the Read permission on one or more of the entries being copied.

-or-

The caller does not have permission to create items in the specified target entry.

-or-

Overwrite is , an entry with the same name already exists in the specified target, and the caller does not have the Delete privilege on the entry which needs to be overwritten (and/or one of its children).

InvalidSessionExceptionThe caller context is not associated with a valid session.
Remarks
If the specified entry is transient and a subentry, and the copy is not a subentry, the copy will not be transient.
See Also