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 einen angegebenen Eintrag aus der Berichtsdatenbank.
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 vollständig qualifizierte URL des Artikels. Das zu löschende Element kann eine EditSessionID sein.
Hinweise
Die untenstehende Tabelle zeigt Header- und Berechtigungsinformationen zu dieser Operation.
| SOAP-Überschriften | (In) BatchHeaderValue (Aus) ServerInfoHeaderValue |
| Erforderliche Berechtigungen | Das hängt vom Gegenstandstyp ab. - Folder: Delete- Report, LinkedReport: Delete- Resource: Delete- DataSource: Delete- Model: DeleteWenn der Gegenstand Kinderobjekte enthält, musst du auch die entsprechende Delete Erlaubnis für jedes Kindstück haben. |
Die Länge des Parameters Item darf 260 Zeichen nicht überschreiten; andernfalls wird eine SOAP-Ausnahme mit dem Fehlercode rsItemLengthExceeds ausgelöst.
Der Parameter Item kann weder null noch leer sein oder die folgenden reservierten Zeichen enthalten: : ? ; @ & = + $ , \ * > < | . ". Du kannst das Forward-Schrägstrichzeichen (/) verwenden, um Elemente im vollständigen Pfadnamen des Ordners zu trennen, aber am Ende des Ordnernamens kannst du es nicht verwenden.
Die Methode DeleteItem löscht nicht nur das angegebene Element aus der Berichtsdatenbank, sondern löscht auch zusätzliche Elemente wie die Abonnements, Zeitpläne und Snapshots, die mit dem Element verbunden sind.
Wenn My Reports aktiviert ist, wird eine SOAP-Ausnahme mit dem Fehlercode rsCannotDeleteReservedFolder ausgelöst, wenn du versuchst, den Ordner /My Reports oder /Users zu löschen. Man kann die Eigenschaften eines beliebigen Gegenstands mit dieser Methode GetProperties überprüfen. Wenn das Element eine Reserved-Eigenschaft hat, die auf einen Wert von gesetzt trueist, kann das Element nicht gelöscht werden.
Das Löschen eines Elements in der Report Server-Datenbank ändert die ModifiedByEigenschaften ModifiedDate des Elternelements.