ReportingService2010.GetProperties(String, Property[]) ReportingService2010.GetProperties(String, Property[]) ReportingService2010.GetProperties(String, Property[]) ReportingService2010.GetProperties(String, Property[]) Method

Definition

Returns the value of one or more properties of an item in a report server database or SharePoint library. This method applies to all item types.

public:
 cli::array <ReportService2010::Property ^> ^ GetProperties(System::String ^ ItemPath, cli::array <ReportService2010::Property ^> ^ Properties);
[System.Web.Services.Protocols.SoapDocumentMethod("http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer/GetProperties", ParameterStyle=System.Web.Services.Protocols.SoapParameterStyle.Wrapped, RequestNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", ResponseNamespace="http://schemas.microsoft.com/sqlserver/reporting/2010/03/01/ReportServer", Use=System.Web.Services.Description.SoapBindingUse.Literal)]
[System.Web.Services.Protocols.SoapHeader("ItemNamespaceHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("TrustedUserHeaderValue")]
[System.Web.Services.Protocols.SoapHeader("ServerInfoHeaderValue", Direction=System.Web.Services.Protocols.SoapHeaderDirection.Out)]
public ReportService2010.Property[] GetProperties (string ItemPath, ReportService2010.Property[] Properties);
member this.GetProperties : string * ReportService2010.Property[] -> ReportService2010.Property[]
Public Function GetProperties (ItemPath As String, Properties As Property()) As Property()

Parameters

ItemPath
String String String String

The fully qualified URL of the item including the file name and extension, or the ID of the item.

Properties
Property[]

An array of Property objects that contains the properties for which you want to retrieve values.

Returns

An array of Property objects that represent the properties of the specified item.

Examples

using System;  
using System.Collections.Generic;  
using System.IO;  
using System.Text;  
using System.Web;  
using System.Web.Services;  
using System.Web.Services.Protocols;  
  
class Sample  
{  
    static void Main(string[] args)  
    {  
        ReportingService2010 rs = new ReportingService2010();  
        rs.Url = "http://<Server Name>" +  
            "/_vti_bin/ReportServer/ReportService2010.asmx";  
        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("http://<Server Name>/Docs" +  
                    "/Documents/AdventureWorks Sample Reports" +  
                    "/Sales Order Detail.rdl", 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());  
        }  
    }  
}  
Imports System  
Imports System.IO  
Imports System.Text  
Imports System.Web.Services  
Imports System.Web.Services.Protocols  
  
Class Sample  
  
    Public Shared Sub Main()  
  
        Dim rs As New ReportingService2010()  
        rs.Url = "http://<Server Name>" + _  
            "/_vti_bin/ReportServer/ReportService2010.asmx"  
        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("http://<Server Name>/Docs" + _  
                    "/Documents/AdventureWorks Sample Reports" + _  
                    "/Sales Order Detail.rdl", 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  
  
End Class  

Remarks

The table below shows header and permissions information on this operation.

SOAP Header Usage (In) ItemNamespaceHeaderValue

(In) TrustedUserHeaderValue

(Out) ServerInfoHeaderValue
Native Mode Required Permissions Depends on the item type:

- Folder: ReadProperties
- Report: ReadProperties
- Resource: ReadProperties
- DataSource: ReadProperties
- Model: ReadProperties
SharePoint Mode Required Permissions ViewListItems

Applies to