ReportingService2010.ListChildren(String, Boolean) Methode

Referenz

Definition

Namespace:: ReportService2010

Assembly:: ReportService2010.dll

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.

Ruft eine Liste der untergeordneten Elemente eines angegebenen Ordners ab

public:
 cli::array <ReportService2010::CatalogItem ^> ^ ListChildren(System::String ^ ItemPath, bool Recursive);

[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/ListChildren", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
public ReportService2010.CatalogItem[] ListChildren (string ItemPath, bool Recursive);

[<System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/ListChildren", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)>]
[<System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)>]
[<System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")>]
member this.ListChildren : string * bool -> ReportService2010.CatalogItem[]

Public Function ListChildren (ItemPath As String, Recursive As Boolean) As CatalogItem()

Parameter

ItemPath: String

Der vollständige Pfadname des übergeordneten Ordners.

Recursive: Boolean

Ein Boolean-Ausdruck, der angibt, ob die gesamte Struktur der untergeordneten Elemente unter dem angegebenen Element zurückgegeben werden soll. Standardwert: false.

Hinweis Wenn Sie diesen Parameter auf true im SharePoint-Modus festlegen, kann die Leistung Ihrer Anwendung erheblich verringert werden.

Gibt zurück

CatalogItem[]

Ein Array von CatalogItem-Objekten. Wenn keine untergeordneten Elemente vorhanden sind, gibt diese Methode ein leeres Array zurück.

Attribute: SoapDocumentMethodAttribute SoapHeaderAttribute

Beispiele

Um das folgende Codebeispiel zu kompilieren, müssen Sie auf die Reporting Services WSDL verweisen und bestimmte Namespaces importieren. Weitere Informationen finden Sie unter Kompilieren und Ausführen von Codebeispielen. Im folgenden Codebeispiel wird die ListChildren -Methode verwendet, um den Inhalt des Stammes der Verzeichnisstruktur des Berichtsservers zu lesen und dann das erste Element und seine Eigenschaften als XML-Dokument zu speichern:

Imports System  
Imports System.IO  
Imports System.Text  
Imports System.Web.Services.Protocols  
Imports System.Xml  
Imports System.Xml.Serialization  

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

      Dim items As CatalogItem() = Nothing  

      ' Retrieve a list of all items from the report server database.   
      Try  
         items = rs.ListChildren("/", True)  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
      End Try  

      ' Serialize the contents as an XML document and write the contents to a file.  
      Try  
         Dim fs As New FileStream("CatalogItems.xml", FileMode.Create)  
         Dim writer As New XmlTextWriter(fs, Encoding.Unicode)  

         Dim serializer As New XmlSerializer(GetType(CatalogItem()))  
         serializer.Serialize(writer, items)  

         Console.WriteLine("Server contents successfully written to a file.")  

      Catch e As Exception  
         Console.WriteLine(e.Message)  
      End Try  
   End Sub 'Main  
End Class 'Sample

using System;  
using System.IO;  
using System.Text;  
using System.Web.Services.Protocols;  
using System.Xml;  
using System.Xml.Serialization;  

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

      CatalogItem[] items = null;  

      // Retrieve a list of all items from the report server database.   
      try  
      {  
         items = rs.ListChildren("/", true);  
      }  

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

      // Serialize the contents as an XML document and write the contents to a file.  
      try  
      {  
         FileStream fs = new FileStream("CatalogItems.xml", FileMode.Create);  
         XmlTextWriter writer = new XmlTextWriter(fs, Encoding.Unicode);   

         XmlSerializer serializer = new XmlSerializer(typeof(CatalogItem[]));  
         serializer.Serialize(writer, items);  

         Console.WriteLine("Server contents successfully written to a file.");  
      }  

      catch (Exception e)  
      {  
         Console.WriteLine(e.Message);  
      }  
   }  
}

Hinweise

In der folgenden Tabelle werden Header- und Berechtigungsinformationen zu diesem Vorgang dargestellt.


SOAP-Headerverwendung	(In) TrustedUserHeaderValue (Out) ServerInfoHeaderValue
Erforderliche Berechtigungen im einheitlichen Modus	ReadProperties für `Item`
Erforderliche Berechtigungen im SharePoint-Modus	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Diese Methode gibt nur untergeordnete Elemente zurück, die der Benutzer anzeigen darf. Die zurückgegebenen Elemente stellen möglicherweise keine vollständige Liste der untergeordneten Elemente des angegebenen übergeordneten Elements dar.

Wenn diese Methode im Stammverzeichnis der Berichtsserverdatenbank aufgerufen wird, wenn Meine Berichte aktiviert sind, gibt die Methode ein Array von CatalogItem Objekten zurück, die Eigenschaften für den Ordner Meine Berichte enthalten. Wenn der Benutzer anonym ist und Meine Berichte aktiviert ist, werden die Eigenschaften für Meine Berichte nicht zurückgegeben, wenn diese Methode im Stamm aufgerufen wird.

Diese Methode kann die VirtualPath Eigenschaft von Elementen in der Berichtsserver-Datenbank zurückgeben, die virtuelle Pfade unterstützen. Der virtuelle Pfad ist der Pfad, unter dem ein Benutzer erwartet, dass das Element angezeigt wird. Beispielsweise verfügt ein Bericht namens "Report1" im persönlichen Ordner "Meine Berichte" des Benutzers über einen virtuellen Pfad, der "/Meine Berichte" entspricht. Der tatsächliche Pfad des Elements ist "/Benutzer/Benutzername/Meine Berichte".

Die meisten Eigenschaften, die diese Methode zurückgibt, sind schreibgeschützt. Weitere Informationen zu Elementeigenschaften in Reporting Services finden Sie unter Eigenschaften von Berichtsserverelementen.

Gilt für:

Freigeben über