ReportingService2005.ListChildren(String, Boolean) Methode

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

public ReportService2005.CatalogItem[] ListChildren (string Item, bool Recursive);

member this.ListChildren : string * bool -> ReportService2005.CatalogItem[]

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

Parameter

Gibt zurück

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

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 Stammverzeichnisses der Berichtsserver-Verzeichnisstruktur 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 ReportingService2005()  
      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()  
   {  
      ReportingService2005 rs = new ReportingService2005();  
      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.

Die ListChildren -Methode gibt nur untergeordnete Elemente zurück, für die der Benutzer über die Berechtigung zum Anzeigen verfügt. Die zurückgegebenen Elemente stellen möglicherweise keine vollständige Liste der untergeordneten Elemente des angegebenen übergeordneten Elements dar.

Wenn die ListChildren -Methode im Stammverzeichnis der Berichtsserver-Datenbank mit aktivierten "Meine Berichte" aufgerufen wird, gibt die Methode ein Array von CatalogItem Objekten zurück, das Eigenschaften für den Ordner Meine Berichte enthält. Wenn der Benutzer anonym ist und Meine Berichte aktiviert ist, werden die Eigenschaften für Meine Berichte nicht zurückgegeben, wenn ListChildren im Stamm aufgerufen wird.

Die ListChildren -Methode kann die VirtualPath -Eigenschaft von Elementen in der Berichtsserverdatenbank 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 mit dem Wert "/Meine Berichte". Der tatsächliche Pfad des Elements ist /Users/Username/My Reports.

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

Gilt für: