ReportingService2005.SetSystemProperties(Property[]) 方法

定义

命名空间:

ReportService2005

程序集:

ReportService2005.dll

设置一个或多个系统属性。

public:
 void SetSystemProperties(cli::array <ReportService2005::Property ^> ^ Properties);

public void SetSystemProperties (ReportService2005.Property[] Properties);

member this.SetSystemProperties : ReportService2005.Property[] -> unit

Public Sub SetSystemProperties (Properties As Property())

参数

Properties

Property[]

Property 对象的数组，它定义要为报表服务器设置的系统属性和属性值。

示例

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

SOAP 标头	(Out) ServerInfoHeaderValue
所需的权限	UpdateSystemProperties (系统)

若要编译以下代码示例，必须引用 Reporting Services WSDL 并导入某些命名空间。 有关详细信息，请参阅 编译和运行代码示例。 下面的代码示例在报表服务器数据库中创建名为 Description 的新系统属性：

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 setProp As New [Property]()  
      setProp.Name = "Description"  
      setProp.Value = "My report server that resides on the computer named RSSERVER1."  
      Dim props(0) As [Property]  
      props(0) = setProp  

      Try  
         rs.SetSystemProperties(props)  
         Console.WriteLine("New site property set.")  

      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 setProp = new Property();  
      setProp.Name = "Description";  
      setProp.Value = "My report server that resides on the computer named RSSERVER1.";  
      Property[] props = new Property[1];  
      props[0] = setProp;  

      try  
      {  
         rs.SetSystemProperties( props );  
         Console.WriteLine( "New site property set." );  
      }  

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

注解

用户可以添加系统未保留的其他自定义系统属性。 如果数组中指定的 Property 属性不存在，则创建该属性。 如果某个属性的值存在，则将其覆盖。 不能创建或删除保留的系统属性。 报表服务器的功能可能会更改，具体取决于要设置的系统属性。 有关保留的系统属性的列表，请参阅 报表服务器系统属性。 如果发生错误，则不设置任何属性。

可以通过将该属性设置为空值来删除属性的值。