Sprache

ReportingService2005.GetProperties(String, Property[]) Methode

Definition

Gibt den Wert einer oder mehrerer Eigenschaften eines Elements in der Berichtsdatenbank 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 Pfadname oder die ID des Gegenstands.

Properties
Property[]

Ein Array von Property Objekten, das die Eigenschaften enthält, für die Sie Werte abrufen möchten.

Gibt zurück

Ein Array von Property Objekten, das die Eigenschaften des angegebenen Objekts repräsentiert.

Beispiele

Um dieses Codebeispiel zu kompilieren, müssen Sie auf die Reporting Services WSDL zurückgreifen und bestimmte Namensräume importieren. Weitere Informationen finden Sie unter Beispiele für Kompilierung und Ausführung von Coden. Das folgende Codebeispiel verwendet die Methode GetProperties , um die mit dem Unternehmensumsatzbericht verbundene Beschreibung abzurufen:

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

Die untenstehende Tabelle zeigt Header- und Berechtigungsinformationen zu dieser Operation.

SOAP-Überschriften (In) ItemNamespaceHeaderValue

(Aus) ServerInfoHeaderValue
Erforderliche Berechtigungen Hängt vom Gegenstandstyp ab:

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

Der Standardwert, der für dieses Argument weitergegeben werden muss, ist der vollständige Pfadname. Um eine ID bereitzustellen, musst du den ItemNamespaceHeader SOAP-Header einstellen. Weitere Informationen finden Sie unter Einstellung des Item-Namensraums für die GetProperties-Methode.

Verwenden Sie die Methode GetProperties , um die vollständige Menge benutzerdefinierter und reservierter Eigenschaften abzurufen. Um die Standard-Teilmenge der reservierten Eigenschaften abzurufen, verwenden Sie die Methode ListChildren . Für eine Liste der reservierten Eigenschaften von Elementen in der Report Server-Datenbank siehe Report Server Item Properties.

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

Du kannst den vollständigen Pfadnamen des Gegenstands für den Item Parameter weitergeben oder die ID des Gegenstands weitergeben. Weitere Informationen zur Verwendung von SOAP-Headern finden Sie unter Using Reporting Services SOAP Headers.

Gilt für: