ReportingService2005.GetProperties(String, Property[]) Methode
Definition
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.
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.