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

定义

命名空间:

ReportService2005

程序集:

ReportService2005.dll

设置指定项的一个或多个属性。

public:
 void SetProperties(System::String ^ Item, cli::array <ReportService2005::Property ^> ^ Properties);

public void SetProperties (string Item, ReportService2005.Property[] Properties);

member this.SetProperties : string * ReportService2005.Property[] -> unit

Public Sub SetProperties (Item As String, Properties As Property())

参数

Item

String

项的完整路径名称。

Properties

Property[]

一个 Property 对象的数组，该数组定义要为项设置的属性和属性值。

示例

若要编译以下代码示例，必须引用 Reporting Services WSDL 并导入某些命名空间。 有关详细信息，请参阅 编译和运行代码示例。 下面的代码示例设置公司销售报表的新说明：

Imports System  
Imports System.Web.Services.Protocols  

Class Sample  
   Public Shared Sub Main()  
      Dim rs As New ReportingService2005()  
      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 = "/SampleReports/Company Sales"  

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

      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 = "/SampleReports/Company Sales";   

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

      catch (SoapException ex)  
      {  
         Console.WriteLine(ex.Detail.OuterXml);  
      }  
   }  
}  

注解

下表显示了有关此操作的标头和权限信息。

SOAP 标头	(In) BatchHeaderValue (Out) ServerInfoHeaderValue
所需的权限	取决于项类型： - Folder: UpdateProperties - Report: UpdateProperties - Resource: UpdateProperties - DataSource: UpdateProperties - Model: UpdateProperties

可以通过将 对象作为方法参数传递 Property 来为项创建新的用户定义属性。 若要从项中删除属性，请将 属性设置为空值。 不能删除保留的属性。 有关保留项属性的列表，请参阅 报表服务器项属性。

如果在调用 方法时 SetProperties 不存在指定的属性，则会创建该属性并将其设置为你提供的值。 如果该属性已存在，则其值将被覆盖。 为不存在的属性设置空值对项或其属性没有影响。

如果发生错误，则不设置任何属性。