ReportingService2005.MoveItem(String, String) Method

Definition

Namespace:

ReportService2005

Assembly:

ReportService2005.dll

Moves or renames an item.

public:
 void MoveItem(System::String ^ Item, System::String ^ Target);

public void MoveItem (string Item, string Target);

member this.MoveItem : string * string -> unit

Public Sub MoveItem (Item As String, Target As String)

Parameters

Item

String

The full path name of the item.

Target

String

The new full path name of the item.

Examples

To compile the following code example, you must reference the Reporting Services WSDL and import certain namespaces. For more information, see Compiling and Running Code Examples. The following example code moves the Employee Sales Summary report from the Samples folder to the root folder.

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials  

      Dim currentPath As String = "/SampleReports/Employee Sales Summary"  
      Dim targetPath As String = "/Employee Sales Summary"  

      Try  
         rs.MoveItem(currentPath, targetPath)  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.OuterXml)  
      End Try  
   End Sub 'Main  
End Class 'Sample  

using System;  
using System.Web.Services.Protocols;  

class Sample  
{  
   public static void Main()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      rs.Credentials = System.Net.CredentialCache.DefaultCredentials;  

      string currentPath = "/SampleReports/Employee Sales Summary";  
      string targetPath = "/Employee Sales Summary";  

      try  
      {  
         rs.MoveItem(currentPath, targetPath);  
      }  

      catch (SoapException e)  
      {  
         Console.WriteLine(e.Detail.OuterXml);  
      }  
   }  
}  

Remarks

The table below shows header and permissions information on this operation.

SOAP Headers	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
Required Permissions	Depends on the item type: - Folder: UpdateProperties on Item AND CreateFolder on Target - Report: UpdateProperties on Item AND CreateReport on Target - Resource: UpdateProperties on Item AND CreateResource on Target - DataSource: UpdateProperties on Item AND CreateDatasource on Target - Model: UpdateProperties on Item AND CreateModel on Target

If an item inherits security policies from its parent, moving the item causes it to inherit the security policies of the target folder. If an item does not inherit security policies from its parent, moving the item does not cause its security policies to change.

When My Reports is enabled, you cannot move the /My Reports or /Users folders. An attempt to do so produces a SOAP exception with the error code rsInvalidMove.

Moving or renaming items in the report server database modifies the ModifiedBy and ModifiedDate properties of the item and the source and target folders of the item.