ReportingService2005.GetProperties(String, Property[]) Methode

Definition

Gibt den Wert einer oder mehrerer Eigenschaften eines Elements in der Berichtsserver-Datenbank zurück.

public:
 cli::array <ReportService2005::Property ^> ^ GetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);
public ReportService2005.Property[] GetProperties (string Item, ReportService2005.Property[] Properties);
member this.GetProperties : string * ReportService2005.Property[] -> ReportService2005.Property[]
Public Function GetProperties (Item As String, Properties As Property()) As Property()

Parameter

Item
String

Der vollständige Name oder die ID des Elements.

Properties
Property[]

Ein Array von Property-Objekten, das die Eigenschaften enthält, für die Werte abgerufen werden sollen.

Gibt zurück

Ein Array von Property-Objekten, das die Eigenschaften des angegebenen Elements darstellt.

Beispiele

Um dieses 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 GetProperties -Methode verwendet, um die Beschreibung abzurufen, die dem Bericht "Company Sales" zugeordnet ist:

Imports System  
Imports System.Web.Services.Protocols  

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

      ' Create the property to retrieve.  
      Dim retrieveProp As New [Property]()  
      retrieveProp.Name = "Description"  
      Dim props(0) As [Property]  
      props(0) = retrieveProp  

      Try  
         Dim properties As [Property]() = rs.GetProperties("/SampleReports/Company Sales", props)  

         Dim prop As [Property]  
         For Each prop In  properties  
            ' Writes the description to the console.  
            Console.WriteLine(prop.Value)  
         Next prop  

      Catch e As SoapException  
         Console.WriteLine(e.Detail.InnerXml.ToString())  
      End Try  
   End Sub 'Main  
End Class 'Sample  
using System;  
using System.Web.Services.Protocols;  

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

      // Create the property to retrieve.  
      Property retrieveProp = new Property();  
      retrieveProp.Name = "Description";  
      Property[] props = new Property[1];  
      props[0] = retrieveProp;  

      try  
      {  
         Property[] properties = rs.GetProperties("/SampleReports/Company Sales", props);  

         foreach (Property prop in properties)  
         {  
            // Writes the description to the console.  
            Console.WriteLine(prop.Value);  
         }  
      }  

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

Hinweise

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

SOAP-Header (In) ItemNamespaceHeaderValue

(Out) ServerInfoHeaderValue
Erforderliche Berechtigungen Hängt vom Elementtyp ab:

- Folder: ReadProperties
- Report: ReadProperties
- Resource: ReadProperties
- DataSource: ReadProperties
- Model: ReadProperties

Der Standardwert, der für dieses Argument übergeben werden muss, ist der vollständige Pfadname. Um eine ID anzugeben, müssen Sie den ItemNamespaceHeader SOAP-Header festlegen. Weitere Informationen finden Sie unter Festlegen des Elementnamespace für die GetProperties-Methode.

Verwenden Sie die GetProperties -Methode, um den vollständigen Satz von benutzerdefinierten und reservierten Eigenschaften abzurufen. Verwenden Sie die -Methode, um die ListChildren Standardteilmenge reservierter Eigenschaften abzurufen. Eine Liste der reservierten Eigenschaften von Elementen in der Berichtsserver-Datenbank finden Sie unter Berichtsserverelementeigenschaften.

Wenn der Properties Parameter (Nothing in Visual Basic) lautet null , werden alle Eigenschaften für das angegebene Element zurückgegeben. Dazu gehören alle benutzerdefinierten und integrierten Eigenschaften, die für das Element spezifisch sind.

Sie können den vollständigen Pfadnamen des Elements für den Item Parameter übergeben, oder Sie können die ID des Elements übergeben. Weitere Informationen zur Verwendung von SOAP-Headern finden Sie unter Verwenden von Reporting Services SOAP-Headern.

Gilt für: