ReportingService2010.GetProperties(String, Property[]) Method

Reference

Definition

Namespace:: ReportService2010

Assembly:: ReportService2010.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

[<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)>]
member this.GetProperties : string * ReportService2010.Property[] -> ReportService2010.Property[]

Public Function GetProperties (ItemPath As String, Properties As Property()) As Property()

Parameters

ItemPath: 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

Property[]

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

Attributes: SoapDocumentMethodAttribute SoapHeaderAttribute

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	<xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

Applies to

Share via