語言

ReportingService2010.GetProperties(String, Property[]) 方法

定義

回傳報告伺服器資料庫或 SharePoint 文件庫 中一個或多個項目屬性的值。 此方法適用於所有物品類型。

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

參數

ItemPath
String

項目的完整限定網址,包括檔名和副檔名,或項目的 ID。

Properties
Property[]

一個包含你想要取得數值屬性的物件陣列 Property 。

傳回

一組 Property 物件陣列,代表指定項目的屬性。

屬性

範例

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  

備註

下表顯示此操作的標頭與權限資訊。

SOAP 標頭的使用 (在) ItemNamespaceHeaderValue

(在) TrustedUserHeaderValue

(出局) ServerInfoHeaderValue
原生模式所需權限 這取決於物品類型:

- Folder: ReadProperties
- Report: ReadProperties
- Resource: ReadProperties
- DataSource: ReadProperties
- Model: ReadProperties
SharePoint 模式 必要權限 <xref:Microsoft.SharePoint.SPBasePermissions.ViewListItems>

適用於