Udostępnij za pośrednictwem

  • Artykuł

Metoda ReportingService2005.ListChildren

Pobiera listę elementów podrzędnych określonego folderu.

Przestrzeń nazw:  ReportService2005
Zestaw:  ReportService2005 (w ReportService2005.dll)

Składnia

'Deklaracja
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ListChildren", RequestNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    ResponseNamespace := "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices",  _
    Use := SoapBindingUse.Literal, ParameterStyle := SoapParameterStyle.Wrapped)> _
<SoapHeaderAttribute("ServerInfoHeaderValue", Direction := SoapHeaderDirection.Out)> _
Public Function ListChildren ( _
    Item As String, _
    Recursive As Boolean _
) As CatalogItem()
'Użycie
Dim instance As ReportingService2005
Dim Item As String
Dim Recursive As Boolean
Dim returnValue As CatalogItem()

returnValue = instance.ListChildren(Item, _
    Recursive)

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

[SoapDocumentMethodAttribute(L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ListChildren", RequestNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = L"https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse::Literal, ParameterStyle = SoapParameterStyle::Wrapped)]
[SoapHeaderAttribute(L"ServerInfoHeaderValue", Direction = SoapHeaderDirection::Out)]
public:
array<CatalogItem^>^ ListChildren(
    String^ Item, 
    bool Recursive
)

[<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices/ListChildren", RequestNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    ResponseNamespace = "https://schemas.microsoft.com/sqlserver/2005/06/30/reporting/reportingservices", 
    Use = SoapBindingUse.Literal, ParameterStyle = SoapParameterStyle.Wrapped)>]
[<SoapHeaderAttribute("ServerInfoHeaderValue", Direction = SoapHeaderDirection.Out)>]
member ListChildren : 
        Item:string * 
        Recursive:bool -> CatalogItem[] 

public function ListChildren(
    Item : String, 
    Recursive : boolean
) : CatalogItem[]

Parametry

  • Item
    Typ: System.String
    Pełną nazwę ścieżka folderu nadrzędnego.
  • Recursive
    Typ: System.Boolean
    A wartość logiczna wyrażenie, która wskazuje, czy zwrócić całe drzewo podrzędność elementy poniżej określonego element.Wartością domyślną jest false.

Wartość zwracana

Typ: array<ReportService2005.CatalogItem[]
Tablica CatalogItem obiektów.Jeśli dzieci nie istnieje, Metoda ta zwraca pusty CatalogItem obiektu.

Uwagi

W poniższej tabela przedstawiono informacje nagłówka i uprawnienia na tej operacji.

Nagłówki SOAP

(Ruch wychodzący)ServerInfoHeaderValue

Wymagane uprawnienia

ReadProperties na Item

ListChildren Metoda zwraca tylko podrzędność elementy czy użytkownik ma uprawnienia do widoku.Elementy, które są zwracane nie może reprezentować pełną listę elementów podrzędność element nadrzędnego określonego.

Jeśli ListChildren w katalogu głównym wywoływana jest metoda baza danych serwera raportów z włączonym Moje raporty, metoda zwraca tablicę CatalogItem obiektów zawierających właściwości folderu Raporty.Jeśli użytkownik jest anonimowy Moje raporty jest włączony, właściwości Moje raporty nie są zwracane po ListChildren jest wywoływana w katalogu głównym.

ListChildren Metoda może zwracać VirtualPath właściwość elementów w baza danych serwera raportów , obsługuje ścieżki wirtualnej.Ścieżka wirtualna jest ścieżką, pod którym użytkownik spodziewa się element.Na przykład raport o nazwie "report1" folder znajduje się w osobistym Moje raporty użytkownika ma ścieżka wirtualnej równą "raportów /My".Rzeczywiste ścieżka element jest /Users/Username/Moje raporty.

Większość właściwości metoda zwraca tylko do odczytu.Aby uzyskać więcej informacji na temat właściwości element w usługach Reporting Services, zobacz Właściwości elementu raportu serwera.

Przykłady

Aby skompilować poniższy przykład kodu, musi odniesienie WSDL usług raportowania i przywozu niektórych obszarów nazw.Aby uzyskać więcej informacji, zobacz temat Compiling and Running Code Examples.Następujący kod w przykładzie wykorzystano ListChildren metoda odczytać zawartość katalogu głównego serwer raportów drzewa katalogów, a następnie zapisuje pierwszy element i jego właściwości jako dokument XML:

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);
      }
   }
}