ReportingService2005.DeleteItem(String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Löscht ein angegebenes Element aus der Berichtsserver-Datenbank.
public:
void DeleteItem(System::String ^ Item);
public void DeleteItem (string Item);
member this.DeleteItem : string -> unit
Public Sub DeleteItem (Item As String)
Parameter
- Item
- String
Die vollqualifizierte URL des Elements. Das Element, das gelöscht werden soll, kann eine EditSessionID sein.
Hinweise
In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.
SOAP-Header | (In) BatchHeaderValue (Out) ServerInfoHeaderValue |
Erforderliche Berechtigungen | Hängt vom Elementtyp ab. - Folder : Delete- Report , LinkedReport : Delete- Resource : Delete- DataSource : Delete- Model : DeleteWenn das Element untergeordnete Elemente enthält, müssen Sie auch über die entsprechende Delete Berechtigung für jedes untergeordnete Element verfügen. |
Die Länge des Item
Parameters darf 260 Zeichen nicht überschreiten. Andernfalls wird eine SOAP-Ausnahme mit dem Fehlercode rsItemLengthExceeded ausgelöst.
Der Item
Parameter darf nicht NULL oder leer sein oder die folgenden reservierten Zeichen enthalten: : ? ; @ & = + $ , \ * > < | . "
. Sie können den Schrägstrich (/) verwenden, um Elemente im vollständigen Pfadnamen des Ordners zu trennen, aber sie können es nicht am Ende des Ordnernamens verwenden.
Die DeleteItem -Methode löscht nicht nur das angegebene Element aus der Berichtsserver-Datenbank, sie löscht auch zusätzliche Elemente, z. B. die Abonnements, Zeitpläne und Momentaufnahmen, die dem Element zugeordnet sind.
Wenn Meine Berichte aktiviert ist, wird eine SOAP-Ausnahme mit dem Fehlercode rsCannotDeleteReservedFolder
ausgelöst, wenn Sie versuchen, den Ordner "Meine Berichte" oder "/Benutzerordner" zu löschen. Sie können die Eigenschaften eines beliebigen Elements mit der GetProperties -Methode überprüfen. Wenn für das Element die Reservierte Eigenschaft auf den Wert festgelegt true
ist, kann das Element nicht gelöscht werden.
Durch das Löschen eines Elements in der Berichtsserverdatenbank werden die ModifiedByEigenschaften und ModifiedDate des übergeordneten Elements geändert.