語言

ReportingService2006.SetProperties(String, Property[]) 方法

定義

命名空間:
ReportService2006
組件:
ReportService2006.dll

設定指定項目的一個或多個屬性。

public:
 void SetProperties(System::String ^ Item, cli::array <ReportService2006::Property ^> ^ Properties);
public void SetProperties(string Item, ReportService2006.Property[] Properties);
member this.SetProperties : string * ReportService2006.Property[] -> unit
Public Sub SetProperties (Item As String, Properties As Property())

參數

Item
String

項目的完整限定網址，包括檔名與副檔名。

Properties
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)  
    {  
        ReportingService2006 rs = new ReportingService2006();  
        rs.Url = "http://<Server Name>/_vti_bin/ReportServer/" +  
            "ReportService2006.asmx";  
        rs.Credentials =   
            System.Net.CredentialCache.DefaultCredentials;  

        Property[] props = new Property[1];  
        Property setProp = new Property();  
        setProp.Name = "Description";  
        setProp.Value = "Sales by quarter and product category.";  
        props[0] = setProp;  

        string itemPath = "http://<Server Name>/Docs/Documents/" +  
            "AdventureWorks Sample Reports/Sales Order Detail.rdl";  

        try  
        {  
            rs.SetProperties(itemPath, props);  
            Console.WriteLine("New description set on item {0}.",   
                itemPath);  
        }  
        catch (SoapException ex)  
        {  
            Console.WriteLine(ex.Detail.OuterXml);  
        }  
    }  
}  

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 ReportingService2006()  
        rs.Url = "http://<Server Name>/_vti_bin/ReportServer/" + _  
            "ReportService2006.asmx"  
        rs.Credentials = _  
            System.Net.CredentialCache.DefaultCredentials  

        Dim props(0) As [Property]  
        Dim setProp As New [Property]()  
        setProp.Name = "Description"  
        setProp.Value = "Sales by quarter and product category."  
        props(0) = setProp  

        Dim itemPath As String = "http://<Server Name>/Docs/" + _  
            "Documents/AdventureWorks Sample Reports/" + _  
            "Sales Order Detail.rdl"  

        Try  
            rs.SetProperties(itemPath, props)  
            Console.WriteLine("New description set on item {0}.", _  
                itemPath)  

        Catch ex As SoapException  
            Console.WriteLine(ex.Detail.OuterXml)  
        End Try  

    End Sub  

End Class

備註

下表顯示此操作的標頭與權限資訊。
SOAP 標頭 （在） TrustedUserHeaderValue

（出局） ServerInfoHeaderValue
必要權限 <xref:Microsoft.SharePoint.SPBasePermissions.EditListItems>

你可以透過傳遞 Property 物件作為方法參數來建立新的使用者自訂屬性。 要移除某個屬性，請將該屬性設為空值。 你無法移除保留房產。 關於保留項目屬性的清單，請參見 「報告伺服器項目屬性」。

如果呼叫該方法時 SetProperties 不存在指定的屬性，該屬性會被建立並設定為你提供的值。 如果該財產已經存在，其價值會被覆蓋。 為不存在的屬性設定空值不會影響該項目或其屬性。

若發生錯誤，則不會設定任何屬性。

當 Item=“/” 時回傳 rsOperationNotSupportedSharePointMode 錯誤。

適用於