ReportingService2005.DeleteItem Method

Deletes a specified item from the report server database.

Namespace:  ReportService2005
Assembly:  ReportService2005 (in ReportService2005.dll)

[SoapHeaderAttribute("BatchHeaderValue")]
[SoapDocumentMethodAttribute("http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/DeleteItem", RequestNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
	ResponseNamespace = "http://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
	Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)]
[SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)]
public void DeleteItem(
	string Item
)

Parameters

Item
Type: System.String
The fully qualified URL of the item. The item to delete can be an EditSessionID.

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

SOAP Headers

(In) BatchHeaderValue

(Out) ServerInfoHeaderValue

Required Permissions

Depends on the item type.

If 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.

Community Additions

ADD
Show: