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.3.0.1000)

Syntax

Guid CopyEntry(
	Guid entryId,
	Guid targetId,
	string? newName,
	EntryCreationOptions? options,
	out IDictionary<Guid, Guid> idMapping
)

Function CopyEntry ( 
	entryId As Guid,
	targetId As Guid,
	newName As String,
	options As EntryCreationOptions,
	<OutAttribute> ByRef idMapping As IDictionary(Of Guid, Guid)
) As Guid

Guid CopyEntry(
	Guid entryId, 
	Guid targetId, 
	String^ newName, 
	EntryCreationOptions^ options, 
	[OutAttribute] IDictionary<Guid, Guid>^% idMapping
)

abstract CopyEntry : 
        entryId : Guid * 
        targetId : Guid * 
        newName : string * 
        options : EntryCreationOptions * 
        idMapping : IDictionary<Guid, Guid> byref -> Guid

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

Exception	Condition
ArgumentException	entryId is Empty. -or- targetId is Empty. -or- newName is empty, only consists of whitespace, or contains invalid characters.
ArgumentOutOfRangeException	newName is longer than MaxNameLength.
NotFoundException	At 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).
InvalidSessionException	The 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.

Reference

IFileSystemService Interface

CopyEntry Overload

Dundas.BI.FileSystem Namespace