CategoryManagerRelocate Method Content Studio 5.7 SDK
Content Studio Web Content Management System

[This is preliminary documentation and is subject to change.]

Relocates a category from one unit or category to another category or unit

Namespace: ContentStudio.Document
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)
Syntax
Copy
public void Relocate(
	ConnectionId connectionId,
	SessionId sessionId,
	CategoryId categoryId,
	IIdentifier newParent
)

Parameters

connectionId
Type: ContentStudioConnectionId
A value that identifies the web site
sessionId
Type: ContentStudio.SecuritySessionId
A value that identifies the user's session. This value usually originates from a call to OpenSession(ConnectionId).
categoryId
Type: ContentStudio.DocumentCategoryId
An object that represents the category to relocate
newParent
Type: ContentStudio.DocumentIIdentifier
An object that represents the new location. This parameter must be either a CategoryId or a UnitId
Exceptions
ExceptionCondition
CSInvalidSessionException
CSPermissionDeniedException
CSException
NumberDescription
1104Container not found. The newParent does not exist
1505The categoryId does not exist
1512The name is already in use, choose another name.
1811The category or unit is protected.
1832Cannot move. The destination is a child of the source.
SqlException
Win32ExceptionAn unexpected error occured when relocating in the underlying filesystem.
DirectoryNotFoundExceptionThe underlying file system is corrupt. Rebuild the filesystem.
UnauthorizedAccessExceptionCSServer was denied access to the underlying filesystem.
ArgumentExceptionnewParent is neither a CategoryId nor a UnitId.
PlatformNotSupportedExceptionThis operation requires at least Windows Vista / Server 2008 on the web server.
Content Studio permissions
WRITE CONTAINER permission on the affected category - and - DELETE CONTAINER on the old parent category/unit - and - CREATE CONTAINER on the new parent category/unit.
Remarks
This method requires Content studio version 5.5 and a server operating system that supports Transactional NTFS i.e. Windows Vista / Server 2008 or later.
See Also

Reference

CategoryManager Class
ContentStudio.Document Namespace