ReportingService2005.DeleteItem(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Deletes a specified item from the report server database.
public:
void DeleteItem(System::String ^ Item);public void DeleteItem (string Item);member this.DeleteItem : string -> unitPublic Sub DeleteItem (Item As String)Parameters
- Item
- String
The fully qualified URL of the item. The item to delete can be an EditSessionID.
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: Delete- Report, LinkedReport: Delete- Resource: Delete- DataSource: Delete- Model: DeleteIf the item contains any child items, you must also have the respective Delete permission for each child item. |
The length of the Item parameter cannot exceed 260 characters; otherwise, a SOAP exception is thrown with the error code rsItemLengthExceeded.
The Item parameter cannot be null or empty or contain the following reserved characters: : ? ; @ & = + $ , \ * > < | . ". You can use the forward slash character (/) to separate items in the full path name of the folder, but you cannot use it at the end of the folder name.
The DeleteItem method not only deletes the specified item from the report server database, it also deletes additional items, such as the subscriptions, schedules, and snapshots that are associated with the item.
If My Reports is enabled, a SOAP exception is thrown with the error code rsCannotDeleteReservedFolder if you attempt to delete the /My Reports or /Users Folders folder. You can check the properties of any item by using the GetProperties method. If the item has a Reserved property set to a value of true, the item cannot be deleted.
Deleting an item in the report server database modifies the ModifiedByand ModifiedDate properties of the parent item.